使用背景

当前我们项目，所有的配置都在存放在本地的propertise 文件进行配置，如各种链接url、端口、密码等，当我们需要切换环境调整参数的时候，我们必须手动修改这些配置、但这就带来了一个痛点，配置文件增多，采用分布式部署，导致需要每台机器都要更新，这个运维成本就高了，而且很容易出错，因此不得不引入一个分布式配置中心来解决这一痛点。

主流分布式配置中心介绍

Spring Cloud Config

2014年9月开源，Spring Cloud 生态组件，可以和Spring Cloud体系无缝整合。

Apollo

2016年5月，携程开源的配置管理中心，具备规范的权限、流程治理等特性。

Nacos

2018年6月，阿里开源的配置中心，也可以做DNS和RPC的服务发现。

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

参照图1

参照图2

准备工作(服务端)

1.1 运行时环境

1.1.1 OS

服务端基于Spring Boot，启动脚本理论上支持所有Linux发行版，建议CentOS 7。

1.1.2 JAVA

Apollo服务端：1.8+

Apollo客户端：1.7+

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

对于Apollo客户端，运行时环境只需要1.7+即可。

注：对于Apollo客户端，如果有需要的话，可以做少量代码修改来降级到Java 1.6，详细信息可以参考Issue 483

在配置好后，可以通过如下命令检查：

使用命令查看JDK版本

样例输出：

JDK版本

1.2 MYSQL

版本要求：5.6.5+

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

连接上MySQL后，可以通过如下命令检查：

MySQL版本

注1：MySQL版本可以降级到5.5，详见mysql 依赖降级讨论

导入Apollo的数据库脚本

脚本地址

成功样例

下载Apollo的安装包

如果不需要定制,下载官方打包好的安装包即可：地址

安装包

开始部署

1.1 将下载好的安装包上传至服务器（OS），并解压

**1.2启动流程（configservice→adminservice→portal）

 进入configservice的scripts目录，使用./startup.sh 启动configservice

 进入adminservice的scripts目录，使用./startup.sh 启动adminservice
 
  进入portal的scripts目录，使用./startup.sh 启动portal
 
 没有执行权限请使用  chmod 777 *.sh  授予权限
 
  异常排查请看:   /opt/logs

1.3、停止

进入每个文件夹的scripts目录，使用**./shutdown.sh **停止。

1.4 修改配置文件

进入configservice的config目录，编辑application-github.properties(修改数据库连接)        
 
 进入configservice的scripts目录， 编辑startup.sh(修改启动端口)
 
 进入adminservice的config目录，编辑application-github.properties(修改数据库连接)    
 
  进入adminservice的scripts目录， 编辑startup.sh(修改启动端口)
 
  进入portal的config目录，编辑application-github.properties(修改数据库连接)    
 
  进入portal的config目录，编辑apollo-env.properties(修改protal指向的configservice地址)
 
  进入portal的scripts目录， 编辑startup.sh(修改启动端口)

通过访问http://localhost:8070/可访问web页面的服务端。

初始账号/密码为：admin/apollo

----------------------------------------------------------------至此Apollo安装完成-----------------------------------

客户端使用(以Springboot为例:)

1.创建app

创建app

关键字说明

增加配置

增加配置后会，点击发布后，Apollo才会通知客户端拉取最新的配置

2. 添加Apollo客户端依赖

 <!-- https://mvnrepository.com/artifact/com.ctrip.framework.apollo/apollo-client -->
 <dependency>
  <groupId>com.ctrip.framework.apollo</groupId>
   <artifactId>apollo-client</artifactId>
   <version>1.4.0</version>
</dependency>

3.新建Springboot项目

项目结构

4.修改propertise文件

server.port=9520
#应用ID
app.id=apolloapp
#此处是configservice的地址
apollo.meta=http://192.168.139.131:8080
#在应用启动阶段，向Spring容器注入被托管的application.properties文件的配置信息。
apollo.bootstrap.enabled=true
#指定namespace 多个用,隔开
apollo.bootstrap.namespaces=application
#指定环境
env=DEV
#指定配置的缓存路径（！！！当配置中心不可用的时候会加载本地配置，确保有访问权限）
apollo.cacheDir=/opt/apolloapp

5.开启Apollo的支持

在启动类中添加@EnableApolloConfig注解开启Apollo的支持
@SpringBootApplication
@EnableApolloConfig
public class ApollodemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(ApollodemoApplication.class, args);
    }

}

6. 编写相关验证类

/**
 * Placeholder方式：
 * 代码中直接使用，如：@Value("${name}")
 */
@Component
public class JavaBean {
    @Value("${name}")
    private String name;

    public String getName() {
        return name;
    }
}

/**
 * 查看配置是否生效
 */
@RestController
public class Restful {

    protected Logger log = LoggerFactory.getLogger(Restful.class);
    private JavaBean bean;

    @Autowired
    public Restful(JavaBean javaBean) {
        this.bean = javaBean;
    }

    /**
     * 获取配置
     *
     * @return
     */
    @RequestMapping("/")
    public String changer() {
        return bean.getName();
    }


    /**
     * Apollo的配置改变触发的事件
     *
     * @param changeEvent
     */
    @ApolloConfigChangeListener
    public void onChange(ConfigChangeEvent changeEvent) {
        log.info("发生改变的key列表:{}", changeEvent.changedKeys());
    }
}

7. 启动项目