一篇帶給你 Apollo 配置中心詳細(xì)教程
一、簡(jiǎn)介
Apollo(阿波羅)是攜程框架部門(mén)研發(fā)的分布式配置中心，能夠集中化管理應(yīng)用不同環(huán)境、不同集群的配置，配置修改后能夠?qū)崟r(shí)推送到應(yīng)用端，并且具備規(guī)范的權(quán)限、流程治理等特性，適用于微服務(wù)配置管理場(chǎng)景。
服務(wù)端基于Spring Boot和Spring Cloud開(kāi)發(fā)，打包后可以直接運(yùn)行，不需要額外安裝Tomcat等應(yīng)用容器。
Java客戶(hù)端 不依賴(lài)任何框架，能夠運(yùn)行于所有Java運(yùn)行時(shí)環(huán)境，同時(shí)對(duì)Spring/Spring Boot環(huán)境也有較好的支持。
.Net客戶(hù)端 不依賴(lài)任何框架，能夠運(yùn)行于所有.Net運(yùn)行時(shí)環(huán)境。
官方 GitHub： https://github.com/ctripcorp/apollo
官方 Gitee： https://gitee.com/nobodyiam/apollo
二、安裝部署
2.1 環(huán)境準(zhǔn)備
java：JDK 1.8.+
maven： 3.3.9
mysql： 版本要求(5.6.5+)
查看數(shù)據(jù)庫(kù)版本：SHOW VARIABLES WHERE Variable_name = 'version';
Apollo服務(wù)端：1.9+
Apollo客戶(hù)端：1.7+
2.2 安裝包下載
1.源碼下載 從(Apollo-github[1]) 下載最新的源碼，也可以通過(guò) git 命令下載到本地
git clone https://github.com/ctripcorp/apollo
2.下載安裝包 地址：https://github.com/ctripcorp/apollo/releases
注意： 本文中使用的方式為 1.源碼下載，進(jìn)行演示。
2.3 創(chuàng)建數(shù)據(jù)庫(kù)
Apollo 服務(wù)端總共需要兩個(gè)數(shù)據(jù)庫(kù)：ApolloPortalDB和 ApolloConfigDB
我們可以在下載的源碼包里面找到，文件目錄為：apollo\scripts\sql，路徑如下圖所示：
或者通過(guò)下載地址來(lái)獲取SQL
ApolloPortalDB
SQL下載地址：https://github.com/ctripcorp/apollo/tree/master/scripts/sql 導(dǎo)入成功后，驗(yàn)證SQL：select * from `ApolloPortalDB`.`ServerConfig`;
ApolloConfigDB
SQL下載地址：https://github.com/ctripcorp/apollo/tree/master/scripts/sql 導(dǎo)入成功后，驗(yàn)證SQL：select * from `ApolloConfigDB`.`ServerConfig`;
2.4 服務(wù)端配置調(diào)整(可選項(xiàng))
1. ApolloPortalDB庫(kù)配置
操作表：ServerConfig
2. ApolloConfigDB庫(kù)配置
操作表：ServerConfig
2.5 打開(kāi)工程
將下載下來(lái)的 Apollo 源碼導(dǎo)入 idea 中，需要關(guān)注的項(xiàng)目主要是下面這三個(gè)：
我們找到 /apollo/scripts/build.bat的文件(Linux 是 bulid.sh)
修改數(shù)據(jù)庫(kù)配置信息，注意這是兩個(gè)庫(kù)(ApolloPortalDB和 ApolloConfigDB)：
- rem apollo config db info(這個(gè)是ApolloConfigDB庫(kù))
- set pollo_config_db_url="jdbc:mysql://localhost:3306/ApolloConfigDB?serverTimezone=UTC&characterEncoding=utf-8"
- set apollo_config_db_username="root"
- set apollo_config_db_password="123456"
- rem apollo portal db info(這個(gè)是ApolloPortalDB庫(kù))
- set pollo_portal_db_url="jdbc:mysql://localhost:3306/ApolloPortalDB?serverTimezone=UTC&characterEncoding=utf-8"
- set apollo_portal_db_username="root"
- set apollo_portal_db_password="123456"
- rem meta server url, different environments should have different meta server addresses
- rem 配置各環(huán)境meta service地址(configservice部署的地址)
- rem 后面版本也是可以再運(yùn)行時(shí)指定： -apollo.meta=http://192.168.*.*:8080
- set dev_meta="http://localhost:8080"
- set fat_meta="http://someIp:8080"
- set uat_meta="http://anotherIp:8080"
- set pro_meta="http://yetAnotherIp:8080"
注意： 數(shù)據(jù)庫(kù)連接，需要添加serverTimezone=UTC否則可能會(huì)報(bào)錯(cuò)
修改完上面的配置以后，我們就可以執(zhí)行build.bat批處理命令進(jìn)行編譯打包。在windows 運(yùn)行build.bat文件，如果是LInux 運(yùn)行 build.sh
第一次會(huì)執(zhí)行比較慢，需要下載Maven jar
打包成功后，我們找到 apollo-configservice、apollo-adminservice、apollo-portal下target 目錄，找到已經(jīng)打好的三個(gè)jar包，copy 出來(lái)放到一個(gè)單獨(dú)的目錄，方便我們啟動(dòng)。
如下圖所示：
啟動(dòng)順序?yàn)椋篴pollo-configservice > apollo-adminservice > apollo-portal三個(gè)服務(wù)。
啟動(dòng)腳本，放到記事本，修改后綴名為 .bat就可以一鍵啟動(dòng)三個(gè)服務(wù)了。
- @echo off
- start cmd /c "java -jar apollo-configservice-1.10.0-SNAPSHOT.jar"
- start cmd /c "java -jar apollo-adminservice-1.10.0-SNAPSHOT.jar"
- start cmd /c "java -jar apollo-portal-1.10.0-SNAPSHOT.jar"
- spause // 防止運(yùn)行完畢后直接關(guān)閉界面
全部啟動(dòng)成功之后，打開(kāi)瀏覽器輸入：http://localhost:8070/，看到 Apollo 登錄頁(yè)面說(shuō)明啟動(dòng)成功。
用戶(hù)名密碼： apollo/admin
輸入 http://localhost:8080 ，如果出現(xiàn)eureka 的管理界面，說(shuō)明服務(wù)啟動(dòng)正常。
三、客戶(hù)端使用
客戶(hù)端使用指南[2]
3.1 導(dǎo)入jar包
- <dependency>
- <groupId>com.ctrip.framework.apollo</groupId>
- <artifactId>apollo-client</artifactId>
- <version>1.7.0</version>
- </dependency>
- 數(shù)據(jù)庫(kù)jar-->
- <dependency>
- <groupId>mysql</groupId>
- <artifactId>mysql-connector-java</artifactId>
- <scope>runtime</scope>
- </dependency>
- <dependency>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-data-jpa</artifactId>
- <version>1.5.9.RELEASE</version>
- </dependency>
3.2 發(fā)布配置
創(chuàng)建應(yīng)用
1.AppId：001
2.AppId：mxn-front-gateway
AppId是應(yīng)用的身份信息，是從服務(wù)端獲取配置的一個(gè)重要信息。
AppId：001的配置內(nèi)容
AppId：mxn-front-gateway的配置內(nèi)容
上面的兩張圖，就是我們Apollo配置中心的詳細(xì)配置頁(yè)面
- 在頁(yè)面左上方的環(huán)境列表模塊展示了所有的環(huán)境和集群，用戶(hù)可以自由切換。
- 頁(yè)面中央展示了兩個(gè)namespace 的配置信息，默認(rèn)按照表格模式展示、編輯。用戶(hù)也可以切換到文本模式，以文件形式查看、編輯。
- 頁(yè)面上可以方便地進(jìn)行發(fā)布、回滾、灰度、授權(quán)、查看更改歷史和發(fā)布?xì)v史等操作
3.3 操作配置項(xiàng)
輸入配置內(nèi)容
3.4 發(fā)布配置
添加發(fā)布信息
四、Spring Boot 集成 Apollo
在Spring Boot中使用 apollo 配置比較方便，我們只需要在對(duì)應(yīng)的配置(yml或者properties)中設(shè)置 apollo的(appid和meta)以及命名空間就行。
application.yml 配置
- app:
- id: 001
- apollo:
- meta: http://localhost:8080
- bootstrap:
- enabled: true
- namespaces: dev.yml,test.properties
Spring Boot 啟動(dòng)類(lèi)，添加 @EnableApolloConfig
- @SpringBootApplication
- @EnableApolloConfig
- public class ApolloMxnApplication {
- public static void main(String[] args) {
- SpringApplication.run(ApolloMxnApplication.class, args);
- }
- }
測(cè)試類(lèi)，實(shí)時(shí)獲取配置信息
- import org.springframework.beans.factory.annotation.Value;
- import org.springframework.web.bind.annotation.RequestMapping;
- import org.springframework.web.bind.annotation.RestController;
- /**
- * @program: apollo-mxn
- * @ClassName TestController
- * @description:
- * @author: lyy
- * @create: 2021-09-15 17:45
- * @Version 1.0
- **/
- @RestController
- public class TestController {
- @Value(value = "${mxn.name}")
- private String name;
- @RequestMapping("test")
- public String test(){
- return "hello world "+name;
- }
- }
這樣我們就可以 從 meta 中 拉取兩個(gè)命名空間(apollo-adminservice和apollo-configservice)的配置了Apollo
五、實(shí)現(xiàn)配置熱加載
創(chuàng)建配置熱加載實(shí)現(xiàn)類(lèi)
- import com.ctrip.framework.apollo.core.ConfigConsts;
- import com.ctrip.framework.apollo.model.ConfigChangeEvent;
- import com.ctrip.framework.apollo.spring.annotation.ApolloConfigChangeListener;
- import lombok.extern.slf4j.Slf4j;
- import org.springframework.beans.factory.annotation.Autowired;
- import org.springframework.boot.autoconfigure.jdbc.DataSourceProperties;
- import org.springframework.boot.context.properties.EnableConfigurationProperties;
- import org.springframework.cloud.context.config.annotation.RefreshScope;
- import org.springframework.context.ApplicationContext;
- import org.springframework.context.annotation.Bean;
- import org.springframework.context.annotation.Configuration;
- import javax.sql.DataSource;
- /**
- * @program: apollo-mxn
- * @ClassName DataSourceConfig
- * @description: 實(shí)現(xiàn)配置信息熱加載
- * @author: lyy
- * @create: 2021-09-15 16:41
- * @Version 1.0
- **/
- @Configuration
- @EnableConfigurationProperties(DataSourceProperties.class)
- @Slf4j
- public class ConfigHotLoad {
- @RefreshScope
- @Bean("dataSource_Bean")
- public DataSource dataSource(DataSourceProperties dataSourceProperties){
- return dataSourceProperties.initializeDataSourceBuilder().build();
- }
- @Autowired
- private ApplicationContext applicationContext;
- @Autowired
- private org.springframework.cloud.context.scope.refresh.RefreshScope refreshScope;
- /** @Author lyy
- * @Description //TODO 監(jiān)聽(tīng)apollo 的配置變更
- * @Date 16:50 2021/9/15
- * @Param
- * @return
- **/
- @ApolloConfigChangeListener(value = {ConfigConsts.NAMESPACE_APPLICATION,"dev"},interestedKeyPrefixes = {"spring.datasource"})
- public void onChange(ConfigChangeEvent configChangeEvent){
- // 重新編譯DataSource 初始化bean
- refreshScope.refresh("dataSource_Bean");
- log.info("Apollo config changed {}",applicationContext.getBean(DataSourceProperties.class).toString());
- }
- }
我們 輸入地址 http://localhost:你的端口/test[3] 就可以看到，對(duì)應(yīng)的配置名字，然后修改apollo里面的信息，發(fā)布后，再不啟動(dòng)項(xiàng)目的情況下，就可以更新我們的配置信息了
Apollo 本地緩存
Linux：/opt/data/{appId}/config-cache Windows：C:\opt\data{appId}\config-cache
六、什么是 Apollo
官方案例： 使用案例Demo可以參考Apollo使用場(chǎng)景和示例代碼[4]。
6.1 誕生背景
隨著程序功能的日益復(fù)雜，程序的配置日益增多：各種功能的開(kāi)關(guān)、參數(shù)的配置、服務(wù)器的地址……
對(duì)程序配置的期望值也越來(lái)越高：配置修改后實(shí)時(shí)生效，灰度發(fā)布，分環(huán)境、分集群管理配置，完善的權(quán)限、審核機(jī)制……
在這樣的大環(huán)境下，傳統(tǒng)的通過(guò)配置文件、數(shù)據(jù)庫(kù)等方式已經(jīng)越來(lái)越無(wú)法滿(mǎn)足開(kāi)發(fā)人員對(duì)配置管理的需求。
Apollo配置中心應(yīng)運(yùn)而生!
6.2 Apollo 說(shuō)明
Apollo(阿波羅)是攜程框架部門(mén)研發(fā)的開(kāi)源配置管理中心，能夠集中化管理應(yīng)用不同環(huán)境、不同集群的配置，配置修改后能夠?qū)崟r(shí)推送到應(yīng)用端，并且具備規(guī)范的權(quán)限、流程治理等特性。
Apollo支持4個(gè)維度管理Key-Value格式的配置：
1.application (應(yīng)用)
2.environment (環(huán)境)
3.cluster (集群)
4.namespace (命名空間)
同時(shí)，Apollo基于開(kāi)源模式開(kāi)發(fā)，開(kāi)源地址：https://github.com/ctripcorp/apollo
6.3 基礎(chǔ)模型
Apollo的基礎(chǔ)模型：
1.用戶(hù)在配置中心對(duì)配置進(jìn)行修改并發(fā)布
2.配置中心通知Apollo客戶(hù)端有配置更新
3.Apollo客戶(hù)端從配置中心拉取最新的配置、更新本地配置并通知到應(yīng)用
七、Apollo特性
由于配置的特殊性，所以Apollo 從開(kāi)始設(shè)計(jì)到完善就立志作為一個(gè)有治理能力的配置中心平臺(tái)，Apollo的特性主要體現(xiàn)在以下幾個(gè)方面
- 統(tǒng)一配置的配置管理
1.Apollo提供了一個(gè)統(tǒng)一界面集中式管理不同環(huán)境(environment)、不同集群(cluster)、不同命名空間(namespace)的配置。
2.同一份代碼部署在不同的集群，可以有不同的配置，比如zookeeper的地址等
3.通過(guò)命名空間(namespace)可以很方便地支持多個(gè)不同應(yīng)用共享同一份配置，同時(shí)還允許應(yīng)用對(duì)共享的配置進(jìn)行覆蓋
- 配置修改實(shí)時(shí)生效(熱發(fā)布)
1.用戶(hù)在Apollo修改完配置并發(fā)布后，客戶(hù)端能實(shí)時(shí)(1秒)接收到最新的配置，并通知到應(yīng)用程序
- 版本發(fā)布管理
1.所有的配置發(fā)布都有版本概念，從而可以方便地支持配置的回滾
- 灰度發(fā)布
1.支持配置的灰度發(fā)布，比如點(diǎn)了發(fā)布后，只對(duì)部分應(yīng)用實(shí)例生效，等觀察一段時(shí)間沒(méi)問(wèn)題后再推給所有應(yīng)用實(shí)例
- 權(quán)限管理、發(fā)布審核、操作審計(jì)
1.應(yīng)用和配置的管理都有完善的權(quán)限管理機(jī)制，對(duì)配置的管理還分為了編輯和發(fā)布兩個(gè)環(huán)節(jié)，從而減少人為的錯(cuò)誤。
2.所有的操作都有審計(jì)日志，可以方便地追蹤問(wèn)題
- 客戶(hù)端配置信息監(jiān)控
1.可以在界面上方便地看到配置在被哪些實(shí)例使用
- 提供Java和.Net原生客戶(hù)端
1.提供了Java和.Net的原生客戶(hù)端，方便應(yīng)用集成
2.支持Spring Placeholder, Annotation和Spring Boot的ConfigurationProperties，方便應(yīng)用使用(需要Spring 3.1.1+)
3.同時(shí)提供了Http接口，非Java和.Net應(yīng)用也可以方便地使用
- 提供開(kāi)放平臺(tái)API
1.Apollo自身提供了比較完善的統(tǒng)一配置管理界面，支持多環(huán)境、多數(shù)據(jù)中心配置管理、權(quán)限、流程治理等特性。不過(guò)Apollo出于通用性考慮，不會(huì)對(duì)配置的修改做過(guò)多限制，只要符合基本的格式就能保存，不會(huì)針對(duì)不同的配置值進(jìn)行針對(duì)性的校驗(yàn)，如數(shù)據(jù)庫(kù)用戶(hù)名、密碼，Redis服務(wù)地址等
2.對(duì)于這類(lèi)應(yīng)用配置，Apollo支持應(yīng)用方通過(guò)開(kāi)放平臺(tái)API在Apollo進(jìn)行配置的修改 和發(fā)布，并且具備完善的授權(quán)和權(quán)限控制
- 部署簡(jiǎn)單
1.配置中心作為基礎(chǔ)服務(wù)，可用性要求非常高，這就要求Apollo對(duì)外部依賴(lài)盡可能地少
2.目前唯一的外部依賴(lài)是MySQL，所以部署非常簡(jiǎn)單，只要安裝好Java和MySQL就可以讓Apollo跑起來(lái)
3.Apollo還提供了打包腳本，一鍵就可以生成所有需要的安裝包，并且支持自定義運(yùn)行時(shí)參數(shù)
八、Apollo原理
上圖簡(jiǎn)要描述了Apollo客戶(hù)端的實(shí)現(xiàn)原理：
1.客戶(hù)端和服務(wù)端保持了一個(gè)長(zhǎng)連接，從而能第一時(shí)間獲得配置更新的推送。
2.客戶(hù)端還會(huì)定時(shí)從Apollo配置中心服務(wù)端拉取應(yīng)用的最新配置。
- 這是一個(gè)fallback機(jī)制，為了防止推送機(jī)制失效導(dǎo)致配置不更新
- 客戶(hù)端定時(shí)拉取會(huì)上報(bào)本地版本，所以一般情況下，對(duì)于定時(shí)拉取的操作，服務(wù)端都會(huì)返回304 - Not Modified
- 定時(shí)頻率默認(rèn)為每5分鐘拉取一次，客戶(hù)端也可以通過(guò)在運(yùn)行時(shí)指定System >Property: apollo.refreshInterval來(lái)覆蓋，單位為分鐘。
3.客戶(hù)端從Apollo配置中心服務(wù)端獲取到應(yīng)用的最新配置后，會(huì)保存在內(nèi)存中
4.客戶(hù)端會(huì)把從服務(wù)端獲取到的配置在本地文件系統(tǒng)緩存一份
- 在遇到服務(wù)不可用，或網(wǎng)絡(luò)不通的時(shí)候，依然能從本地恢復(fù)配置
5.應(yīng)用程序從Apollo客戶(hù)端獲取最新的配置、訂閱配置更新通知
九、自定義Cluster
9.1 新建Cluster
點(diǎn)擊后就進(jìn)入到集群添加頁(yè)面，一般情況下可以按照數(shù)據(jù)中心來(lái)劃分集群 不過(guò)也支持自定義集群，比如可以為A機(jī)房的某一臺(tái)機(jī)器和B機(jī)房的某一臺(tái)機(jī)創(chuàng)建一個(gè)集群，使用一套配置。
Apollo會(huì)默認(rèn)使用應(yīng)用實(shí)例所在的數(shù)據(jù)中心作為cluster，所以如果兩者一致的話(huà)，不需要額外配置。
如果cluster和數(shù)據(jù)中心不一致的話(huà)，那么就需要通過(guò)System Property方式來(lái)指定運(yùn)行時(shí)cluster：
- -Dapollo.cluster=SomeCluster
- 這里注意apollo.cluster為全小寫(xiě)
十、配置獲取規(guī)則
在有了cluster概念后，配置的規(guī)則就顯得重要了。比如應(yīng)用部署在A機(jī)房，但是并沒(méi)有在Apollo新建cluster，這個(gè)時(shí)候Apollo的行為是怎樣的?或者在運(yùn)行時(shí)指定了cluster=SomeCluster，但是并沒(méi)有在Apollo新建cluster，這個(gè)時(shí)候Apollo的行為是怎樣的?
10.1 應(yīng)用自身配置的獲取規(guī)則
當(dāng)應(yīng)用使用下面的語(yǔ)句獲取配置時(shí)，我們稱(chēng)之為獲取應(yīng)用自身的配置，也就是應(yīng)用自身的application namespace的配置。
Config config = ConfigService.getAppConfig();
對(duì)這種情況的配置獲取規(guī)則，簡(jiǎn)而言之如下：
1.首先查找運(yùn)行時(shí)cluster的配置(通過(guò)apollo.cluster指定)
2.如果沒(méi)有找到，則查找數(shù)據(jù)中心cluster的配置
3.如果還是沒(méi)有找到，則返回默認(rèn)cluster的配置
圖示如下：
所以如果應(yīng)用部署在A數(shù)據(jù)中心，但是用戶(hù)沒(méi)有在Apollo創(chuàng)建cluster，那么獲取的配置就是默認(rèn)cluster(default)的。
如果應(yīng)用部署在A數(shù)據(jù)中心，同時(shí)在運(yùn)行時(shí)指定了SomeCluster，但是沒(méi)有在Apollo創(chuàng)建cluster，那么獲取的配置就是A數(shù)據(jù)中心cluster的配置，如果A數(shù)據(jù)中心cluster沒(méi)有配置的話(huà)，那么獲取的配置就是默認(rèn)cluster(default)的。
十一、總體設(shè)計(jì)
上圖簡(jiǎn)要描述了Apollo的總體設(shè)計(jì)，我們可以從下往上看：
- Config Service提供配置的讀取、推送等功能，服務(wù)對(duì)象是Apollo客戶(hù)端
- Admin Service提供配置的修改、發(fā)布等功能，服務(wù)對(duì)象是Apollo Portal(管理界面)
- Config Service和Admin Service都是多實(shí)例、無(wú)狀態(tài)部署，所以需要將自己注冊(cè)到Eureka中并保持心跳
- 在Eureka之上我們架了一層Meta Server用于封裝Eureka的服務(wù)發(fā)現(xiàn)接口
- Client通過(guò)域名訪問(wèn)Meta Server獲取Config Service服務(wù)列表(IP+Port)，而后直接通過(guò)IP+Port訪問(wèn)服務(wù)，同時(shí)在Client側(cè)會(huì)做load balance、錯(cuò)誤重試
- Portal通過(guò)域名訪問(wèn)Meta Server獲取Admin Service服務(wù)列表(IP+Port)，而后直接通過(guò)IP+Port訪問(wèn)服務(wù)，同時(shí)在Portal側(cè)會(huì)做load balance、錯(cuò)誤重試
- 為了簡(jiǎn)化部署，我們實(shí)際上會(huì)把Config Service、Eureka和Meta Server三個(gè)邏輯角色部署在同一個(gè)JVM進(jìn)程中
十二、總結(jié)
到這里Apollo，就講解完了，其實(shí)Apollo 可以理解成一個(gè)好用的配置管理中心，這里小農(nóng)也是了解了一點(diǎn)皮毛，大家有不懂的地方，歡迎留言。
我是牧小農(nóng)，怕什么真理無(wú)窮，進(jìn)一步有進(jìn)一步的歡喜，大家加油~
