开始使用Docker部署Apollo配置中心之前,首先需要机器安装Docker环境本文使用Vresion: 2.0.0.0-mac81 (29211)
测试部署,并使用以下镜像:
- mysql
- apollo-configservice
- apollo-adminsrevice
- apollo-portal
因为本文为纯部署目的,因此不在这里讲解Apollo的一些知识,如有需要可查看官方GitHub地址(https://github.com/ctripcorp/apollo)。
上面提到的镜像除了Mysql
以外其余三个都需要自行编译成Docker镜像,由于最初是打算部署到k8s中的,所以是按照K8s的部署文档来编译相应的镜像的。本文使用使用dockre-compose
部署dev、fat、uat、pro等环境,仅供测试时使用,详细生产环境部署可查看官方指导,这里先给出官方的分布式部署方案图。
关于如何编译apollo-configservice
、apollo-adminsrevice
、apollo-portal
这三个docker镜像可点击连接查看 K8s的部署文档 来编译Docker镜像。
Apollo使用的是Spring Cloud微服务架构,主要包括以下服务:
- 注册中心(与apollo-configservice运行在一起)
- 配置服务(apollo-configservice)
- 管理服务(apollo-adminservice)
- 管理门户(apollo-portal)
Apollo主要使用Mysql存储应用的配置以及自已的运行配置,Apollo使用以下数据库完成存储:
- ApolloPortalDB
- ApolloConfigDB
使用关系如下:
下面准备使用Dockere在dev
环境部署Apollo。
准备工作
从Github来拉取最新的Apollo代码:
git clone [email protected]:ctripcorp/apollo.git
检查启动Docker是否启动:
docker info
由于使用dockre-compose
部署,需要有一个dockre-compose
配置文件,这里假设有一个apollo-compose.yaml
配置文件,之后的部署都会更新这个文件。如果你的机器还未安装dockre-compose
可查看 docker-compose安装指导
配置Mysql服务
部署之前先将对应环境的Mysql服务启动起来,这里使用docker-compose
启动Mysql服务.
version: "3"
services:
mysql-dev:
image: mysql
# restart: always
environment:
- MYSQL_ROOT_PASSWORD=123456
expose:
- "3306"
volumes:
- /Users/yjwfn/bin/apollo/scripts/sql:/sql
上面的配置代码,将在dev
环境运行mysql服务,这里挂载了一个目录:/Users/yjwfn/bin/apollo/scripts/sql:/sql
,该目录里面存放Apollo的数据库文件,详细文件可查看 Apollo Sql文件。
使用以下命令启动dev
环境的mysql服务:
docker-compose -f apollo-compose.yaml up -d mysql-dev
apollo-compose.yaml
是你机上docker-compose
配置文件,mysql-dev
是mysql服务的名称。
启动完成后查看容器是否已经运行:
docker container ps
配置Apollo数据库
mysql服务启动完成之后,需要将apolloconfigdb.sql
与apolloportaldb.sql
这两个sql文件导入到数据库中,首先连接上docker中的mysql服务:
docker exec -it kube_mysql-dev_1 sh
kube_mysql-dev_1
是mysql服务的容器名称,连接上容器后登陆到mysql服务导入sql文件:
mysql -p123456
source /sql/apolloconfigdb.sql
srouce /sql/apolloportaldb.sql
如果是部署apollo-configservice
与apollo-apolloportaldb
的话只需要导入/sql/apolloconfigdb.sql
就行了,相应的部署apollo-portal
只需要导入/sql/apolloportaldb.sql
,方便演示这里就两个同时导入了。
导入完成后数据中现在应该有ApolloConfigDB
与ApolloPortalDB
两个数据库,首先需要对ApolloConfigDB
里面的ServerConfig
做一些修改,主要是对发服服务
的服务器地址做一点变更:
use ApolloConfigDB;
update ServerConfig set Value="http://apollo-configservice-dev:8080/eureka/" where `key`="eureka.service.url";
apollo-configservice-dev
是稍后我们需要发布的apollo-configservice
服务的名称。修改完成之后可运行查询语句是否修改成功:
select * from ServerConfig;
修改完成之前退出dockre容器的连接就行了, 接下来部署apollo-configservice
。
配置服务部署(apollo-configservice)
Apollo配置服务(apollo-configservice)
与注册中心(Eureka)
是运行在一起的,所以一般情况下是不需要再部署Eureka
了。现在部署apollo-configservice
服务,首先在apollo-compose.yaml
添加apollo-configservice
服务:
version: "3"
services:
... #省略其他服务
apollo-configservice-dev:
image: <镜像地址>
environment:
DATASOURCES_URL: jdbc:mysql://mysql-dev:3306/ApolloConfigDB?characterEncoding=utf8
DATASOURCES_USERNAME: root
DATASOURCES_PASSWORD: 123456
ENV: "dev"
expose:
- "8080"
depends_on:
- "mysql-dev"
注意apollo-configservice-dev
依赖了上面部署的mysql-dev
服务,并且注入了一些环境变量:
- DATASOURCES_URL (mysql-dev连接地址)
- DATASOURCES_USERNAME (mysql-dev连接用户)
- DATASOURCES_PASSWORD (mysql-dev的root密码)
- ENV (apollo-configservice)的运行环境
服务添加完成后执行以下命令启动apollo-configservice-dev
服务:
docker-compose -f apollo-compose.yaml up -d apollo-configservice-dev
执行启动命令后等待几秒,然后查看服务是否启动成功。可通过在容器中查看启动日志来判断服务是否启动成功:
docker exec -it kube_apollo-configservice-dev_1 sh
cat /opt/logs/apollo-config-server/apollo-configservice.log
kube_apollo-configservice-dev_1
是apollo-configservice-dev
的容器名称可通过docker container ps
查看,看到如下日志基本可以确定服务已经成功启动:
2018-12-27 21:45:51.889 INFO 40 --- [Thread-17] c.n.e.registry.AbstractInstanceRegistry : Registered instance APOLLO-CONFIGSERVICE/f2b6896763d0:apollo-configservice:8080 with status UP (replication=true)
2018-12-27 21:45:51.889 INFO 40 --- [Thread-17] c.n.e.r.PeerAwareInstanceRegistryImpl : Got 1 instances from neighboring DS node
2018-12-27 21:45:51.889 INFO 40 --- [Thread-17] c.n.e.r.PeerAwareInstanceRegistryImpl : Renew threshold is: 1
2018-12-27 21:45:51.889 INFO 40 --- [Thread-17] c.n.e.r.PeerAwareInstanceRegistryImpl : Changing status to UP
2018-12-27 21:45:51.894 INFO 40 --- [Thread-17] e.s.EurekaServerInitializerConfiguration : Started Eureka Server
管理服务部署(apollo-adminservice)
管理服务的配置基本上与配置服务
的配置基本相似,首先在apollo-compose
中添加apollo-adminservice-dev
服务:
version: "3"
services:
... #省略其他服务配置
apollo-adminservice-dev:
image: <镜像名称>
environment:
DATASOURCES_URL: "jdbc:mysql://mysql-dev:3306/ApolloConfigDB?characterEncoding=utf8"
DATASOURCES_USERNAME: root
DATASOURCES_PASSWORD: 123456
ENV: "dev"
expose:
- "8080"
depends_on:
- "mysql-dev" #管理服务依赖之前配置的mysql-dev服务
- "apollo-configservice-dev" #管理服务依赖配置服务
同apollo-configservice-dev
一样定义几个环境变量:
- DATASOURCES_URL (mysql-dev连接地址)
- DATASOURCES_USERNAME (mysql-dev连接用户)
- DATASOURCES_PASSWORD (mysql-dev的root密码)
- ENV (apollo-configservice)的运行环境
添加服务完成后开始启动apollo-adminservice-dev
服务:
docker-compose -f apollo-compose.yaml up -d apollo-adminservice-dev
然后使用docker container ps
查看容器名称,随后执行命令查看Log文件:
docker exec -it kube_apollo-adminservice-dev_1 sh
cat /opt/logs/apollo-admin-server/apollo-adminservice.log | tail -n 50
部分日志输出如下所示:
...
2018-12-27 21:56:45.722 INFO 40 --- [DiscoveryClient-InstanceInfoReplicator-0] com.netflix.discovery.DiscoveryClient : DiscoveryClient_APOLLO-ADMINSERVICE/8578c069d388:apollo-adminservice:8090: registering service...
2018-12-27 21:56:45.804 INFO 40 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8090 (http) with context path ''
2018-12-27 21:56:45.810 INFO 40 --- [main] .s.c.n.e.s.EurekaAutoServiceRegistration : Updating port to 8090
2018-12-27 21:56:45.810 INFO 40 --- [DiscoveryClient-InstanceInfoReplicator-0] com.netflix.discovery.DiscoveryClient : DiscoveryClient_APOLLO-ADMINSERVICE/8578c069d388:apollo-adminservice:8090 - registration status: 204
现在可以确定Eureka
注册中心中已经有两个服务分别为APOLLO-CONFIGSERVICE
和APOLLO-ADMINSERVICE
服务。
管理控制台部署(apollo-portal)
成功部署配置服务(apollo-configservice)
和管理服务(apollo-adminsrevice)
并启动成功后,现在可以部署管理控制台服务(apollo-portal)
了。首先在apollo-compose.yaml
文件添加两个服务:
mysql-portal:
image: mysql
# restart: always
environment:
- MYSQL_ROOT_PASSWORD=123456
expose:
- "3306"
volumes:
- /Users/yjwfn/bin/apollo/scripts/sql:/sql
apollo-portal:
image: <镜像名称>
environment:
DEV_META_SERVICE_NAME: apollo-configservice-dev
DATASOURCES_URL: "jdbc:mysql://mysql-portal:3306/ApolloPortalDB?characterEncoding=utf8"
DATASOURCES_USERNAME: root
DATASOURCES_PASSWORD: 123456
# expose:
# - "8070"
ports:
- 8070:8070 #方便测试导出端口
depends_on:
- "mysql-portal"
- "apollo-configservice-dev"
- "apollo-adminservice-dev"
管理控制台服务
使用了单独的mysql服务,没有与apollo-configservice-dev
和apollo-adminservice-dev
共享一个mysql服务,同样mysql-portal
也需要初始化数据库,这里我们首先启动mysql-portal
服务:
#启动服务
docker-compose -f apollo-compose.yaml up -d mysql-portal
#连接到容器执行命令
docker exec -it kube_mysql-portal_1 sh
#登陆mysql
mysql -p123456
#导入sql文件
source /sql/apolloportaldb.sql
mysql-portal
启动并配置完成后开始启动apollo-portal
服务:
docker-compose -f apollo-compose.yaml up -d apollo-portal
启动成功后可访问 http://localhost:8070 启动管理控制台。
总结
由于现在公司也正在使用Apollo做为分布式配置中心,所以决定学习下Apollo的相关知识。 此文章只涉及到部署想着的知识,里面提到的一些内容其实都可以在官方文档中找到,这里不得不提下Apollo的文档资料还是非常全的。总的来说部署的过程还是有些坑的,但是经过一段时候的摸索,还是成功的在Docker中部署了,之后还会学习Apollo的使用相关的知识,后续再来分享。
最后附上完整的apollo-compose.yaml
文件凑凑字数:
#坑一: mysql使用有对象设置环境变量无效
version: "3"
services:
mysql-dev:
image: mysql
# restart: always
environment:
- MYSQL_ROOT_PASSWORD=123456
expose:
- "3306"
volumes:
- /Users/yjwfn/bin/apollo/scripts/sql:/sql
apollo-configservice-dev:
image: harbor.rcntech.cn/apollo/apollo-configservice:v1.2.0
environment:
DATASOURCES_URL: jdbc:mysql://mysql-dev:3306/ApolloConfigDB?characterEncoding=utf8
DATASOURCES_USERNAME: root
DATASOURCES_PASSWORD: 123456
ENV: "dev"
expose:
- "8080"
depends_on:
- "mysql-dev"
apollo-adminservice-dev:
image: harbor.rcntech.cn/apollo/apollo-adminservice:v1.2.0
environment:
DATASOURCES_URL: "jdbc:mysql://mysql-dev:3306/ApolloConfigDB?characterEncoding=utf8"
DATASOURCES_USERNAME: root
DATASOURCES_PASSWORD: 123456
ENV: "dev"
expose:
- "8080"
depends_on:
- "mysql-dev"
- "apollo-configservice-dev"
mysql-portal:
image: mysql
# restart: always
environment:
- MYSQL_ROOT_PASSWORD=123456
expose:
- "3306"
volumes:
- /Users/yjwfn/bin/apollo/scripts/sql:/sql
apollo-portal:
image: harbor.rcntech.cn/apollo/apollo-portal:v1.2.0
environment:
DEV_META_SERVICE_NAME: apollo-configservice-dev
DATASOURCES_URL: "jdbc:mysql://mysql-portal:3306/ApolloPortalDB?characterEncoding=utf8"
DATASOURCES_USERNAME: root
DATASOURCES_PASSWORD: 123456
ports:
- 8070:8070
depends_on:
- "mysql-portal"
- "apollo-configservice-dev"
- "apollo-adminservice-dev"