1、前提:本文只支持默认的开发环境(DEV)、测试环境(FAT)、预发布环境(UAT)、生产环境(PRO)四种环境搭建,可以根据项目的实际使用情况部署所需要对应的环境。本文使用的是apollo1.9.2版本的jar直接部署。如果上述情况不满足项目需求,则可以根据实际项目需求修改apollo源码,然后进行定制化代码的打包部署
Apollo源码地址:https://github.com/apolloconfig/apollo
2、准备工作:
1) 对应文件压缩包及SQL文件如下:
百度网盘自取
链接:https://pan.baidu.com/s/12qsO357DexxoH00o05LrDQ
提取码:itcc
2) Apollo对应结构如下:
四个核心模块及其主要功能:
模块 | 主要功能 |
---|---|
ConfigService | 提供配置获取接口、提供配置推送接口、服务于Apollo客户端 |
AdminService | 提供配置管理接口、提供配置修改发布接口、服务于管理界面Portal |
Client | 为应用获取配置,支持实时更新; 通过MetaServer获取ConfigService的服务列表; 使用客户端软负载SLB方式调用ConfigService |
Portal | 配置管理界面、通过MetaServer获取AdminService的服务列表、使用客户端软负载SLB方式调用AdminService |
三个辅助服务发现模块
模块 | 主要功能 |
---|---|
Eureka | 用于服务发现和注册Config/AdminService注册实例并定期报心跳和ConfigService在一起部署 |
MetaServer | Portal通过域名访问MetaServer获取AdminService的地址列表,Client通过域名访问MetaServer获取ConfigService的地址列表,相当于一个Eureka Proxy逻辑角色,和ConfigService住在一起部署 |
NginxLB | 和域名系统配合,协助Portal访问MetaServer获取AdminService地址列表;和域名系统配合,协助Client访问MetaServer获取ConfigService地址列表;和域名系统配合,协助用户访问Portal进行配置管理 |
3、部署工作:
通过上面的结构可以了解到,部署apollo服务主要需要部署portal、adminservice、configservice三个服务。
portal是配置管理界面,只需要部署一个服务即可,同理数据库也只需要一个。
Adminservice和configservice是对应每个环境的,所以部署几个环境,就需要部署几个对应的Adminservice和configservice服务,同样每个环境都有对应的数据库。
我这里使用的是一台服务器部署四个环境。
3.1 第一步:创建对应的数据库,一个portalDB和四个apolloconfigdb,对应的sql在上面。(四个apolloconfigdb对应的表都是一样的,同样的sql文件执行到四个数据库即可)每个环境对应的数据库如下图,一目了然。
3.2 第二步:将zip包上传到服务器目录,解压,修改配置(每个环境存放一个目录,便于管理)
3.2.1 修改portal文件,启动对应服务:
解压后文件如下图:
① 修改apollo-portal.conf文件,修改对应服务启动日志文件打印位置:
(根据实际情况自行调整)
②修改config目录下apollo-env.properties文件
(该文件修改的是各个环境的访问地址,由于我的几个环境部署在同一台服务器上面了,所以通过修改使用端口进行启动多个服务)
这是配置的多环境对应的端口就是启动每个环境configservice所使用的端口
③ 修改config目录下application-github.properties文件
(该文件修改的是服务对应的数据库配置)
④ 修改scripts目录下的startup.sh
(该文件修改的是服务启动使用的端口,此端口也是访问配置页面使用的端口,根据实际情况调整,日志文件打印存放目录)
⑤ 打开portal对应ApolloPortalDB数据库的ServerConfig对应的表,添加对应的环境,因为我这里配置四个环境所以如下图(可根据实际情况调整)
通过上述四部操作,就完成了portal的对应配置修改,然后执行scripts目录下的startup.sh的启动脚本即可启动对应的服务,启动日志可以通过自定义配置的日志目录下找到对应的日志文件查看,当然此时虽然可以正常启动,但是还是会报错,因为对应的configservice服务还没有启动,肯定是访问不到的,无需担心。
3.2.2 修改dev目录下对应的adminservice和configservice的服务配置
在dev目录下创建adminservice和configservice两个目录
然后将对应的adminservice和configservice的zip包上传到对应的目录下,解压
① Adminservice目录下解压之后文件如下:
② 修改apollo-adminservice.conf文件中对应日志打印目录
③ 修改config目录下application-github.properties文件中对应的数据源配置
④ 修改scripts目录下startup.sh文件中的使用端口及日志打印目录
通过上述修改,dev环境的adminservice服务就修改完成了
⑤ Configservice目录下解压后文件如下:
⑥ 所需修改的地方和上述234一样,有一点需要注意4中的端口不能定义重复,我这里configservice使用的是8080端口,全部修改完成之后,对应的服务的配置就全部完成了
⑦ 打开数据库dev环境对应的ApolloConfigDBDev数据库,找到ServerConfig表,第一行数据是eureka的配置,注意value值一定要是configservice服务使用的端口。如下图:
通过上述操作,将对应的服务全部修改完成后,启动各自scripts目录下startup.sh脚本即可,启动成功后,configservice中会自带eureka服务,所以通过页面访问ip:8080/就可以访问到eureka了
访问ip:8070/就可以访问apollo配置界面了
默认初始用户密码:apollo/admin
通过上面的操作就完成了portal和dev环境的部署,其他的环境和dev同理,操作都一样。**需要注意的是每个环境的ApolloConfigDB数据库 ServerConfig表,第一行数据是eureka的配置,注意value值一定要是configservice服务使用的端口,如果这里端口没有更改,就会使用默认将服务注册到8080的eureka上面,就会出现环境错乱问题 **
我使用的端口如下:
Portal端口:8070
dev-configservice:8080
dev-adminservice:8090
fat-configservice:8081
fat-adminservice:8091
uat-configservice:8082
uat-adminservice:8092
pro-configservice:8085
pro-adminservice:8093
配置界面访问:ip:8070
代码中服务配置(四个环境):
apollo:
meta: http://ip:8080/
bootstrap:
enabled: true
namespaces: application
env: dev
apollo:
meta: http://ip:8081/
bootstrap:
enabled: true
namespaces: application
env: fat
apollo:
meta: http://ip:8082/
bootstrap:
enabled: true
namespaces: application
env: uat
apollo:
meta: http://ip:8085/
bootstrap:
enabled: true
namespaces: application
env: pro