开始使用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
使用关系如下:
服务 ApolloPortalDB ApolloConfigDB
配置服务 Y
管理服务 Y
管理门户 Y
下面准备使用Dockere在dev环境部署Apollo。
准备工作
从Github来拉取最新的Apollo代码:
git clone git@github.com: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"
https://www.cnblogs.com/xwgblog/p/10188064.html