（30）ASP.NET Core3.1 整合Apollo快速安裝與使用
1.介紹
Apollo（阿波羅）是攜程框架部研發並開源的一款生產級的配置中心產品，它能夠集中管理應用在不同環境、不同叢集的配置，配置修改後能夠實時推送到應用端，並且具備規範的許可權、流程治理等特性，適用於微服務配置管理場景。
2.架構和模組
下面是Apollo架構模組圖（來源自於波波微課）：
上圖簡要描述了Apollo的總體設計，我們可以從下往上看：
●Config Service提供配置的讀取、推送等功能，服務物件是Apollo客戶端。
●Admin Service提供配置的修改、釋出等功能，服務物件是Apollo Portal（管理介面）。
●Config Service和Admin Service都是多例項、無狀態部署，所以需要將自己註冊到Eureka中並保持心跳。
●Client通過域名訪問Meta Server獲取Config Service服務列表（IP+Port），而後直接通過IP+Port訪問服務，同時在Client側會做load balance、錯誤重試。
●Portal通過域名訪問Meta Server獲取Admin Service服務列表（IP+Port），而後直接通過IP+Port訪問服務，同時在Portal側會做load balance、錯誤重試。
●為了簡化部署，我們實際上會把Config Service、Eureka和Meta Server三個邏輯角色部署在同一個JVM程序中。
2.1使用者在配置釋出後的實時推送設計
在配置中心中，一個重要的功能就是配置釋出後實時推送到客戶端。下面我們簡要看一下這塊是怎麼設計實現的：
●使用者在Portal操作配置釋出。
●Portal呼叫Admin Service的介面操作釋出。
●Admin Service釋出配置後，傳送ReleaseMessage給各個Config Service。
●Config Service收到ReleaseMessage後，通知對應的客戶端。
2.2Apollo客戶端的實現原理
●客戶端和服務端保持了一個長連線，從而能第一時間獲得配置更新的推送（通過Http Long Polling實現）。
●客戶端還會定時從Apollo配置中心服務端拉取應用的最新配置。
○客戶端定時拉取會上報本地版本，所以一般情況下，對於定時拉取的操作，服務端都會返回304 - Not Modified。
○定時頻率預設為每5分鐘拉取一次，客戶端也可以通過在執行時指定System Property: apollo.refreshInterval來覆蓋，單位為分鐘。
●客戶端從Apollo配置中心服務端獲取到應用的最新配置後，會儲存在記憶體中。
●客戶端會把從服務端獲取到的配置在本地檔案系統快取一份。
○在遇到服務不可用，或網路不通的時候，依然能從本地恢復配置，不影響應用正常執行。本地快取路徑位於C:\opt\data\{appId}\config-cache，所以請確保C:\opt\data\目錄存在，且應用有讀寫許可權。
●應用程式可以從Apollo客戶端獲取最新的配置、訂閱配置更新通知。
2.3環境配置（Environment）
Apollo支援應用在不同的環境有不同的配置，所以Environment是另一個從伺服器獲取配置的重要資訊。Environment通過配置檔案來指定，檔案位置為C:\opt\settings\server.properties，檔案內容形如：
env=DEV
目前，env支援以下幾個值（大小寫不敏感）：
●DEV：Development environment
●FAT：Feature Acceptance Test environment
●UAT：User Acceptance Test environment
●PRO：Production environment
3.Apollo在Windows上快速啟動
3.1準備工作
3.1.1 Java jdk
●Apollo服務端：1.8+
●Apollo客戶端：1.7+
Java jdk1.8下載地址：https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html，這裡提醒一下，安裝目錄名稱千萬別有空格，不然會Apollo啟動時候會報錯的。
在配置好後，可以通過如下命令檢查：
java -version
配置下環境變數：
3.1.2MySQL
●版本要求：5.6.5+（MySQL服務端安裝我就不說了，自行百度）
Apollo的表結構對timestamp使用了多個default宣告，所以需要5.6.5以上版本。
連線上MySQL後，可以通過如下命令檢查：
SHOW VARIABLES WHERE Variable_name = 'version';
3.1.3下載快速啟動安裝包
下載Apollo安裝包，大家只需要下載到本地，就可以直接使用，免去了編譯、打包過程。
●Github下載：https://github.com/nobodyiam/apollo-build-scripts
●百度網盤下載：https://pan.baidu.com/share/init?surl=Ieelw6y3adECgktO0ea0Gg，提取碼: 9wwe
安裝包要58M這麼大，是因為這是一個可以自啟動的jar包，裡面包含了所有依賴jar包以及一個內建的tomcat容器。解壓Apollo安裝包後會看到如下檔案：
3.2安裝步驟
3.2.1建立資料庫
Apollo服務端共需要兩個資料庫：ApolloPortalDB和ApolloConfigDB，我們把資料庫、表的建立和樣例資料都分別準備了sql檔案，只需要匯入資料庫即可。
● 建立ApolloPortalDB：通過各種MySQL客戶端匯入sql/apolloportaldb.sql即可。
下面以MySQL原生客戶端為例：
source /your_local_path/sql/apolloportaldb.sql
● 建立ApolloConfigDB：通過各種MySQL客戶端匯入sql/apolloconfigdb.sql即可。
下面以MySQL原生客戶端為例：
source /your_local_path/sql/apolloconfigdb.sql
3.2.2配置資料庫連線資訊
Apollo服務端需要知道如何連線到你前面建立的資料庫，所以需要編輯Apollo目錄中的demo.sh，修改ApolloPortalDB和ApolloConfigDB相關的資料庫連線串資訊：
# apollo config db info apollo_config_db_url=jdbc:mysql://172.168.16.xxx:5621/ApolloConfigDB?characterEncoding=utf8 apollo_config_db_username=使用者名稱 apollo_config_db_password=密碼 # apollo portal db info apollo_portal_db_url=jdbc:mysql://172.168.16.xxx:5621/ApolloPortalDB?characterEncoding=utf8 apollo_portal_db_username=使用者名稱 apollo_portal_db_password=密碼
3.3啟動Apollo配置中心
快速啟動指令碼會在本地啟動3個服務，分別使用8070, 8080, 8090埠，請確保這3個埠當前沒有被使用。
●在Linux/Mac下，可以通過如下命令檢查：
lsof -i:8080
●在Window下，可以通過如下命令檢查：
netstat -aon|findstr 8080
先切換到Apollo目錄：
cd D:\StudyDocuments\technology\Apollo\apollo-build-scripts-master
然後執行啟動指令碼：
./demo.sh start
因為我是在本機部署Apollo服務端的，所以直接開啟http://localhost:8070即可：
預設管理員使用者名稱：apollo，密碼：admin，輸入即可登入成功！而Eureka預設埠是8080，即開啟http://localhost:8080/即可：
阿波羅如何建立修改使用者密碼、建立使用者、部門，分配許可權等等操作，我就不說了，大夥可以自行百度或者去官網瞭解，這不在本文範疇之內。
4.ASP.NET Core整合Apollo快速開發
4.1Apollo環境配置
Apollo預設有兩個組織部門，可以通過登入後管理員工具-系統引數，輸入key值organizations新增修改。返回主介面點選建立專案後，根據自身專案輸入相關專案資訊，我這邊demo專案資訊如下：
建立專案後，點選進去可能會報如下錯誤提示：
這種錯誤一般是資料庫Eureka服務配置引數不正確導致的！因為我是本地部署Apollo服務端的，IIS已經存在一個站點佔用了Eureka服務預設埠8080，所以停掉站點後，輸入demo.sh stop-demo.sh start重新啟動下Apollo即可。重新啟動Apollo後可能還會提示如下資訊：
因為專案缺少環境namespaces配置，點選左側“新增Namespace”選項新增一個dev開發環境namespaces：
namespaces建立後新增AspNetCore.Apollo.Test.WebApi專案開發環境配置：
上述配置相當於Core專案appsettings.json中以下配置：
然後點擊發布即可。
4.2ASP.NET Core整合Apollo
通過Github上https://github.com/ctripcorp/apollo.net原始碼可以瞭解到，示例AspNetCore.Apollo.Test.WebApi應用可以通過appsettings.json檔案可以新增Apollo環境配置資訊：
{
"apollo": {
"AppId": "AspNetCore.Apollo.Test.WebApi",
//"Cluster": "test",////沒有叢集，暫時隱藏
"MetaServer": "http://localhost:8080/",
//"Secret": "ffd9d01130ee4329875ac3441c0bedda",////沒有ids4接入，暫時隱藏
//"Namespaces": [ "application.xml", "application.json", "application.yml", "application.yaml", "application" ],////沒有Namespace陣列，暫時隱藏
"Namespace": "dev",
"Env": "Dev",
"Meta": {
"DEV": "http://localhost:8080/"
//"FAT": "http://106.54.227.205:8080/",
//"UAT": "http://106.54.227.205:8080/",
//"PRO": "http://106.54.227.205:8080/"
////示例暫時只有開發環境
}
}
}
然後在Program主程式入口引用Com.Ctrip.Framework.Apollo.Configuration Nuget包，新增Apollo環境配置資訊，新增Namespace名稱，具體配置程式碼如下：
.ConfigureAppConfiguration(builder =>
{
var iConfigurationRoot = builder.Build();
var apolloInfo = iConfigurationRoot.GetSection("apollo");
var namespaceName = iConfigurationRoot.GetSection("apollo").GetSection("Namespace").Value;
builder.AddApollo(apolloInfo).AddNamespace(namespaceName);
})
然後執行示例AspNetCore.Apollo.Test.WebApi應用，會看到如下除錯資訊：
從上述除錯資訊可以看到Apollo在ASP.NET Core整合成功！
參考文獻：
Apollo
Apollo Quick-Start
Apollo配置中心設計
微服務架構~攜程Apollo配置中心架構剖析
.Net客戶端使用指南