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

自己在学习过程中发现Apollo配置中心，相对于SpringConfig等配置中心在部署上特别复杂，但是一旦配置完成，使用起来特别方便，因此在学习中应该特别弄明白他的架构模型。

Apollo架构模型简单点如下图：他的用户分两类，一类相当于管理员（运维人员）往其中写入配置，一类为客户端（微服务）往配置拉取配置。

但是光看上图不足以明白Apollo配置中心是如何运行的，更不能自己配置，因此重点依照下图对Apollo架构模型进行介绍。

管理员利用portal端发布配置，portal首先访问metaService发现AdminService地址，而后访问AdminService将配置修改到ConfigDB，同时通知ConfigService通知变更，ConfigService推送更新消息给Client。

客服端支持两种方式更新配置 1.当配置中心配置变更后，主动推送配置给客服端，而后客服端将配置缓存到本地，并同时将应用相关配置进行热修改。 2.客服端定时从配置中心拉取配置，若有变化则通知应用程序进行更新。

因为有缓存的存在所以，当与配置中心断开时，应用也不会停止，他会从本地缓存读取相应的配置。

Apollo不同的环境是独立且相互隔离的，而他的使用者，通过自身的配置来确定访问/设置的环境。下面以dev开发环境、pro生产环境为案例进行apollo服务的部署。

每套环境需要依赖数据库，ApolloPortalDB和ApolloConfigDB（数据库文件下载地址）。这里对两个系统准备数据库环境如下

环境准备

1. 手动部署

自己下载adminservice、configservice、portal三个服务的压缩包，上传至服务器解压。

（1）ConfigService

进入configService中的config目录

修改application-github.properties文件中的数据源，注意在数据库连接最好加上时区，否则会可能在运行时会出错。其中数据库选择，根据相应的环境做选择。如为dev环境就选择configdb-dev ， pro环境就选择configdb-pro。

（2）AdminService

同configService进入conf目录修改application-github.properties中的数据源。

（3）Portal

修改config目录下的application-github.properties 文件，指定portal数据库。 修改config目录下的apollo-env.properties文件，配置相应环境的地址。

（4）启动服务

因为configService中自带eureka 和 meta服务的包，所以启动顺序应该为: confiService -> adminService ->portal 启动configService中的scripts包下的startup.sh文件

编辑startup.sh文件更改Service的启动端口一般使用默认8080，这个端口为metaService端口，其他服务或应该通过该端口访问注册中心，从而进行其他操作。

启动configService中的scripts包下的startup.sh文件

启动portal中的scripts包下的startup.sh文件 访问portal主机（http://192.168.17.101:8070/）即可看到服务配置页面，输入用户名apollo，密码admin后登录。

2.脚本自动部署（Quick Start）

（1）下载Quick Start

1.从GitHub下载：下载地址 2.从百度网盘下载 通过网盘链接下载，提取码: 9wwe 下载到本地后，在本地解压apollo-quick-start.zip

（2）配置文件

Apollo服务端需要知道如何连接到你前面创建的数据库，所以需要编辑demo.sh，修改ApolloPortalDB和ApolloConfigDB相关的数据库连接串信息。

（3）启动脚本

注意：Quick Start只针对本地测试使用

1.日志文件位置

在服务根目录中xx.conf文件记录了日志文件存储位置，通过日志文件可以排除错误。

2.通过数据库修改配置

（1）eureka位置

在configDB库中的serverconfig表中eureka.service.url配置eureka位置，若使用自带eureka可以不修改，若使用自己搭建eureka修改为自己的eureka就行。

（2）portal环境设置

自己在portal使用中遇到一个问题：虽然在配置文件中配置了dev和pro两个环境，但是启动时页面只有一个环境，这里可通过数据库配置，来手动给portal添加环境，然后重启portal添加完毕。

1.创建应用

配置中心利用应用来识别区分配置

AppId：应用的唯一识别符 应用名称：仅在页面上显示的名称

2.键值对添加

点击添加配置，来对配置键值对进行添加。 添加完后需要点击发布，才会生效。

3.yml文件添加

由于Apollo私有命名空间只接受.properties键值对形式，所以对于yml文件需要利用yml在线转化工具转为键值对形式，再利用文本形式添加。

这里直接上手快速读取配置

1.导入依赖

2.编写配置

（1）设置应用id

在classpath下的meta-INF文件夹中新建app.properties文件写入需要读取的应用id

注意这里的appID要和之前apollo配置中心应用id一致。

（2）配置环境列表

在classpath下新建apollo-env.properties写入环境列表

（3）选择环境

更改window/linux下C:optsettingsserver.properties文件来选择需要读取的环境。这里演示快速入门，详细在下个目录介绍。

（4）配置命名空间

bootstrap.yml文件中设置命名空间这里采用默认命名空间。

3.测试

启动项目访问，查看结果。 controller代码：

访问页面结果： 读取成功！！！

4.其他操作

（1）本地缓存

Apollo客户端会把从服务端获取到的配置在本地文件系统缓存一份，用于在遇到服务不可用，或网络不通的时候，依然能从本地恢复配置，不影响应用正常运行。 Mac/Linux: /opt/data/{appId}/config-cache Windows: C:optdata{appId}config-cache

更改方式： 配置文件：在Spring Boot的application.properties或bootstrap.properties中指定apollo.cache-dir=/opt/data/some-cache-dir(1.9.0+) 或者 apollo.cacheDir=/opt/data/some-cache-dir(1.9.0之前) 启动jar包设置：java -Dapollo.cache-dir=/opt/data/some-cache-dir -jar xxx.jar(1.9.0+) 或者 java -Dapollo.cacheDir=/opt/data/some-cache-dir -jar xxx.jar(1.9.0之前)

（2）动态改变配置环境

在服务运行中，可以自己设定需要读取的配置文件的环境，Environment可以通过以下3种方式的任意一个配置：

1.通过Java System Property：可以通过Java的System Property env来指定环境 在Java程序启动脚本中，可以指定**-Denv=YOUR-ENVIRONMENT** 如果是运行jar文件，需要注意格式是java -Denv=YOUR-ENVIRonMENT -jar xxx.jar 注意key为全小写 通过操作系统的System Environment

2.还可以通过操作系统的System Environment ENV来指定 注意key为全大写

3.最后一个推荐的方式是通过配置文件来指定env=YOUR-ENVIRonMENT 对于Mac/Linux，默认文件位置为/opt/settings/server.properties 对于Windows，默认文件位置为C:optsettingsserver.properties 文件内容格式： env=DEV

apollo 中的所有配置都有从属的 namespace ，而 namespace 有两种类型： public 和 private ，区别 如下：

public: 公共的Namespace的配置能被任何项目读取 通过创建公共Namespace可以实现公共组件的配置，或多个应用共享同一份配置的需求 如果其它应用需要覆盖公共部分的配置，可以在其它应用那里关联公共Namespace，然后在关联的 Namespace里面配置需要覆盖的配置即可 如果其它应用不需要覆盖公共部分的配置，那么就不需要在其它应用那里关联公共Namespace private: 私有Namespace的配置只能被所属的应用获取到 通过创建一个私有的Namespace可以实现分组管理配置 私有Namespace的格式可以是xml、yml、yaml、json、txt. 您可以通过apollo-client中ConfigFile 接口来获取非properties格式Namespace的内容 1.3.0及以上版本的apollo-client针对yaml/yml提供了更好的支持，可以通过 ConfigService.getConfig(“someNamespace.yml”)直接获取Config对象，也可以通过 @EnableApolloConfig(“someNamespace.yml”)或 apollo.bootstrap.namespaces=someNamespace.yml注入yml配置到Spring/SpringBoot中去

1.在应用1中新建一个公共命名空间test-pubic，添加配置public.name = 张三 2.在应用2中关联应用1中的公共命名空间test-public,并覆盖配置修改名字为李四，这时可以看到修改是隔离的只在应用2中生效。

（四）Springboot集成配置