Apollo管理多环境下的配置和踩坑实践

目录

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，如下图

环境和数据库初始化这里不做讲解，有疑问请看上一小节，下载源码解压后可以看到如下图：

现在开始修改源码，旨在于解决生产部署的一些问题

1. 修改config、admin、portal的端口
   分别修改config，admin，portal项目resource目录下的application.yml，以config为例，修改server.port=8030，如下图
   
2. 修改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地址，如下图
  

3. 使用外网id注入到配置中心，便于不同机器的服务访问
   修改apollo-adminservice或apollo-configservice 的bootstrap.yml文件，加入以下配置

eureka:
  instance:
    homePageUrl: http://${指定的IP}:${指定的Port}
    preferIpAddress: false

4. 统一管理数据库和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部署&开发遇到的常见问题