Docker下dubbo开发,三部曲之二:本地环境搭建
docker下,本地搭建dubbo环境
在上一篇文章《Docker下dubbo开发,三部曲之一:极速体验》中,我们快速体验了dubbo服务的注册、发现、调用,今天我们一起在本地制作一套这样的环境,经过这次实战,大家就可以根据实际需求对自己的环境量身定制了。
基础架构
整个环境由四个容器组成,梳理后相互之间的关系如下图:
接下来我们按照下面的表格来设计和制作对应的镜像:
容器 | 作用 | 镜像 | 功能 | link连接 |
---|---|---|---|---|
zk_server | 注册中心 | zookeeper:3.3.6 | 官方镜像 | 无 |
dubbo_admin | 管理平台 | bolingcavalry/dubbo_admin_tomcat | 定制镜像,用tomcat官方镜像加dubbo_admin.war生成 | 用别名zkhost连接zk_server |
dubbo_provider | 服务提供者 | bolingcavalry/dubbo_provider_tomcat | 定制镜像,用tomcat官方镜像加dubboserviceprovider.war文件生成 | 用别名zkhost连接zk_server |
dubbo_consumer | 服务消费者 | bolingcavalry/online_deploy_tomcat | 定制镜像,是个支持在线部署的tomcat | 无 |
特别关注
dubbo_provider和dubbo_consumer是分别用来提供服务和消费服务的,其实是两个web应用被部署在不同的容器中,一般来说把web应用在docker的tomcat容器中运行起来有两种方式:
- 写Dockerfile文件做一个定制镜像,用tomcat官方镜像做基础镜像,在Dockerfile中将war包复制到tomcat的webapps目录下,dubbo_admin和dubbo_provider都是用这种方式;
- 运行一个支持在线部署的tomcat容器,然后在线部署war包,具体细节请看《实战docker,编写Dockerfile定制tomcat镜像,实现web应用在线部署》,dubbo_consumer用的就是这种方式;
很明显,第一种方式用起来更简单,在docker-compose.yml中把镜像指定了就行,而第二种方式略为麻烦,要自己动手去部署war包;
读者们可能会有疑问:既然第一种方式简单,为什么dubbo_consumer不用这种方式部署呢?其实我之前是用过的,只是在启动应用的时候会失败才改成了第二种,详细原因请看《Docker下部署dubbo,消费者应用无法使用link参数的问题》
下面我们开始本地搭建dubbo体验环境的过程,首先把所有步骤列出来,然后逐个实现:
- 镜像zk_server不用制作,pull即可;
- 制作镜像dubbo_admin;
- 制作镜像dubbo_provider;
- 镜像dubbo_consumer不用制作,pull即可;
- 制作docker-compose.yml文件;
- 启动所有容器;
- 下载、编译dubbo_consumer对应的源码,在线部署到dubbo_consumer容器;
- 开始体验;
开始啦:
镜像:zk_server
zk_server的作用是注册中心,其他几个容器都会用到,自身是个普通的zookeeper,这里我们用官方镜像,启动一个单机实例即可;
镜像:dubbo_admin
这是dubbbo的管理平台,是个web应用,部署在tomcat下,需要我们手工定制;
首先我们要准备war包,有两种方式得到war包:
- 我已经编译好了,在我的github下载,地址是:https://github.com/zq2599/docker_dubbo_all_in_one,里面有三个文件夹,dubbo_tomcat目录下的dubbo-admin.war文件就是我们需要的war包;
- 去dubbo的github仓库下载官方源码,然后自己动手编译,一共需要四步完成,如下:
2.1 执行git clone git@github.com:alibaba/dubbo.git,下载dubbo源码;
2.2 下载后,打开dubbo/dubbo-admin/src/main/webapp/WEB-INF/dubbo.properties这个文件,修改dubbo.registry.address这个参数的值,修改后dubbo.registry.address=zookeeper://zkhost:2181
2.3 进入dubbo-admin子目录,执行命令mvn clean package -U -Dmaven.test.skip=true
2.4 mvn执行完成后,在dubbo/dubbo-admin/target目录下找到dubbo-admin-2.5.4-SNAPSHOT.war文件,重命名为dubbo-admin.war;
得到war包后,我们开始制作Dockerfile文件,内容很简单,就是以tomcat官方镜像为基础,复制dubbo-admin.war文件到镜像中,另外为了让访问url更短,我们把tomcat镜像的server.xml替换掉,新的server.xml中把webapps/dubbo-admin目录配制成了url的根目录,这样只要输入localhost:8080就能访问dubbo-admin的目录了;
先看server.xml,内容如下:
<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.startup.VersionLoggerListener" />
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
</GlobalNamingResources>
<Service name="Catalina">
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
<Engine name="Catalina" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
</Realm>
<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context path="" docBase="/usr/local/tomcat/webapps/dubbo-admin" debug="0" reloadable="true" crossContext="true"/>
</Host>
</Engine>
</Service>
</Server>
Dockerfile内容如下:
# Docker image of dubbo-admin webapp tomcat
# VERSION 0.0.1
# Author: bolingcavalry
#基础镜像使用tomcat:7.0.77-jre8
FROM tomcat:7.0.77-jre8
#作者
MAINTAINER BolingCavalry <zq2599@gmail.com>
#定义工作目录
ENV TOMCAT_BASE /usr/local/tomcat
#复制配置文件
COPY ./server.xml $TOMCAT_BASE/conf/
#复制war包
COPY ./dubbo-admin.war $TOMCAT_BASE/webapps/
#给配置文件增加读权限
RUN chmod a+xr $TOMCAT_BASE/conf/server.xml
#删除默认的ROOT文件件
RUN rm -rf $TOMCAT_BASE/webapps/ROOT
把Dockerfile,server.xml,dubbo-admin.war三个文件放在同一个目录下,然后打开控制台进入这个目录,执行以下命令构建镜像:
docker build -t bolingcavalry/dubbo_admin_tomcat:0.0.1 .
执行完毕后构建dubbo_admin镜像成功,通过docker images命令可以看到;
#镜像:dubbo_provider
这个镜像是个tomcat容器,里面运行了一个war包,功能是提供服务并注册到dubbo注册中心,具体的代码我们会在下一章详细介绍;
下载地址是:https://github.com/zq2599/docker_dubbo_all_in_one,里面有三个文件夹,provider_tomcat目录下的dubboserviceprovider.war文件就是我们需要的war包;
和dubbo_admin一样,我们也配置了server.xml:
<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.startup.VersionLoggerListener" />
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
</GlobalNamingResources>
<Service name="Catalina">
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
<Engine name="Catalina" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
</Realm>
<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context path="" docBase="/usr/local/tomcat/webapps/dubboserviceprovider" debug="0" reloadable="true" crossContext="true"/>
</Host>
</Engine>
</Service>
</Server>
接下来是Dockerfile文件,内容也很简单,复制war,替换server.xml,删除原有的root目录:
# Docker image of dubbo-admin webapp tomcat
# VERSION 0.0.1
# Author: bolingcavalry
#基础镜像使用tomcat:7.0.77-jre8
FROM tomcat:7.0.77-jre8
#作者
MAINTAINER BolingCavalry <zq2599@gmail.com>
#定义工作目录
ENV TOMCAT_BASE /usr/local/tomcat
#复制配置文件
COPY ./server.xml $TOMCAT_BASE/conf/
#复制war包
COPY ./dubboserviceprovider.war $TOMCAT_BASE/webapps/
#给配置文件增加读权限
RUN chmod a+xr $TOMCAT_BASE/conf/server.xml
#删除默认的ROOT文件件
RUN rm -rf $TOMCAT_BASE/webapps/ROOT
把Dockerfile,server.xml,dubboserviceprovider.war三个文件放在同一个目录下,然后打开控制台进入这个目录,执行以下命令构建镜像:
docker build -t bolingcavalry/dubbo_provider_tomcat:0.0.1 .
执行完毕后构建dubbo_provider镜像成功,通过docker images命令可以看到;
#镜像:dubbo_consumer
dubbo_consumer也是web应用,前面已说过此应用的部署方式和dubbo_provider不同,是在线部署,所以镜像文件用bolingcavalry/online_deploy_tomcat:0.0.1,此镜像已发布到hub.docker.com,可以直接使用,它里面有个tomcat,支持提过maven插件在线部署,有关此镜像的详情请看《实战docker,编写Dockerfile定制tomcat镜像,实现web应用在线部署》,请记得修改maven的配置文件,否则在线部署的鉴权无法通过;
dubbo_consumer对应的war包需要下载对应的源码,然后编译部署,这个我们后面会讲到;
制作docker-compose.yml
docker-compose.yml内容如下:
version: '2'
services:
zk_server:
image: daocloud.io/library/zookeeper:3.3.6
restart: always
dubbo_admin:
image: bolingcavalry/dubbo_admin_tomcat:0.0.1
links:
- zk_server:zkhost
depends_on:
- "zk_server"
ports:
- "8080:8080"
restart: always
dubbo_provider:
image: bolingcavalry/dubbo_provider_tomcat:0.0.1
links:
- zk_server:zkhost
depends_on:
- "dubbo_admin"
environment:
TOMCAT_SERVER_ID: dubbo_provider_tomcat
restart: always
dubbo_consumer:
image: bolingcavalry/online_deploy_tomcat:0.0.1
ports:
- "8082:8080"
environment:
TOMCAT_SERVER_ID: dubbo_consumer_tomcat
restart: always
这里面使用了depends_on参数,是为了保证启动顺序;
#启动所有容器
执行命令:
docker-compose up -d
多个容器启动成功,如下图:
#dubbo_consumer对应的源码编译和在线部署
编译代码前,要先确定zookeeper的ip,前面执行docker-compose up -d的时候,控制台提示zookeeper容器的名称是16_zk_server_1,因此执行以下命令可看zookeeper容器ip:
docker exec -it 16_zk_server_1 ip a
如下图红框,ip是172.28.0.3
现在开始下载和编译源码了,dubbo消费者的webapp源码地址是:git@github.com:zq2599/blog_demos.git,里面有多个工程,本次实战用到的工程是dubbo_service_consumer,如下图红框所示:
代码下载后,在dubbo_service_consumer/src/main/resources目录下,打开spring-extends.xml文件,修改下图红框中的ip,改成zookeeper的ip:172.28.0.3:
执行命令mvn clean package -U -Dmaven.test.skip=true tomcat7:redeploy
mvn执行完成后,web应用已经部署到dubbo_consumer的tomcat上;
开始体验
现在本地环境搭建已经完成,可以开始体验了,体验步骤和《Docker下dubbo开发,三部曲之一:极速体验》中的体验环节一致,就不在此赘述了,简单来说分为以下两步:
- 在dubbo-admin的web页面上查看服务提供者、消费者的注册情况,地址是http://localhost:8080;
- 在dubbo_consumer的web页面上验证远程调用,地址是http://localhost:8082/dubboserviceconsumer/add
以上就是docker下dubbo本地搭建的整个过程,经过本章的实战,我们已经能够根据自己的需求订制dubbo环境了,下一章是dubbo学习的终章,我们一起实战编码,学会开发dubbo环境下的服务提供者和消费者;
欢迎关注我的公众号
更多推荐
所有评论(0)