编程知识 cdmana.com

在CentOS8下分布式部署Apollo配置中心

前言

众所周知Apollo是携程开源的配置中心,所以中文文档也比较完善,因此这里就不过多赘述细节了。本文的主要目的是记录下如何在CentOS8下分布式部署Apollo配置中心。Apollo的功能亮点:

  • 统一管理不同环境、不同集群的配置
  • 配置修改实时生效(热发布)
  • 版本发布管理
  • 灰度发布
  • 权限管理、发布审核、操作审计
  • 客户端配置信息监控
  • 提供Java和.Net原生客户端
  • 提供开放平台API
  • 部署相对简单
  • 中文文档完善

官方的分布式部署文档:

如果只是想在本地开发时快速搭建一个Apollo环境的话,参考官方的Quick Start即可:


准备工作

下图是Apollo架构模块的概览:
在CentOS8下分布式部署Apollo配置中心

上图简要描述了Apollo的总体设计,我们可以从下往上看:

  • Config Service提供配置的读取、推送等功能,服务对象是Apollo客户端
  • Admin Service提供配置的修改、发布等功能,服务对象是Apollo Portal(管理界面)
  • Config Service和Admin Service都是多实例、无状态部署,所以需要将自己注册到Eureka中并保持心跳
  • 在Eureka之上我们架了一层Meta Server用于封装Eureka的服务发现接口
  • Client通过域名访问Meta Server获取Config Service服务列表(IP+Port),而后直接通过IP+Port访问服务,同时在Client侧会做load balance、错误重试
  • Portal通过域名访问Meta Server获取Admin Service服务列表(IP+Port),而后直接通过IP+Port访问服务,同时在Portal侧会做load balance、错误重试
  • 为了简化部署,我们实际上会把Config Service、Eureka和Meta Server三个逻辑角色部署在同一个JVM进程中

因此,我们通常主要是部署两个节点负责不同的角色:ConfigServer(包含config service、admin service、meta server)节点和PortalServer节点。首先使用虚拟化软件创建两个CentOS8虚拟机,我这里用的是VMware:
在CentOS8下分布式部署Apollo配置中心

  • Config-Server的IP:192.168.243.159
  • Portal-Server的IP:192.168.243.158

由于Apollo是基于Java的Spring Boot框架编写的,以及依赖了MySQL做数据存储。所以在这两台虚拟机上,我已经提前安装好了MySQL和JDK。

官方对运行时环境的要求是:

  • Apollo服务端:JDK 1.8+
  • Apollo客户端:JDK 1.7+
  • MySQL:5.6.5+
  • 建议OS:CentOS7

而我这里的运行时环境是:

  • Apollo服务端:JDK 11
  • Apollo客户端:JDK 11
  • MySQL 8.0.18
  • OS:CentOS8

如下:

[root@config-server ~]# java -version
java version "11.0.5" 2019-10-15 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.5+10-LTS)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.5+10-LTS, mixed mode)
[root@config-server ~]# mysql --version
mysql  Ver 8.0.18 for Linux on x86_64 (Source distribution)
[root@config-server ~]# cat /etc/redhat-release
CentOS Linux release 8.0.1905 (Core) 
[root@config-server ~]# 

创建数据库

完成准备工作后,第一步是创建相应的数据库。因为Apollo依赖于MySQL数据库,所以需要事先创建并完成库表的初始化。分布式部署Apollo服务需要将ApolloPortalDBApolloConfigDB两个数据库分别在不同的MySQL实例上创建。

当然,如果不需要分开管理的话,也可以在一个MySQL实例中创建。官方把数据库、表的创建和样例数据都分别准备了SQL文件,我们只需要导入数据库即可。SQL文件的地址如下:

需要注意的是ApolloPortalDB只需要在生产环境部署一个即可,而ApolloConfigDB需要在每个环境部署一套,如fat、uat和pro环境分别部署3套ApolloConfigDB。我这里是在Config-Server和Portal-Server分别部署了一个MySQL实例。

将两个SQL文件分别导入两个数据库成功后,创建的数据库、表如下:
在CentOS8下分布式部署Apollo配置中心
在CentOS8下分布式部署Apollo配置中心


获取安装包

需要的安装包共有3个:

  • apollo-configservice
  • apollo-adminservice
  • apollo-portal

可以直接下载官方提供的安装包,也可以自己通过源码构建。由于没有修改源码的需求,所以我这里直接下载安装包。下载地址见Github Releases

复制下载链接在服务器上使用wget命令下载或者在本地下载好后上传到服务器。config-server的安装包如下:

[root@config-server ~]# cd /usr/local/src
[root@config-server /usr/local/src]# ls
apollo-adminservice-1.7.1-github.zip    apollo-configservice-1.7.1-github.zip
[root@config-server /usr/local/src]# 

portal-server的安装包如下:

[root@portal-server ~]# cd /usr/local/src
[root@portal-server /usr/local/src]# ls
apollo-portal-1.7.1-github.zip
[root@portal-server /usr/local/src]# 

部署Apollo Config Server

将压缩包,解压到合适的目录下:

[root@config-server /usr/local/src]# mkdir /usr/local/apollo-configservice
[root@config-server /usr/local/src]# unzip apollo-configservice-1.7.1-github.zip -d /usr/local/apollo-configservice
[root@config-server /usr/local/src]# mkdir /usr/local/apollo-adminservice
[root@config-server /usr/local/src]# unzip apollo-adminservice-1.7.1-github.zip -d /usr/local/apollo-adminservice/
[root@config-server /usr/local/src]# ls /usr/local/apollo-configservice
apollo-configservice-1.7.1.jar  apollo-configservice-1.7.1-sources.jar  apollo-configservice.conf  config  scripts
[root@config-server /usr/local/src]# ls /usr/local/apollo-adminservice/
apollo-adminservice-1.7.1.jar  apollo-adminservice-1.7.1-sources.jar  apollo-adminservice.conf  config  scripts
[root@config-server /usr/local/src]# 

配置apollo-configservice的数据库连接信息:

[root@config-server /usr/local/src]# cd /usr/local/apollo-configservice/
[root@config-server /usr/local/apollo-configservice]# vim config/application-github.properties 
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
spring.datasource.username = root
spring.datasource.password = 123456a.
  • 填写正确的ApolloConfigDB数据库连接串信息,注意用户名和密码后面不要有空格!

配置apollo-adminservice的数据库连接信息:

[root@config-server /usr/local/apollo-configservice]# cd ../apollo-adminservice/
[root@config-server /usr/local/apollo-adminservice]# vim config/application-github.properties 
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
spring.datasource.username = root
spring.datasource.password = 123456a.
  • 填写正确的ApolloConfigDB数据库连接串信息,注意用户名和密码后面不要有空格!

如果需要调整apollo-configservice和apollo-adminservice的JVM启动参数、服务监听端口以及日志文件存放目录等配置,可以在其安装目录下的scripts/startup.sh脚本中进行修改:

  • 如果需要修改JVM参数,可以修改scripts/startup.shJAVA_OPTS部分
  • 如要调整服务的日志输出路径,可以修改scripts/startup.shapollo-configservice.conf中的LOG_DIR
  • 如要调整服务的监听端口,可以修改scripts/startup.sh中的SERVER_PORT。另外由于apollo-configservice同时承担meta server职责,如果要修改端口,注意要同时修改ApolloConfigDB.ServerConfig表中的eureka.service.url配置项以及apollo-portal和apollo-client中的使用到的meta server信息

启动apollo-configservice:

[root@config-server /usr/local/apollo-configservice]# scripts/startup.sh 
2020 11 10 星期二 16:34:22 CST ==== Starting ==== 
Started [20958]
Waiting for server startup...
2020 11 10 星期二 16:34:38 CST Server started in 15 seconds!
[root@config-server /usr/local/apollo-configservice]# 

检查是否启动成功:

[root@config-server /usr/local/apollo-configservice]# jps
1655 apollo-configservice.jar
1807 Jps
[root@config-server /usr/local/apollo-configservice]# netstat -lntp |grep 8080
tcp6       0      0 :::8080            :::*             LISTEN      1655/java           
[root@config-server /usr/local/apollo-configservice]# 

启动apollo-adminservice:

[root@config-server /usr/local/apollo-adminservice]# scripts/startup.sh 
2020 11 10 星期二 16:39:46 CST ==== Starting ==== 
Started [1886]
Waiting for server startup...
2020 11 10 星期二 16:40:01 CST Server started in 15 seconds!
[root@config-server /usr/local/apollo-adminservice]# 

检查是否启动成功:

[root@config-server /usr/local/apollo-adminservice]# jps
1655 apollo-configservice.jar
2012 Jps
1886 apollo-adminservice.jar
[root@config-server /usr/local/apollo-adminservice]# netstat -lntp |grep 8090
tcp6       0      0 :::8090          :::*             LISTEN      1886/java           
[root@config-server /usr/local/apollo-adminservice]# 

若想要停止服务则是执行相应服务目录下的scripts/shutdown.sh脚本即可。


部署Apollo Portal Server

与上一小节类似,将压缩包,解压到合适的目录下:

[root@portal-server /usr/local/src]# mkdir /usr/local/apollo-portal
[root@portal-server /usr/local/src]# unzip apollo-portal-1.7.1-github.zip -d /usr/local/apollo-portal/
[root@portal-server /usr/local/src]# ls /usr/local/apollo-portal/
apollo-portal-1.7.1.jar  apollo-portal-1.7.1-sources.jar  apollo-portal.conf  config  scripts
[root@portal-server /usr/local/src]# 

配置apollo-portal的数据库连接信息:

[root@portal-server /usr/local/src]# cd /usr/local/apollo-portal/
[root@portal-server /usr/local/apollo-portal]# vim config/application-github.properties
# DataSource
spring.datasource.url = jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
spring.datasource.username = root
spring.datasource.password = 123456a.

然后就是配置apollo-portal的meta service信息。Apollo Portal需要在不同的环境访问不同的meta service(apollo-configservice)地址,所以我们需要在配置中提供这些信息。

默认情况下,meta service和config service是部署在同一个JVM进程,所以meta service的地址就是config service的地址。配置项的格式为${env}.meta=http://${config-service-url:port},如下所示:

[root@portal-server /usr/local/apollo-portal]# vim config/apollo-env.properties
dev.meta=http://192.168.243.159:8080
  • 如果某个环境不需要,也可以直接删除对应的配置项,我这里是将默认的其他环境删除了,只配置了dev.meta

除了通过apollo-env.properties方式配置meta service以外,apollo也支持在运行时指定meta service(优先级比apollo-env.properties高):

  1. 通过Java System Property ${env}_meta 指定
    • 可以通过Java的System Property ${env}_meta来指定
    • java -Ddev_meta=http://config-service-url -jar xxx.jar
    • 也可以通过程序指定,如System.setProperty("dev_meta", "http://config-service-url");
  2. 通过操作系统的System Environment ${ENV}_META 指定
    • DEV_META=http://config-service-url
    • 注意key为全大写,且中间是“_”分隔

启动apollo-portal:

[root@portal-server /usr/local/apollo-portal]# scripts/startup.sh 
2020 11 10 星期二 16:56:36 CST ==== Starting ==== 
Started [21010]
Waiting for server startup........
2020 11 10 星期二 16:57:17 CST Server started in 40 seconds!
[root@portal-server /usr/local/apollo-portal]# 

检查是否启动成功:

[root@portal-server /usr/local/apollo-portal]# jps
21010 apollo-portal.jar
21162 Jps
[root@portal-server /usr/local/apollo-portal]# netstat -lntp |grep 8070
tcp6       0      0 :::8070                 :::*                    LISTEN      21010/java          
[root@portal-server /usr/local/apollo-portal]# 

启动成功后,通过浏览器访问portal-server的8070端口:
在CentOS8下分布式部署Apollo配置中心

  • 默认用户名密码为:apollo/admin

登录成功后,进入首页:
在CentOS8下分布式部署Apollo配置中心

然后可以进入示例项目中进行一些测试,看看是否正常可用:
在CentOS8下分布式部署Apollo配置中心

至此我们就完成了Apollo的分布式部署,这里只是部署了一套环境,如果有多套环境,只需要重复部署Apollo Config Server小节的步骤部署多个Config Server节点即可。然后在Portal Server的apollo-env.properties配置文件中配置好这些个Config Server节点的访问地址。

版权声明
本文为[osc_m3eztdrr]所创,转载请带上原文链接,感谢
https://my.oschina.net/u/4377796/blog/4714091

Scroll to Top