目录
1、源码构建Apollo配置中心
2、Apollo管理多环境的配置
3、Apollo从零到一过程中的踩坑记录
1、Apollo服务端的搭建
通过上一节我们基本实现了apollo配置中心,体验其便捷的同时,思考如果部署生产的话会有什么问题? 如何解决?
为什么要用源码构建?
- Apollo默认自带了Eureka作为内部的注册中心实现,端口为8080,但是一般公司自己已经有了一套Eureka,如果希望把Apollo的Config Service和AdminService也注册过去实现统一管理的话,需要改源码,然后打包。
- 作为Java程序员,想通过jar的方式部署管理apollo,并且修改其默认端口
- config和admin默认通过内网Ip注入注册中心,如果portal和config不在一台机器的话就无法访问。
- …
使用源码构建Apollo配置中心
我们需要到官方下载源码构建,下载地址为:https://github.com/ctripcorp/apollo/releases 选择最新的稳定版1.3.0,如下图
环境和数据库初始化这里不做讲解,有疑问请看上一小节,下载源码解压后可以看到如下图:
现在开始修改源码,旨在于解决生产部署的一些问题
- 修改config、admin、portal的端口
分别修改config,admin,portal项目resource目录下的application.yml,以config为例,修改server.port=8030,如下图
- 修改apollo默认的注册中心,使用公司自己的注册中心
- 以config为例,修改config启动文件configservice.ConfigServiceApplication,把@EnableEurekaServer改为@EnableEurekaClient
@EnableEurekaClient
@EnableAspectJAutoProxy
@EnableAutoConfiguration // (exclude = EurekaClientConfigBean.class)
@Configuration
@EnableTransactionManagement
@PropertySource(value = { "classpath:configservice.properties" })
@ComponentScan(basePackageClasses = { ApolloCommonConfig.class, ApolloBizConfig.class, ConfigServiceApplication.class,
ApolloMetaServiceConfig.class })
public class ConfigServiceApplication {
public static void main(String[] args) throws Exception {
SpringApplication.run(ConfigServiceApplication.class, args);
}
}
- 修改ApolloConfigDB.ServerConfig表中的eureka.service.url,指向自己的Eureka地址,如下图
- 使用外网id注入到配置中心,便于不同机器的服务访问
修改apollo-adminservice或apollo-configservice 的bootstrap.yml文件,加入以下配置
eureka:
instance:
homePageUrl: http://${指定的IP}:${指定的Port}
preferIpAddress: false
- 统一管理数据库和metaServe管理
在项目根scripts目录下面,修改build.sh或者build.bat脚本,如下图位置,修改对应的数据库和meta server地址,需要注意的是meta server的配置环境地址要和portalDB下面serverConfig的环境配置保持一致,有几个环境就配几个metaServer,并且在数据库注明,如下图
每次打不同环境的包除了修改上面的config地址以外,还需要修改config和admin下面bootstrap.yml中的homePageUrl注入地址。
使用jar包的方式部署到测试环境
使用scripts目录下面的build.sh或者build.bat打包,以config为例,打包后如下图
有没有很熟悉,和我们从官网下载的稳定版一模一样,唯一不同的是多了一个jar包,在这里我们使用jar包部署到生产,如果想知道通过
apollo-configservice-1.3.0-github.zip的方式部署,请看上一节从零到一,搭建apollo配置中心和apollo客户端(附源码),言归正传,我们将jar包像我们平时一样部署到测试环境,如下图
config、admin、portal都按照上述的方式部署启动后(这里需要注意的是,启动必须先启动config,后启动admin,后启动portal,不然会报错),我们可以访问到portal首页,如下图
2、Apollo管理多环境的配置
其实通过源码构建在修改build.sh中已经阐述过,在这里简单总结下
- 修改build.sh中的meta server地址,有几个环境就配几个地址,系统默认提供支持四个环境,如果想自定义环境,请看官方文档
# meta server url, different environments should have different meta server addresses
dev_meta=http://192.168.56.210:8030
# fat_meta=http://192.168.56.210:8030
# uat_meta=http://192.168.56.210:8030
pro_meta=http://192.168.56.211:8030
- 修改ApolloPortalDB数据库中ServerConfig表中apollo.portal.envs的值,如下图
- 修改build.sh数据库地址,改为对应环境的数据库地址
- 修改config和admin配置文件中homePageUrl地址,根据环境确定当前打包的config和admin的ip地址。
3、Apollo从零到一过程中的踩坑记录
系统出错,请重试或联系系统负责人
出现该错误的原因很多,我是因为没有改meta server地址的原因,使用默认的地址
local.meta=http://localhost:8080
dev.meta=http://fill-in-dev-meta-server:8080
fat.meta=http://fill-in-fat-meta-server:8080
uat.meta=http://fill-in-uat-meta-server:8080
lpt.meta=${lpt_meta}
pro.meta=http://fill-in-pro-meta-server:8080
启动客户端,找不到Admin地址
No available admin server. Maybe because of meta server don or all admin server down .meta server address :hettp://http://apollo.meta
分析:初看这个错误,以为是admin挂掉了,但是我检查了下注册中心,admin好好的,状态为up,并没有挂掉,通过后来检查,结果是自己马虎大意,应该给potal服务配置ApolloPortalDB的数据库,但是一时大意ctrl+c和Ctrl+v 大法复制成了ApolloConfigDB,此种错误万不应该,谨记后人。
使用build.sh打包源码的时候,报以下错误
The plugin pl.project13.maven:git-commit-id-plugin:2.2.0 requires Maven Version {3.1.1,)
分析:初看这个错误,很明显说插件git-commit-id-plugin的2.2.0版本需要3.1.1以上的maven版本。
解决:下载了最新的maven3.6.0,但是还是报相同的错误,莫名其妙,最后看到git-commit-id-plugin插件最新的版本是2.2.6,修改该插件的版本解决
<plugin>
<groupId>pl.project13.maven</groupId>
<artifactId>git-commit-id-plugin</artifactId>
<version>2.2.6</version>
<executions>
<execution>
<goals>
<goal>revision</goal>
</goals>
</execution>
</executions>
<configuration>
<verbose>true</verbose>
<dateFormat>yyyy-MM-dd'T'HH:mm:ssZ</dateFormat>
<generateGitPropertiesFile>true</generateGitPropertiesFile>
<failOnNoGitDirectory>false</failOnNoGitDirectory>
</configuration>
</plugin>
客户端拉取Apollo服务端的配置,重试多次都失败
Get Config services failed from http:localhost:8070/services/config?appId=321123&ip=192.168.56.1
分析:就是没获取Apollo服务端的配置失败,一般情况下,获取服务端失败的三个原因:
- 客户端配置文件中config的地址配置错误
- 客户端中appid配置错误
- 客户端中nameSpace配置错误
解决:通过日志8070是portal服务的Ip,不是config的地址,所以是第一个原因导致的,修改配置文件中config的地址
apollo:
bootstrap:
enabled: true
namespaces: application
meta: http://localhost:8030
关于客户端的讲解请看上一章从零到一,搭建apollo配置中心和apollo客户端(附源码),客户端的源码地址config-client-apollo
参考链接:
Apollo部署&开发遇到的常见问题