Docker部署Apollo配置中心

Posted 2021-01-30 xwgblog

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Docker部署Apollo配置中心相关的知识，希望对你有一定的参考价值。

开始使用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 [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"

以上是关于Docker部署Apollo配置中心的主要内容，如果未能解决你的问题，请参考以下文章

docker-compose 一键部署分布式配置中心Apollo

ABP微服务系列学习-对接Apollo配置中心

使用Docker搭建Apollo分布式配置中心

Apollo阿波罗配置中心docker

K8S部署apollo配置中心