（30）ASP.NET Core3.1 集成Apollo快速安裝與使用

1.介紹

Apollo（阿波羅）是攜程框架部研發並開源的一款生產級的配置中心產品，它可以集中管理應用在不一樣環境、不一樣集羣的配置，配置修改後可以實時推送到應用端，而且具有規範的權限、流程治理等特性，適用於微服務配置管理場景。

2.架構和模塊

下面是Apollo架構模塊圖（來源自於波波微課）：

上圖簡要描述了Apollo的整體設計，咱們能夠從下往上看：
●Config Service提供配置的讀取、推送等功能，服務對象是Apollo客戶端。
●Admin Service提供配置的修改、發佈等功能，服務對象是Apollo Portal（管理界面）。
●Config Service和Admin Service都是多實例、無狀態部署，因此須要將本身註冊到Eureka中並保持心跳。
●在Eureka之上咱們架了一層Meta Server用於封裝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配置中心服務端拉取應用的最新配置。
  ○這是一個fallback機制，爲了防止推送機制失效致使配置不更新。
  ○客戶端定時拉取會上報本地版本，因此通常狀況下，對於定時拉取的操做，服務端都會返回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客戶端使用指南