分布式配置Apollo快速入门

Apollo简介

Apollo（阿波罗）是携程框架部门研发的分布式配置中心，能够集中化管理应用的不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性，适用于微服务配置管理场景。

Apollo包括服务端和客户端两部分：
服务端基于Spring Boot和Spring Cloud开发，打包后可以直接运行，不需要额外安装Tomcat等应用容器。Java客户端不依赖任何框架，能够运行于所有Java运行时环境，同时对Spring/Spring Boot环境也有较好的支持。

Apollo快速入门

操作流程如下：

1. 在Apollo配置中心修改配置
2. 应用程序通过Apollo客户端从配置中心拉取配置信息
3. Apollo客户端从配置中心拉取最新的配置、更新本地配置并通知到应用

用户通过Apollo配置中心修改或发布配置后，会有两种机制来保证应用程序来获取最新配置：一种是Apollo配置中
心会向客户端推送最新的配置；另外一种是Apollo客户端会定时从Apollo配置中心拉取最新的配置，通过以上两种
机制共同来保证应用程序能及时获取到配置。

安装Apollo

运行时环境

Java

• Apollo服务端：1.8+
• Apollo客户端：1.7+

由于需要同时运行服务端和客户端，所以建议安装Java 1.8+。

MySQL

版本要求：5.6.5+

Apollo的表结构对timestamp 使用了多个default声明，所以需要5.6.5以上版本。

下载配置

1. 访问Apollo的官方主页获取安装包（本次使用1.3版本）：

链接地址： https://github.com/ctripcorp/apollo/tags

2. 解压安装包后将apollo-configservice-1.3.0.jar, apollo-adminservice-1.3.0.jar, apollo-portal-1.3.0.jar放置于apollo目录下

创建数据库

Apollo服务端共需要两个数据库： ApolloPortalDB 和ApolloConfigDB ，ApolloPortalDB只需要在生产环境部署一个即可，而ApolloConfigDB需要在每个环境部署一套。

1. 创建ApolloPortalDB，sql脚本下载地址：
   https://github.com/ctripcorp/apollo/blob/v1.3.0/scripts/db/migration/portaldb/V1.0.0__initialization.sql
2. 验证ApolloPortalDB
   导入成功后，可以通过执行以下sql语句来验证：

select `Id`, `Key`, `Value`, `Comment` from `ApolloPortalDB`.`ServerConfig` limit 1;

注：ApolloPortalDB只需要在生产环境部署一个即可

3. 创建ApolloConfigDB，sql脚本下载地址：

https://github.com/ctripcorp/apollo/blob/v1.3.0/scripts/db/migration/configdb/V1.0.0__initialization.sql

4. 验证ApolloConfigDB
   导入成功后，可以通过执行以下sql语句来验证：

select `Id`, `Key`, `Value`, `Comment` from `ApolloConfigDB`.`ServerConfig` limit 1;

启动Apollo

1. 确保端口未被占用
   Apollo默认会启动3个服务，分别使用8070, 8080, 8090端口，请确保这3个端口当前没有被使用

2. 启动apollo-configservice，在apollo目录下执行如下命令，可通过-Dserver.port=8080修改默认端口

java -Xms256m -Xmx256m -Dspring.datasource.url=jdbc:mysql://192.168.56.121:33065/ApolloConfigDB?characterEncoding=utf8 -Dspring.datasource.username=root -Dspring.datasource.password=root -jar apollo-configservice-1.3.0.jar

3. 启动apollo-adminservice，可通过-Dserver.port=8090修改默认端口

java -Xms256m -Xmx256m -Dserver.port=8090 -Dspring.datasource.url=jdbc:mysql://192.168.56.121:33065/ApolloConfigDB?characterEncoding=utf8 -Dspring.datasource.username=root -Dspring.datasource.password=root -jar apollo-adminservice-1.3.0.jar

4. 启动apollo-portal，可通过-Dserver.port=8070修改默认端口

java -Xms256m -Xmx256m -Dserver.port=8070 -Dspring.datasource.url=jdbc:mysql://192.168.56.121:33065/ApolloPortalDB?characterEncoding=utf8 -Dspring.datasource.username=root -Dspring.datasource.password=root -jar apollo-portal-1.3.0.jar

5. 也可以使用提供的runApollo.bat快速启动三个服务（修改数据库连接地址，数据库以及密码）

echo
set url="192.168.56.121:33065"
set username="root"
set password="root"
start "configService" java -Xms256m -Xmx256m -Dapollo_profile=github -Dspring.datasource.url=jdbc:mysql://%url%/ApolloConfigDB?characterEncoding=utf8 -Dspring.datasource.username=%username% -Dspring.datasource.password=%password% -Dlogging.file=.\logs\apollo-configservice.log -jar .\apollo-configservice-1.3.0-github\apollo-configservice-1.3.0.jar
start "adminService" java -Xms256m -Xmx256m -Dapollo_profile=github -Dspring.datasource.url=jdbc:mysql://%url%/ApolloConfigDB?characterEncoding=utf8 -Dspring.datasource.username=%username% -Dspring.datasource.password=%password% -Dlogging.file=.\logs\apollo-adminservice.log -jar .\apollo-adminservice-1.3.0-github\apollo-adminservice-1.3.0.jar
start "ApolloPortal" java -Xms256m -Xmx256m -Dapollo_profile=github,auth -Ddev_meta=http://localhost:8080/ -Dserver.port=8070 -Dspring.datasource.url=jdbc:mysql://%url%/ApolloPortalDB?characterEncoding=utf8 -Dspring.datasource.username=%username% -Dspring.datasource.password=%password% -Dlogging.file=.\logs\apollo-portal.log -jar .\apollo-portal-1.3.0-github\apollo-portal-1.3.0.jar

6. 运行runApollo.bat即可启动Apollo

7. 待启动成功后，访问管理页面 apollo/admin

springboot整合

引入pom文件

         <dependency>
            <groupId>com.ctrip.framework.apollo</groupId>
            <artifactId>apollo-client</artifactId>
            <version>1.1.0</version>
        </dependency>

java热更新

热更新配置，每三秒拉一次配置

	public class GetConfigTest {
	    public static void main(String[] args) throws InterruptedException {
	        Config config = ConfigService.getAppConfig();
	        String someKey = "sms.enable";
	        while (true) {
	            String value = config.getProperty(someKey, null);
	            System.out.printf("now: %s, sms.enable: %s%n", LocalDateTime.now().toString(),
	                    value);
	            Thread.sleep(3000L);
	        }
	    }
	}

vm 设置

-Dapp.id=fast-common-apollo-example -Denv=DEV -Ddev_meta=http://localhost:8080

创建apollo项目

我们可以更新sms.enable这个配置，观察java的console。

这个简单的demo的github地址：https://github.com/fafeidou/fast-cloud-nacos/tree/master/fast-common-examples/fast-common-apollo-example