SpringBoot 集成 Apollo 配置中心

来源:https://www.cnblogs.com/liucs/archive/2020/03/27/12580241.html
-Advertisement-
Play Games

目錄 . 一、基本概念 . 1、背景 . 2、簡介 . 3、特點 . 4、基礎模型 . 5、Apollo 的四個維度 . 6、本地緩存 . 7、客戶端設計 . 8、總體設計 . 9、可用性考慮 . 二、Apollo 配置中心創建項目與配置 . 1、登錄 Apollo . 2、修改與增加部門數據 . ...


目錄

. 一、基本概念

. 1、背景

. 2、簡介

. 3、特點

. 4、基礎模型

. 5、Apollo 的四個維度

. 6、本地緩存

. 7、客戶端設計

. 8、總體設計

. 9、可用性考慮

. 二、Apollo 配置中心創建項目與配置

. 1、登錄 Apollo

. 2、修改與增加部門數據

. 3、創建一個項目

. 4、創建一個配置參數

. 三、創建 Apollo 客戶端測試項目

. 1、Mavne 添加 Apollo 依賴

. 2、配置文件添加參數

. 3、創建測試 Controller 類

. 4、創建啟動類

. 5、JVM 啟動參數添加啟動參數

. 四、啟動項目進行測試

. 1、測試是否能夠獲取 Apollo 中設置的值

. 2、測試當 Apollo 中修改參數值後客戶端是否能及時刷新

. 3、測試當 Apollo 執行配置回滾操作時客戶端是否能及時改變

. 4、測試當不能訪問 Apollo 時客戶端的變化

. 5、測試當 Apollo 中將參數刪除後客戶端的變化

. 五、對 Apollo 的 Cluster、Namespace 進行探究

. 1、不同環境下的配置

. 2、不同集群下的配置

. 3、不同命名空間下的配置

. 六、Kubernetes 的 SpringBoot 應用使用 Apollo 配置中心

. 1、構建 Docker 鏡像

. 2、Kubernetes 部署示例應用

. 3、測試部署的應用介面

目錄

  • 一、Kubernetes 部署配置中心 Apollo

  • 二、SpringBoot 集成 Apollo 配置中心

系統環境

  • SpringBoot 版本：2.1.8.RELEASE

  • Apollo 版本：1.4.0

參考地址

  • Apollo 文檔知識

  • Apollo Github 地址

  • SpringBoto 集成 Apollo 示例項目 Github 地址：https://github.com/my-dlq/blog-example/tree/master/springboot/springboot-apollo-demo

一、基本概念

由於 Apollo 概念比較多，剛開始使用比較複雜，最好先過一遍概念再動手實踐嘗試使用。

1、背景

隨著程式功能的日益複雜，程式的配置日益增多，各種功能的開關、參數的配置、伺服器的地址……對程式配置的期望值也越來越高，配置修改後實時生效，灰度發佈，分環境、分集群管理配置，完善的許可權、審核機制…… 在這樣的大環境下，傳統的通過配置文件、資料庫等方式已經越來越無法滿足開發人員對配置管理的需求。因此 Apollo 配置中心應運而生！

2、簡介

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

特點

  • 部署簡單

  • 灰度發佈

  • 版本發佈管理

  • 提供開放平臺API

  • 客戶端配置信息監控

  • 提供Java和.Net原生客戶端

  • 配置修改實時生效（熱發佈）

  • 許可權管理、發佈審核、操作審計

  • 統一管理不同環境、不同集群的配置

基礎模型

如下即是 Apollo 的基礎模型：

(1)、用戶在配置中心對配置進行修改併發布

(2)、配置中心通知Apollo客戶端有配置更新

(3)、Apollo客戶端從配置中心拉取最新的配置、更新本地配置並通知到應用

5、Apollo 的四個維度

Apollo支持4個維度管理Key-Value格式的配置：

  • application (應用)

  • environment (環境)

  • cluster (集群)

  • namespace (命名空間)

(1)、application

  • Apollo 客戶端在運行時需要知道當前應用是誰，從而可以根據不同的應用來獲取對應應用的配置。

  • 每個應用都需要有唯一的身份標識，可以在代碼中配置 app.id 參數來標識當前應用，Apollo 會根據此指來辨別當前應用。

(2)、environment

在實際開發中，我們的應用經常要部署在不同的環境中，一般情況下分為開發、測試、生產等等不同環境，不同環境中的配置也是不同的，在 Apollo 中預設提供了四種環境：

  • FAT（Feature Acceptance Test）：功能測試環境

  • UAT（User Acceptance Test）：集成測試環境

  • DEV（Develop）：開發環境

  • PRO（Produce）：生產環境

在程式中如果想指定使用哪個環境，可以配置變數 env 的值為對應環境名稱即可。

(3)、cluster

  • 一個應用下不同實例的分組，比如典型的可以按照數據中心分，把上海機房的應用實例分為一個集群，把北京機房的應用實例分為另一個集群。

  • 對不同的集群，同一個配置可以有不一樣的值，比如說上面所指的兩個北京、上海兩個機房設置兩個集群，兩個集群中都有 mysql 配置參數，其中參數中配置的地址是不一樣的。

(4)、namespace

一個應用中不同配置的分組，可以簡單地把 namespace 類比為不同的配置文件，不同類型的配置存放在不同的文件中，如資料庫配置文件，RPC 配置文件，應用自身的配置文件等。

熟悉 SpringBoot 的都知道，SpringBoot 項目都有一個預設配置文件 application.yml，如果還想用多個配置，可以創建多個配置文件來存放不同的配置信息，通過指定 spring.profiles.active 參數指定應用不同的配置文件。這裡的 namespace 概念與其類似，將不同的配置放到不同的配置 namespace 中。

Namespace 分為兩種許可權，分別為：

  • public（公共的）： public許可權的 Namespace，能被任何應用獲取。

  • private（私有的）： 只能被所屬的應用獲取到。一個應用嘗試獲取其它應用 private 的 Namespace，Apollo 會報 “404” 異常。

Namespace 分為三種類型，分別為：

  • 私有類型： 私有類型的 Namespace 具有 private 許可權。例如 application Namespace 為私有類型。

  • 公共類型： 公共類型的 Namespace 具有 public 許可權。公共類型的N amespace 相當於游離於應用之外的配置，且通過 Namespace 的名稱去標識公共 Namespace，所以公共的 Namespace 的名稱必須全局唯一。

  • 關聯類型（繼承類型）： 關聯類型又可稱為繼承類型，關聯類型具有 private 許可權。關聯類型的 Namespace 繼承於公共類型的 Namespace，將裡面的配置全部繼承，並且可以用於覆蓋公共 Namespace 的某些配置。

  • 繼承，並且可以用於覆蓋公共 Namespace 的某些配置。

6、本地緩存

Apollo客戶端會把從服務端獲取到的配置在本地文件系統緩存一份，用於在遇到服務不可用，或網路不通的時候，依然能從本地恢復配置，不影響應用正常運行。

本地緩存路徑預設位於以下路徑，所以請確保/opt/data或C:\opt\data\目錄存在，且應用有讀寫許可權。

  • Mac/Linux： /opt/data/{appId}/config-cache

  • Windows： C:\opt\data{appId}\config-cache

本地配置文件會以下麵的文件名格式放置於本地緩存路徑下：

1 {appId}+{cluster}+{namespace}.properties

7、客戶端設計

上圖簡要描述了Apollo客戶端的實現原理

  • 客戶端和服務端保持了一個長連接，從而能第一時間獲得配置更新的推送。

  • 客戶端還會定時從 Apollo 配置中心服務端拉取應用的最新配置。

  • 這是一個 fallback 機制，為了防止推送機制失效導致配置不更新

  • 客戶端定時拉取會上報本地版本，所以一般情況下，對於定時拉取的操作，服務端都會返回 304 - Not Modified

  • 定時頻率預設為每 5 分鐘拉取一次，客戶端也可以通過在運行時指定 apollo.refreshInterval 來覆蓋，單位為分鐘。

  • 客戶端從 Apollo 配置中心服務端獲取到應用的最新配置後，會保存在記憶體中。

  • 客戶端會把從服務端獲取到的配置在本地文件系統緩存一份 在遇到服務不可用，或網路不通的時候，依然能從本地恢復配置。

  • 應用程式從 Apollo 客戶端獲取最新的配置、訂閱配置更新通知。

配置更新推送實現

前面提到了 Apollo 客戶端和服務端保持了一個長連接，從而能第一時間獲得配置更新的推送。長連接實際上我們是通過 Http Long Polling 實現的，具體而言：

  • 客戶端發起一個 Http 請求到服務端

  • 服務端會保持住這個連接 60 秒

  • 如果在 60 秒內有客戶端關心的配置變化，被保持住的客戶端請求會立即返回，並告知客戶端有配置變化的 namespace 信息，客戶端會據此拉取對應 namespace 的最新配置

  • 如果在 60 秒內沒有客戶端關心的配置變化，那麼會返回 Http 狀態碼 304 給客戶端

  • 客戶端在收到服務端請求後會立即重新發起連接，回到第一步

  • 考慮到會有數萬客戶端向服務端發起長連，在服務端我們使用了 async servlet(Spring DeferredResult) 來服務 Http Long Polling 請求。

8、總體設計

 

上圖簡要描述了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 進程中

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • ES6 Promise --回調與Promise的對比、信任問題、錯誤處理、Promise的狀態、以及Promise對象的常用方法
    之前怎麼用回調解決非同步的問題： function f(callback){ setTimeout(function(){ callback && callback(); }); } f(function(){ console.log(1); f(function(){ console.log(2); ...
  • web前端開發入門，學習路徑以及具體的學習內容
    前端學習路徑 1.WEB前端快速入門 在本階段，我們需要掌握 HTML 與 CSS 基礎，當然，也包含 H5 和 C3 的新特性。這個部分內容非常簡單，而且非常容易掌握。相信你也更願意學習這個部分，畢竟他可以讓你最直觀的感受到前端的魅力。為了鍛煉大家寫代碼，可以根據你喜歡的站點去實現效果。這一階段是 ...
  • vue實現省市區三級聯動
    首先呈現效果圖 1.我的是通過element-ui實現的；可自由選擇UI 2.話不多說，直接上代碼，結構非常簡單 1 <el-form ref="form" :model="form" label-width="100px"> 2 <el-form-item label=""> 3 一:vue實現城 ...
  • React常用hook的優化useEffect淺比較
    先說說react原版的useEffect使用起來不便的地方 useEffect( function() { // effect操作 }, ['a', 'b', { name: 'c' }] ); 這裡的effect每次更新都會執行，因為第三個參數一直是不等的，{name: 'c'} !== {nam ...
  • React封裝強業務hook的一個例子
    最近因為使用列表展示的需求有點多，就想著把列表分頁篩選的邏輯抽象一下。看了umi的一個useTable的hook，也不能滿足業務需要，於是就自己寫了一個，支持本地分頁篩選和介面分頁篩選。 思路就是，篩選的欄位都使用form表單控制，然後在hook裡面將form和table聯合起來。 下麵貼出源碼 1 ...
  • web前端開發學，新手學習前端應該先學vue還是react？
    新手學vue還是react？下麵本篇文章給大家分析一下。有一定的參考價值，正在學習或者有需要的朋友可以參考一下，希望對大家有所幫助。 出身背景： react是facebook團隊開發，2013.3月發佈。目前版本15.5.4（初始版本是13開頭），社區較成熟，擁有更大的生態圈 vue是Evan Yo ...
  • 怎麼用相應的圖來描述系統
    工作中我們經常會有向別人描述項目內容，解釋某一個功能的運作過程等情況。除了文字描述外，配合圖的方式來說明，增加了問題的具象化能力，方便溝通和對方理解。我剛開始一直想用一種圖來表述所有內容，但是實際上沒有一種圖可以做到，即使可以做到，那麼會使得這種圖變得複雜，也不符合人類的接受能力。用對應的圖說明對應 ...
  • 圖解Java設計模式之模板模式
    圖解Java設計模式之模板模式 豆漿製作問題 模板方法模式基本介紹 模板方法模式原理類圖 模板方法模式解決豆漿製作問題 模板方法模式的鉤子方法 模板方法模式在Spring框架中的源碼分析 模板方法模式的註意事項和細節 豆漿製作問題 1）製作豆漿的流程 選材 – 》添加配料 --》浸泡 --》放到豆漿 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類