在Linux部署Apollo配置中心

发布时间 2023-04-05 16:29:15作者: 我有八千部下

前言

这篇是参考官网文档总结的Apollo分布式部署方式,包含具体步骤、资源和相关脚本,也在必要的地方给出了资料来源。

通过Apollo - 中文文档 - 部署架构可以了解到单机、集群和高可用部署架构的最佳实践方式。

安装步骤

本篇实践是在Linux系统,使用Apollo 1.9.1版本为例,要求环境包含JDK 1.8+和MySQ 5.6.5+。

文内脚本执会从GitHub - Apollo releases下载三个模块(Admin Service、Config Service和Portal Service)的包到~/soft/apollo目录下,解压后放在/opt/soft目录下,配置、启停都在解压目录完成,相当于工作目录。

可以先通过Apollo各模块概要重点了解下三个模块的作用。

Config Service:端口是8080,里面包含Meta Server,Eureka,Config Service,其中Config Service又使用了ConfigDB

Admin Service:端口是8090,使用了ConfigDB

Portal Service:端口是8070,使用了PortalDB。

部署顺序最好是:configservice → adminservice → portal。下图是模块间的依赖关系:

image-20211112171243559

创建数据库

执行Github - apolloconfigdb.sql来创建配置中心服务(Config Service)和配置管理服务(Admin Service)共用的的数据库ApolloConfigDB,并创建表以及数据。

执行Github - apolloportaldb.sql来创建管理界面服务(Portal Service)需要的数据库ApolloPortalDB,并创建表以及数据。

部署Config Service

  • 下载、解压
echo "下载configservice" > /dev/null
wget -P ~/soft/apollo https://github.com/apolloconfig/apollo/releases/download/v1.9.1/apollo-configservice-1.9.1-github.zip

echo "创建解压目录" > /dev/null
mkdir -p  /opt/soft/apollo

echo "解压到/opt/soft目录下" > /dev/null
unzip ~/soft/apollo/apollo-configservice-1.9.1-github.zip -d /opt/soft/apollo/configservice
  • 修改数据库地址为ApolloConfigDB
vim /opt/soft/apollo/configservice/config/application-github.properties
spring.datasource.url = jdbc:mysql://localhost:3306/ApolloConfigDB?useSSL=false&characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password = 666666
  • 启动、停止
# 启动
/opt/soft/apollo/configservice/scripts/startup.sh

# 停止
/opt/soft/apollo/configservice/scripts/shutdown.sh

部署Admin Service

  • 下载、解压
echo "下载adminservice" > /dev/null
wget -P ~/soft/apollo https://github.com/apolloconfig/apollo/releases/download/v1.9.1/apollo-adminservice-1.9.1-github.zip

echo "创建解压目录" > /dev/null
mkdir -p  /opt/soft/apollo

echo "解压到/opt/soft目录下" > /dev/null
unzip ~/soft/apollo/apollo-adminservice-1.9.1-github.zip -d /opt/soft/apollo/adminservice
  • 修改数据库地址为ApolloConfigDB
vim /opt/soft/apollo/adminservice/config/application-github.properties
spring.datasource.url = jdbc:mysql://localhost:3306/ApolloConfigDB?useSSL=false&characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password = 666666
  • 启动、停止
# 启动
/opt/soft/apollo/adminservice/scripts/startup.sh

# 停止
/opt/soft/apollo/adminservice/scripts/shutdown.sh

部署Portal Service

  • 下载、解压
echo "下载portal" > /dev/null
wget -P ~/soft/apollo https://github.com/apolloconfig/apollo/releases/download/v1.9.1/apollo-portal-1.9.1-github.zip

echo "创建解压目录" > /dev/null
mkdir -p  /opt/soft/apollo

echo "解压到/opt/soft目录下" > /dev/null
unzip ~/soft/apollo/apollo-portal-1.9.1-github.zip -d /opt/soft/apollo/portal
  • 修改数据库地址为ApolloPortalDB
vim /opt/soft/apollo/portal/config/application-github.properties
spring.datasource.url = jdbc:mysql://localhost:3306/ApolloPortalDB?useSSL=false&characterEncoding=utf8
spring.datasource.username = root
spring.datasource.password = 666666
  • 编辑环境配置,指定某个环境地址
vim /opt/soft/apollo/portal/config/apollo-env.properties

将dev环境地址指向指定Config Service地址。

dev.meta=http://fill-in-dev-meta-server:8080
  • 启动、停止
# 启动
/opt/soft/apollo/portal/scripts/startup.sh

# 停止
/opt/soft/apollo/portal/scripts/shutdown.sh

访问测试

通过HTTP请求http://<Portal Service IP>:8070来访问管理界面,默认用户名密码分别为apolloadmin。参考Apollo 使用指南可以了解到具体使用方式。

image-20211112172344444

多环境方案

参考服务端配置说明。配置项统一存储在ApolloPortalDB.ServerConfig表中,也可以通过管理员工具 - 系统参数页面进行配置,无特殊说明则修改完一分钟实时生效,但是修改环境得重启Portal Service。

image-20211207162532401

每个环境需要按上面的步骤各自搭建一套独立的Config Service和Admin Service,并使用独立的ConfigDB。最后再配置下面两个关键参数。

  • 可支持的环境列表(apollo.portal.envs)

    默认值是dev,如果portal需要管理多个环境的话,以逗号分隔即可(大小写不敏感),如:

DEV,FAT,UAT,PRO
  • 各环境Meta Service列表(apollo.portal.meta.servers)

    Apollo Portal需要在不同的环境访问不同的meta service(apollo-configservice)地址,所以我们需要在配置中提供这些信息。默认情况下,meta service和config service是部署在同一个JVM进程,所以meta service的地址就是config service的地址。如:

{
    "DEV":"http://1.1.1.1:8080",
    "FAT":"http://apollo.fat.xxx.com",
    "UAT":"http://apollo.uat.xxx.com",
    "PRO":"http://apollo.xxx.com"
}

高可用方案

搭建多套加独立的Config Service和Admin Service使用同一个ConfigDB。

在填写环境Meta Service地址的时候填多个用逗号分隔就行(如:http://1.1.1.1:8080,http://2.2.2.2:8080),但推荐通过SLB(Service Load Balancer)做动态负载均衡。

如何修改端口号和日志目录?

在各模块的启动脚本(startup.sh)可以指定服务日志生成目录,和使用的端口。

img

参考链接

GitHub - Apollo

码云 - Apollo 镜像

Apollo 中文文档

Apollo 官网

Apollo 使用指南