思維導圖

文章已收錄Github精選，歡迎Star：https://github.com/yehongzhi/learningSummary

一、概述

Apollo（阿波羅）是攜程框架部門研發的開源配置管理中心，能夠集中化管理應用不同環境、不同集群的配置，配置修改后能夠實時推送到應用端，并且具備規范的權限、流程治理等特性。

目前Apollo在github有22.6k顆星，在官網登記的使用的公司有451家，算是很流行的配置中心的框架技術。所以接下來跟著我一起學習Apollo配置中心吧。

二、為什么使用配置中心

首先，沒有配置中心之前傳統的配置都是寫在配置文件中，比如各種yml、perproties、xml文件。

寫在各種文件里最大的問題在于如果需要改配置信息，需要重新部署發布應用才能生效，這是第一個問題。

后面為了做到動態讀取配置信息，后面有人改進一下把配置信息存儲在數據庫的一張表，程序讀取表中的配置信息，這種方式很多公司都還在使用，因為簡單，而且靈活(修改配置只需要執行個SQL語句，不需要重新部署發布)。但是也不是最完美的，因為缺少了權限控制，沒有管理界面進行統一配置，沒有歷史版本的配置信息，不支持回滾(防止誤操作)。

實際上配置中心在市面上已經有很多，比如Nacos、Consul、spring-cloud-config、Apollo等等。

相對其他的，我覺得選擇Apollo的原因是，界面比較美觀，操作簡便，部署簡單，依賴較少，開箱即用。

三、安裝部署

首先要講一下Apollo部署三個服務apollo-configservice，apollo-adminservice，apollo-portal，后面我講架構設計時會講一下這三個服務是用來干嘛的。

這里部署建議不要用官網的Quick Start，我一開始使用QuickStart的方式，搞了幾個鐘頭搞不定，總是在Eureka上多了一個UNKONWN的服務，然后又無法訪問8070的管理界面，心態直接崩潰。上github找了一下，如下：

作者在下面的回答是這樣的。

這個問題發現不止有一個issue(#2931)反映了，但是沒有解決，作者建議使用標準部署。

所以接下來就講標準部署，也就是分布式部署，有耐心的同學也可以直接去github看作者寫的分布式部署指南。

先介紹一下環境依賴，linux服務器(建議centos7)，MySQL(版本要求:5.6.5+)，部署的服務器需要安裝JDK環境(JAVA 1.8+)。

這里有兩種安裝方式，一種是下載安裝包，另一種是通過源碼構建。一般如果不需要對Apollo定制開發，直接用安裝包部署即可。我這里演示的就是安裝包部署的方式。

3.1 獲取安裝包

先到官網下載安裝包。

下載后解壓，如下：

3.2 創建數據庫

使用MySQL數據庫(版本要求:5.6.5+)。

3.2.1 創建ApolloPortalDB數據庫

使用github上面的sql腳本創建ApolloPortalDB數據庫，導入相關的表以及數據。

3.2.2 創建ApolloConfigDB數據庫

使用github上面的sql腳本創建ApolloConfigDB數據庫，導入相關的表以及數據。

3.3 修改配置

需要改一下數據庫連接信息，路徑在/config下。

3.3.1 apollo-configservice配置

修改apollo-configservice的數據庫連接信息Application-github.properties，如下：

# DataSource
spring.datasource.url = jdbc:mysql://192.168.0.107:3306/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = 賬號
spring.datasource.password = 密碼

3.3.2 apollo-adminservice配置

修改apollo-adminservice的數據庫連接信息application-github.properties，如下：

# DataSource
spring.datasource.url = jdbc:mysql://192.168.0.107:3306/ApolloConfigDB?characterEncoding=utf8
spring.datasource.username = 賬號
spring.datasource.password = 密碼

3.3.3 apollo-portal配置

修改apollo-portal的數據庫連接信息application-github.properties，如下：

# DataSource
spring.datasource.url = jdbc:mysql://192.168.0.107:3306/ApolloPortalDB?characterEncoding=utf8
spring.datasource.username = 賬號
spring.datasource.password = 密碼

再修改apollo-env.properties配置，這是關于環境配置的，如下：

local.meta=http://localhost:8080
## 開發環境
dev.meta=http://192.168.0.107:8080
## 不需要配置的環境參考${lpt_meta}配置
fat.meta=${fat_meta}
uat.meta=${uat_meta}
lpt.meta=${lpt_meta}
pro.meta=${pro_meta}

3.4 部署

然后把三個文件夾都上傳到Linux服務器。

3.4.1 部署發布apollo-configservice

部署發布服務有順序，首先發布apollo-configservice，直接執行scripts/startup.sh。

有可能會出現這個錯誤(我就出現了)，不用擔心，實際上進程還沒有結束，還在啟動，我們可以到日志記錄的文件夾(下圖來源于startup.sh腳本)查看日志。

啟動時間比較長，因為這個服務包括啟動Eureka注冊中心，需要耐心等待。觀察apollo-configservice.log文件，當看到如下信息后，表示啟動成功。

Eureka注冊中心啟動成功，可以打開http://192.168.0.107:8080/查看：

3.4.2 部署發布apollo-adminservice

接著發布apollo-adminservice，直接執行scripts/startup.sh。查看日志的方式跟上面一樣。啟動成功后，可以看到Eureka的服務列表中多了一個服務。

3.4.3 部署發布apollo-portal

接著發布apollo-portal，直接執行scripts/startup.sh。portal是提供Web界面的服務，所以啟動成功后，可以打開http://192.168.0.107:8070/登錄web界面，默認賬號密碼是apollo/admin。

到此，安裝就完成了！

四、SpringBoot整合Apollo

接下來，整一個Demo(相當于java客戶端)，使用SpringBoot整合Apollo，實現動態讀取配置。

4.1 Mave依賴

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

4.2 AppId

在classpath路徑下，創建/META-INF/app.properties文件。如下：

# 應用的唯一標識，后面創建工程需要用到
app.id=apollo-demo

4.3 Apollo Meta Server

其實就是配置Apollo服務器的地址。官網提供的方式有很多，我這里選其中一種比較簡單的方式。在classpath路徑下創建apollo-env.properties文件，配置如下：

dev.meta=http://192.168.0.107:8080
# fat.meta=http://apollo.fat.xxx.com
# uat.meta=http://apollo.uat.xxx.com
# pro.meta=http://apollo.xxx.com

4.4 Environment

其實是配置環境，因為上面可以配置四種環境，這里配置具體選擇哪個環境。這里介紹兩種方式：

第一種通過Java System Property。

第二種通過配置文件。

到相對應的路徑下創建server.properties，配置如下：

env=DEV

4.5 @EnableApolloConfig

在啟動類上加上注解@EnableApolloConfig。

@SpringBootApplication
//開啟apollo配置
@EnableApolloConfig
public class ApolloDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(ApolloDemoApplication.class, args);
    }
}

4.6 測試類

這樣就完成了，接下來再創建一個Controller進行測試一下。

@RestController
public class ApolloController {

    //冒號后面的是默認值
    @Value("${configValue:default}")
    private String configValue;

    @RequestMapping("/apollo/getConfig")
    public String getConfig() {
        return configValue;
    }
}

4.7 管理界面創建對應的配置

第一步，創建項目。

第二步，創建配置。

第三步，發布。

4.8 測試

啟動項目apollo-demo，然后請求路徑http://localhost:8888/apollo/getConfig，可以看到：

控制臺可以看到推送配置信息的日志：

五、架構設計

講完了安裝和SpringBoot整合的demo后，我們是時候探究一下原理，為什么要有三個服務，又是如何做到配置信息發布后，客戶端實時獲取到最新的配置的。繼續往下看。

首先看一張官網的架構設計圖。

5.1 基礎模型

作者在官網上有個基礎模型的架構圖，忽略掉很多細節后實際上非常簡單：

用戶在配置中心對配置進行修改并發布。
配置中心通知Apollo客戶端有配置更新。
Apollo客戶端從配置中心拉取最新的配置、更新本地配置并通知到應用。

5.2 架構模塊

如果我們把Apollo配置中心服務端展開的話，架構圖如下：

看到這里，整個架構看起來就比較清晰了。接下來從上往下簡單介紹一下：

Portal服務：提供Web界面供用戶管理配置，通過MetaServer獲取AdminService服務列表（IP+Port），通過IP+Port訪問AdminService服務。

Client：實際上就是我們創建的SpringBoot項目，引入ApolloClient的maven依賴，為應用提供配置獲取、實時更新等功能。

Meta Server：從Eureka獲取Config Service和Admin Service的服務信息，相當于是一個Eureka Client。主要是為了封裝服務發現的細節，對Portal和Client而言，永遠通過一個Http接口獲取Admin Service和Config Service的服務信息，而不需要關心背后實際的服務注冊和發現組件。Meta Server只是一個邏輯角色，在部署時和Config Service是在一個JVM進程中的，所以IP、端口和Config Service一致。

Eureka：注冊中心。Config Service和Admin Service會向Eureka注冊服務。為了簡單起見，目前Eureka在部署時和Config Service是在一個JVM進程中的。

Config Service：提供配置獲取接口。提供配置更新推送接口(基于Http long polling)。服務對象為Apollo客戶端(Client)。

Admin Service：提供配置管理接口。提供配置發布、修改等接口。服務對象為Portal。

5.3 配置發布后的實時推送設計

上面講完各個角色的用途，那這些角色是怎么配合一起工作的呢，我們來看一張圖：

上圖簡要描述了配置發布的大致過程：

用戶在Portal操作配置發布。
Portal調用Admin Service的接口操作發布。
Admin Service發布配置后，發送ReleaseMessage給各個Config Service。
Config Service收到ReleaseMessage后，通知對應的客戶端(Client)。

關鍵點在于AdminService發送ReleaseMessage給ConfigService，這一步是如何異步發送的呢，一般異步發送我們很容易想到消息隊列，但是實際上我們在安裝部署時并沒有使用到消息隊列。

答案在于：

Admin Service在配置發布后會往ReleaseMessage表插入一條消息記錄，消息內容就是配置發布的AppId+Cluster+Namespace。
然后Config Service有一個線程會每秒掃描一次ReleaseMessage表，看看是否有新的消息記錄。
Config Service如果發現有新的消息記錄，那么就會通知到所有的消息監聽器，監聽器得到配置發布的AppId+Cluster+Namespace后，會通知對應的客戶端。