社区微信群开通啦,扫一扫抢先加入社区官方微信群
社区微信群
在Spring Boot 2.0 整合携程Apollo配置中心一文中,我们在本地快速部署试用了Apollo。本文将介绍如何按照分布式部署(采用Docker部署)的方式编译、打包、部署Apollo配置中心,从而可以在开发、测试、生产等环境分别部署运行。
本文将在CentOS 7.x上部署Apollo配置中心服务端。
对于Java和MySQL的要求可以参考Spring Boot 2.0 整合携程Apollo配置中心准备工作的部分。
对于Docker环境的安装可以参考CentOS 7.x 安装Docker
对于Docker Compose的安装可以参考Docker Compose编排微服务
分布式部署需要事先确定部署的环境以及部署方式。Apollo目前支持以下环境:
以ctrip为例,其部署策略如下:
另外可以参考下面的样例部署图:
为了演示方便,本文将Apollo-portal,Apollo-adminservice和Apollo-configservice部署在一台机器上
服务器 | 服务 | 端口 | 环境 |
---|---|---|---|
192.168.10.138 | apollo-portal | 8070 | UAT |
192.168.10.138 | apollo-adminservice | 8080 | UAT |
192.168.10.138 | apollo-configservice | 8090 | UAT |
分布式部署的时候,apollo-configservice和apollo-adminservice需要把自己的IP和端口注册到Meta Server(apollo-configservice本身)。
Apollo客户端和Portal会从Meta Server获取服务的地址(IP+端口),然后通过服务地址直接访问。
所以如果实际部署的机器有多块网卡(如docker),或者存在某些网卡的IP是Apollo客户端和Portal无法访问的(如网络安全限制),那么我们就需要在apollo-configservice和apollo-adminservice中做相关限制以避免Eureka将这些网卡的IP注册到Meta Server。
如下面这个例子就是对于apollo-configservice,把docker0和veth.* 的网卡在注册到Eureka时忽略掉。
spring:
application:
name: apollo-configservice
profiles:
active: ${apollo_profile}
cloud:
inetutils:
ignoredInterfaces:
- docker0
- veth.*
另外一种方式是直接指定要注册的IP,可以修改startup.sh,通过JVM System Property在运行时传入,如-Deureka.instance.ip-address=${指定的IP}
,或者也可以修改apollo-adminservice或apollo-configservice 的bootstrap.yml文件,加入以下配置
eureka:
instance:
ip-address: ${指定的IP}
最后一种方式是直接指定要注册的IP+PORT,可以修改startup.sh,通过JVM System Property在运行时传入,如-Deureka.instance.homePageUrl=http://${指定的IP}:${指定的Port}
,或者也可以修改apollo-adminservice或apollo-configservice 的bootstrap.yml文件,加入以下配置
eureka:
instance:
homePageUrl: http://${指定的IP}:${指定的Port}
preferIpAddress: false
如果Apollo部署在公有云上,本地开发环境无法连接,但又需要做开发测试的话,客户端可以升级到0.11.0版本及以上,然后通过-Dapollo.configService=http://config-service的公网IP:端口
来跳过meta service的服务发现
部署步骤共三步:
Apollo服务端共需要两个数据库:ApolloPortalDB和ApolloConfigDB,官网把数据库、表的创建和样例数据都分别准备了sql文件(在下载的源码/scripts/sql
目录下),只需要导入数据库即可。
由于我只在一台服务器上做演示,所以ApolloPortalDB
和ApolloConfigDB
在UAT环境部署一套就可以了
服务器 | 数据库 | 端口 | 环境 |
---|---|---|---|
192.168.10.58 | ApolloPortalDB | 3306 | UAT |
192.168.10.58 | ApolloConfigDB | 3306 | UAT |
通过各种Mysql客户端(Navicat,DataGrip等)导入sql/apolloportaldb.sql
即可
下面以MySQL原生客户端为例:
source /your_local_path/sql/apolloportaldb.sql
导入成功后,可以通过执行以下sql语句来验证:
select `Id`, `AppId`, `Name` from ApolloPortalDB.App;
Id | AppId | Name |
---|---|---|
1 | SampleApp | Sample App |
通过各种Mysql客户端(Navicat,DataGrip等)导入sql/apolloconfigdb.sql
即可
下面以MySQL原生客户端为例:
source /your_local_path/sql/apolloconfigdb.sql
导入成功后,可以通过执行以下sql语句来验证:
select `NamespaceId`, `Key`, `Value`, `Comment` from ApolloConfigDB.Item;
NamespaceId | Key | Value | Comment |
---|---|---|---|
1 | timeout | 100 | sample |
如果是全新部署的Apollo配置中心,请忽略此步。
如果不是全新部署的Apollo配置中心,比如已经使用了一段时间,这时在Apollo配置中心已经创建了不少项目以及namespace等,那么在新环境中的ApolloConfigDB中需要从其它正常运行的环境中导入必要的项目数据。
主要涉及ApolloConfigDB的下面4张表,下面同时附上需要导入的数据查询语句:
同时也别忘了通知用户在新的环境给自己的项目设置正确的配置信息,尤其是一些影响面比较大的公共namespace配置。
Apollo自身的一些配置是放在数据库里面的,所以需要针对实际情况做一些调整。
配置项统一存储在ApolloPortalDB.ServerConfig表中,也可以通过管理员工具 - 系统参数页面进行配置。
DEV,FAT,UAT,PRO
,我这里设置为UAT
(1.1.0版本增加了系统信息页面(管理员工具 -> 系统信息),可以通过该页面检查配置是否正确)配置项统一存储在ApolloConfigDB.ServerConfig表中,需要注意每个环境的ApolloConfigDB.ServerConfig都需要单独配置。
http://192.168.10.138:8080/eureka
。后续文章我会单独介绍如何将Config Service和Admin Service注册到公司统一的Eureka上可以通过两种方式获取安装包:
这里我是通过源码构建的
到github上进行源码下载
Apollo服务端需要知道如何连接到你前面创建的数据库,所以需要编辑scripts/build.sh,修改ApolloPortalDB和ApolloConfigDB相关的数据库连接串信息。
# apollo config db info
apollo_config_db_url=jdbc:mysql://192.168.10.58:3306/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=root
apollo_config_db_password=Ibase2016
# apollo portal db info
apollo_portal_db_url=jdbc:mysql://192.168.10.58:3306/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=root
apollo_portal_db_password=Ibase2016
Apollo Portal需要在不同的环境访问不同的meta service(apollo-configservice)地址,所以需要在打包时提供这些信息。我这里只部署UAT环境,配置修改如下:
# meta server url, different environments should have different meta server addresses
#dev_meta=http://192.168.10.58:8080
#fat_meta=http://192.168.10.58:8080
uat_meta=http://192.168.10.138:8080
#pro_meta=http://192.168.10.58:8080
#META_SERVERS_OPTS="-Ddev_meta=$dev_meta -Dfat_meta=$fat_meta -Duat_meta=$uat_meta -Dpro_meta=$pro_meta"
META_SERVERS_OPTS="-Duat_meta=$uat_meta"
做完上述配置后,就可以执行编译和打包了。执行/scripts目录下build.sh脚本,该脚本会依次打包apollo-configservice, apollo-adminservice, apollo-portal。
分别将上面的安装包和Dockerfile文件上传至服务器(已安装Docker)上
上传到服务器上的安胡子那个包和Dockerfile文件目录结构如下:
apollo_portal
- Dokerfile
- apollo-portal-x.x.x-github.zip
apollo_config
- Dokerfile
- apollo-configservice-x.x.x-github.zip
apollo_admin
- Dokerfile
- apollo-adminservice-x.x.x-github.zip
apollo_portal
目录执行如下命令docker build -t simon/apollo_portal .
apollo_config
目录执行如下命令docker build -t simon/apollo_configservice .
apollo_admin
目录执行如下命令docker build -t simon/apollo_adminservice .
我们通过docker compose部署Apollo服务端,部署的配置文件如下:
version: "3"
services:
apollo-configservice: ##容器服务名
container_name: apollo-configservice ##容器名
#build: apollo-configservice/src/main/docker/ ##Dockerfile路径
image: simon/apollo-configservice ##镜像名
ports:
- "8080:8080"
volumes:
- "/opt/logs/100003171:/opt/logs/100003171" ##将/opt/logs/100003171目录挂载到宿主机的/opt/logs/100003171方便在宿主机上查看日志
apollo-adminservice:
container_name: apollo-adminservice
#build: apollo-adminservice/src/main/docker/
image: simon/apollo-adminservice
ports:
- "8090:8090"
depends_on:
- apollo-configservice
volumes:
- "/opt/logs/100003172:/opt/logs/100003172"
apollo-portal:
container_name: apollo-portal
#build: apollo-portal/src/main/docker/
image: simon/apollo-portal
ports:
- "8070:8070"
depends_on:
- apollo-adminservice
volumes:
- "/opt/logs/100003173:/opt/logs/100003173"
在配置文件目录执行如下命令启动服务:
docker-compose up
这样整个部署过程就结束了。
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!