目录

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,如下图
apollo_release.png

环境和数据库初始化这里不做讲解,有疑问请看上一小节,下载源码解压后可以看到如下图:
unzip
现在开始修改源码,旨在于解决生产部署的一些问题

  1. 修改config、admin、portal的端口
    分别修改config,admin,portal项目resource目录下的application.yml,以config为例,修改server.port=8030,如下图
    update_port
  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地址,如下图
    update_eureka
  1. 使用外网id注入到配置中心,便于不同机器的服务访问
    修改apollo-adminservice或apollo-configservice 的bootstrap.yml文件,加入以下配置
eureka:
  instance:
    homePageUrl: http://${指定的IP}:${指定的Port}
    preferIpAddress: false
  1. 统一管理数据库和metaServe管理
    在项目根scripts目录下面,修改build.sh或者build.bat脚本,如下图位置,修改对应的数据库和meta server地址,需要注意的是meta server的配置环境地址要和portalDB下面serverConfig的环境配置保持一致,有几个环境就配几个metaServer,并且在数据库注明,如下图
    update_build

每次打不同环境的包除了修改上面的config地址以外,还需要修改config和admin下面bootstrap.yml中的homePageUrl注入地址。

使用jar包的方式部署到测试环境

使用scripts目录下面的build.sh或者build.bat打包,以config为例,打包后如下图
dabao
有没有很熟悉,和我们从官网下载的稳定版一模一样,唯一不同的是多了一个jar包,在这里我们使用jar包部署到生产,如果想知道通过
apollo-configservice-1.3.0-github.zip的方式部署,请看上一节从零到一,搭建apollo配置中心和apollo客户端(附源码),言归正传,我们将jar包像我们平时一样部署到测试环境,如下图
dev
config、admin、portal都按照上述的方式部署启动后(这里需要注意的是,启动必须先启动config,后启动admin,后启动portal,不然会报错),我们可以访问到portal首页,如下图

apollo_index.jpg
至此,通过源码构建服务端完成

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的值,如下图
    portal_db
  • 修改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部署&开发遇到的常见问题

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐