Apollo介绍

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

Apollo支持4个维度管理Key-Value格式的配置：

Apollo的优势

正是基于配置的特殊性，所以Apollo从设计之初就立志于成为一个有治理能力的配置发布平台，目前提供了以下的特性：

配置修改实时生效（热发布）

提供开放平台API

Apollo的优势还可以通过与Spring Cloud Config对比来体现出

Apollo的核心概念介绍

Namespace

Namespace就相当于spring boot项目中的配置文件，例如namespace中有默认的application,格式为properties，则对应着application.properties。

1 Namespace的格式

配置文件有多种格式，例如：properties、xml、yml、yaml、json等。同样Namespace也具有这些格式。

2 Namespace的获取权限分类

Namespace的获取权限分为两种：

private （私有的）
public （公共的）
这里的获取权限是相对于Apollo客户端来说的。

2.1 private权限

private权限的Namespace，只能被所属的应用获取到。一个应用尝试获取其它应用private的Namespace，Apollo会报“404”异常。

2.2 public权限

public权限的Namespace，能被任何应用获取。

3. Namespace的类型

Namespace类型有三种：

3.1 私有类型

私有类型的Namespace具有private权限。例如上文提到的“application” Namespace就是私有类型。

3.2 公共类型
3.2.1 含义
公共类型的Namespace具有public权限。公共类型的Namespace相当于游离于应用之外的配置，且通过Namespace的名称去标识公共Namespace，所以公共的Namespace的名称必须全局唯一。

3.2.2 使用场景

3.3 关联类型

3.3.1 含义

关联类型又可称为继承类型，关联类型具有private权限。关联类型的Namespace继承于公共类型的Namespace，用于覆盖公共Namespace的某些配置。例如公共的Namespace有两个配置项

k1 = v1

k2 = v2

然后应用A有一个关联类型的Namespace关联了此公共Namespace，且覆盖了配置项k1，新值为v3。那么在应用A实际运行时，获取到的公共Namespace的配置为：

k1 = v3

k2 = v2

Apollo服务端（测试客户端用）

1 准备工作

apollo服务端要求1.8+

apollo客户端要求1.7+

1.2 MySQL

版本要求5.6.5+

1.3 下载Quick Start安装包

从Github下载

2. 安装步骤

2.1 创建数据库

Apollo服务端共需要两个数据库： ApolloPortalDB 和 ApolloConfigDB ，数据库、表的创建和样例数据都分别准备了sql文件，只需要导入数据库即可。

验证方法：

ApolloPortalDB：

  select `Id`, `AppId`, `Name` from ApolloPortalDB.App;
ApolloConfigDB：
  select `NamespaceId`, `Key`, `Value`, `Comment` from ApolloConfigDB.Item;
如果都有查询出结果那表示数据库创建成功。
2.2 配置数据库连接信息
Apollo服务端需要知道如何连接到你前面创建的数据库，所以需要编辑demo.sh，修改ApolloPortalDB和ApolloConfigDB相关的数据库连接串信息。
注意：填入的用户需要具备对ApolloPortalDB和ApolloConfigDB数据的读写权限。
# apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=用户名
apollo_config_db_password=密码（如果没有密码，留空即可）
# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=用户名
apollo_portal_db_password=密码（如果没有密码，留空即可）
3 启动Apollo配置中心
Apollo的quick start脚本会在本地启动三个端口分别为8070、8080、8090的服务，需在确保端口未被占用的情况下执行脚本
./demo.sh start 
eg:关闭服务的命令：
./demo.sh stop
当看到如下输出后，就说明启动成功了！
==== starting service ====
Service logging file is ./service/apollo-service.log
Started [10768]
Waiting for config service startup.......
Config service started. You may visit http://localhost:8080 for service status now!
Waiting for admin service startup....
Admin service started
==== starting portal ====
Portal logging file is ./portal/apollo-portal.log
Started [10846]
Waiting for portal startup......
Portal started. You can visit http://localhost:8070 now!
如果启动遇到了异常，可以分别查看service和portal目录下的log文件排查问题。
注：在启动apollo-configservice的过程中会在日志中输出eureka注册失败的信息，如com.sun.jersey.api.client.ClientHandlerException: java.net.ConnectException: Connection refused。需要注意的是，这个是预期的情况，因为apollo-configservice需要向Meta Server（它自己）注册服务，但是因为在启动过程中，自己还没起来，所以会报这个错。后面会进行重试的动作，所以等自己服务起来后就会注册正常了。
服务端使用
通过访问http://localhost:8070/可访问web页面的服务端。
初始账号/密码为：admin/apollo
具体使用指南可参考官网
该服务端只是用来初步体验和测试使用。
Apollo的客户端
Apollo支持基于Spring Boot、基于Java、基于XML等等多种方式的配置，具体详情可参考官网
Apollo会在本地存一份缓存配置文件
Mac/Linux上文件位置为/opt/data/{appId}/config-cache
Windows上文件位置为C:\opt\data{appId}\config-cache
本地配置文件会以{appId}+{cluster}+{namespace}.properties的文件名和格式存储，当获取不到网络配置时会从这个配置中取值
下面我就介绍最常用、简便、快捷、通用的方式，即基于Spring Boot的集成方式。
1 首先加入依赖
<dependency>
    <groupId>com.ctrip.framework.apollo</groupId>
    <artifactId>apollo-client</artifactId>
    <version>1.1.0</version>
</dependency>
2 在服务应用的配置中加入以下配置（本例子中的文件为application.yml）：
  id: test-app
apollo:
  meta: http://localhost:8080
  #cluster: myCluster
  #cacheDir: /opt/testDir
  bootstrap:
    enable: true
    namespaces: application
env: DEV
app.id为在服务端web页面上创建的项目APP的id
apollo.meta为apollo服务端的地址
apollo.cluster为要配置的集群名称，如果没有可不填
apollo.cacheDir为自定义缓存路径
apollo.bootstrap.enable为是否在工程启动的bootstrap阶段向Spring容器注入被托管的namespaces中的配置
apollo.bootstrap.namespaces为要使用的namespaces，可在web页面上看到
env为要获取的配置环境，目前支持以下几个值（大小写不敏感）：
DEV(Development environment)
FAT(Feature Acceptance Test environment)
UAT(User Acceptance Test environment)
PRO(Production environment)
在启动Spring Boot的java文件中添加注解：
@EnableApolloConfig
Apollo客户端的使用
通过@Value注解即可获取到值
可以以类的方式作为bean加载入Spring，例如
 @EnableApolloConfig
 @Configuration
 Class A {
     @Bean
     public getB() {
         return new B();
 Class B {
     private int x;
     public void setX(int x) {
         this.x = x;
     public int getX() {
         return this.x;