這篇文章將為大家詳細講解有關(guān)SpringBoot如何集成Apollo配置中心,小編覺得挺實用的,因此分享給大家做個參考,希望大家閱讀完這篇文章后可以有所收獲。
創(chuàng)新互聯(lián)公司專注為客戶提供全方位的互聯(lián)網(wǎng)綜合服務(wù),包含不限于成都網(wǎng)站設(shè)計、網(wǎng)站制作、外貿(mào)營銷網(wǎng)站建設(shè)、下冶網(wǎng)絡(luò)推廣、微信小程序、下冶網(wǎng)絡(luò)營銷、下冶企業(yè)策劃、下冶品牌公關(guān)、搜索引擎seo、人物專訪、企業(yè)宣傳片、企業(yè)代運營等,從售前售中售后,我們都將竭誠為您服務(wù),您的肯定,是我們大的嘉獎;創(chuàng)新互聯(lián)公司為所有大學生創(chuàng)業(yè)者提供下冶建站搭建服務(wù),24小時服務(wù)熱線:18982081108,官方網(wǎng)址:www.cdcxhl.com系統(tǒng)環(huán)境
SpringBoot 版本:2.1.8.RELEASE
Apollo 版本:1.4.0
由于 Apollo 概念比較多,剛開始使用比較復(fù)雜,最好先過一遍概念再動手實踐嘗試使用。
隨著程序功能的日益復(fù)雜,程序的配置日益增多,各種功能的開關(guān)、參數(shù)的配置、服務(wù)器的地址……對程序配置的期望值也越來越高,配置修改后實時生效,灰度發(fā)布,分環(huán)境、分集群管理配置,完善的權(quán)限、審核機制…… 在這樣的大環(huán)境下,傳統(tǒng)的通過配置文件、數(shù)據(jù)庫等方式已經(jīng)越來越無法滿足開發(fā)人員對配置管理的需求。因此 Apollo 配置中心應(yīng)運而生!
Apollo(阿波羅)是攜程框架部門研發(fā)的開源配置管理中心,能夠集中化管理應(yīng)用不同環(huán)境、不同集群的配置,配置修改后能夠?qū)崟r推送到應(yīng)用端,并且具備規(guī)范的權(quán)限、流程治理等特性。
部署簡單
灰度發(fā)布
版本發(fā)布管理
提供開放平臺API
客戶端配置信息監(jiān)控
提供Java和.Net原生客戶端
配置修改實時生效(熱發(fā)布)
權(quán)限管理、發(fā)布審核、操作審計
統(tǒng)一管理不同環(huán)境、不同集群的配置
如下即是 Apollo 的基礎(chǔ)模型:
(1)、用戶在配置中心對配置進行修改并發(fā)布
(2)、配置中心通知Apollo客戶端有配置更新
(3)、Apollo客戶端從配置中心拉取最新的配置、更新本地配置并通知到應(yīng)用
Apollo支持4個維度管理Key-Value格式的配置:
application (應(yīng)用)
environment (環(huán)境)
cluster (集群)
namespace (命名空間)
(1)、application
Apollo 客戶端在運行時需要知道當前應(yīng)用是誰,從而可以根據(jù)不同的應(yīng)用來獲取對應(yīng)應(yīng)用的配置。
每個應(yīng)用都需要有唯一的身份標識,可以在代碼中配置 app.id
參數(shù)來標識當前應(yīng)用,Apollo 會根據(jù)此指來辨別當前應(yīng)用。
(2)、environment
在實際開發(fā)中,我們的應(yīng)用經(jīng)常要部署在不同的環(huán)境中,一般情況下分為開發(fā)、測試、生產(chǎn)等等不同環(huán)境,不同環(huán)境中的配置也是不同的,在 Apollo 中默認提供了四種環(huán)境:
FAT(Feature Acceptance Test):功能測試環(huán)境
UAT(User Acceptance Test):集成測試環(huán)境
DEV(Develop):開發(fā)環(huán)境
PRO(Produce):生產(chǎn)環(huán)境
在程序中如果想指定使用哪個環(huán)境,可以配置變量 env
的值為對應(yīng)環(huán)境名稱即可。
(3)、cluster
一個應(yīng)用下不同實例的分組,比如典型的可以按照數(shù)據(jù)中心分,把上海機房的應(yīng)用實例分為一個集群,把北京機房的應(yīng)用實例分為另一個集群。
對不同的集群,同一個配置可以有不一樣的值,比如說上面所指的兩個北京、上海兩個機房設(shè)置兩個集群,兩個集群中都有 mysql 配置參數(shù),其中參數(shù)中配置的地址是不一樣的。
(4)、namespace
一個應(yīng)用中不同配置的分組,可以簡單地把 namespace 類比為不同的配置文件,不同類型的配置存放在不同的文件中,如數(shù)據(jù)庫配置文件,RPC 配置文件,應(yīng)用自身的配置文件等。
熟悉 SpringBoot 的都知道,SpringBoot 項目都有一個默認配置文件 application.yml
,如果還想用多個配置,可以創(chuàng)建多個配置文件來存放不同的配置信息,通過指定 spring.profiles.active
參數(shù)指定應(yīng)用不同的配置文件。這里的 namespace
概念與其類似,將不同的配置放到不同的配置 namespace
中。
Namespace 分為兩種權(quán)限,分別為:
public(公共的): public權(quán)限的 Namespace,能被任何應(yīng)用獲取。
private(私有的): 只能被所屬的應(yīng)用獲取到。一個應(yīng)用嘗試獲取其它應(yīng)用 private 的 Namespace,Apollo 會報 “404” 異常。
Namespace 分為三種類型,分別為:
私有類型: 私有類型的 Namespace 具有 private 權(quán)限。例如 application Namespace 為私有類型。
公共類型: 公共類型的 Namespace 具有 public 權(quán)限。公共類型的N amespace 相當于游離于應(yīng)用之外的配置,且通過 Namespace 的名稱去標識公共 Namespace,所以公共的 Namespace 的名稱必須全局唯一。
關(guān)聯(lián)類型(繼承類型): 關(guān)聯(lián)類型又可稱為繼承類型,關(guān)聯(lián)類型具有 private 權(quán)限。關(guān)聯(lián)類型的 Namespace 繼承于公共類型的 Namespace,將里面的配置全部繼承,并且可以用于覆蓋公共 Namespace 的某些配置。
繼承,并且可以用于覆蓋公共 Namespace 的某些配置。
Apollo客戶端會把從服務(wù)端獲取到的配置在本地文件系統(tǒng)緩存一份,用于在遇到服務(wù)不可用,或網(wǎng)絡(luò)不通的時候,依然能從本地恢復(fù)配置,不影響應(yīng)用正常運行。
本地緩存路徑默認位于以下路徑,所以請確保/opt/data或C:\opt\data\目錄存在,且應(yīng)用有讀寫權(quán)限。
Mac/Linux: /opt/data/{appId}/config-cache
Windows: C:\opt\data{appId}\config-cache
本地配置文件會以下面的文件名格式放置于本地緩存路徑下:
1 {appId}+{cluster}+{namespace}.properties
上圖簡要描述了Apollo客戶端的實現(xiàn)原理
客戶端和服務(wù)端保持了一個長連接,從而能第一時間獲得配置更新的推送。
客戶端還會定時從 Apollo 配置中心服務(wù)端拉取應(yīng)用的最新配置。
這是一個 fallback 機制,為了防止推送機制失效導(dǎo)致配置不更新
客戶端定時拉取會上報本地版本,所以一般情況下,對于定時拉取的操作,服務(wù)端都會返回 304 - Not Modified
定時頻率默認為每 5 分鐘拉取一次,客戶端也可以通過在運行時指定 apollo.refreshInterval
來覆蓋,單位為分鐘。
客戶端從 Apollo 配置中心服務(wù)端獲取到應(yīng)用的最新配置后,會保存在內(nèi)存中。
客戶端會把從服務(wù)端獲取到的配置在本地文件系統(tǒng)緩存一份 在遇到服務(wù)不可用,或網(wǎng)絡(luò)不通的時候,依然能從本地恢復(fù)配置。
應(yīng)用程序從 Apollo 客戶端獲取最新的配置、訂閱配置更新通知。
配置更新推送實現(xiàn)
前面提到了 Apollo 客戶端和服務(wù)端保持了一個長連接,從而能第一時間獲得配置更新的推送。長連接實際上我們是通過 Http Long Polling 實現(xiàn)的,具體而言:
客戶端發(fā)起一個 Http 請求到服務(wù)端
服務(wù)端會保持住這個連接 60 秒
如果在 60 秒內(nèi)有客戶端關(guān)心的配置變化,被保持住的客戶端請求會立即返回,并告知客戶端有配置變化的 namespace 信息,客戶端會據(jù)此拉取對應(yīng) namespace 的最新配置
如果在 60 秒內(nèi)沒有客戶端關(guān)心的配置變化,那么會返回 Http 狀態(tài)碼 304 給客戶端
客戶端在收到服務(wù)端請求后會立即重新發(fā)起連接,回到第一步
考慮到會有數(shù)萬客戶端向服務(wù)端發(fā)起長連,在服務(wù)端我們使用了 async servlet(Spring DeferredResult) 來服務(wù) Http Long Polling 請求。
上圖簡要描述了Apollo的總體設(shè)計,我們可以從下往上看:
Config Service 提供配置的讀取、推送等功能,服務(wù)對象是 Apollo 客戶端
Admin Service 提供配置的修改、發(fā)布等功能,服務(wù)對象是 Apollo Portal(管理界面)
Config Service 和 Admin Service 都是多實例、無狀態(tài)部署,所以需要將自己注冊到 Eureka 中并保持心跳
在 Eureka 之上我們架了一層 Meta Server 用于封裝Eureka的服務(wù)發(fā)現(xiàn)接口
Client 通過域名訪問 Meta Server 獲取Config Service服務(wù)列表(IP+Port),而后直接通過 IP+Port 訪問服務(wù),同時在 Client 側(cè)會做 load balance 錯誤重試
Portal 通過域名訪問 Meta Server 獲取 Admin Service 服務(wù)列表(IP+Port),而后直接通過 IP+Port 訪問服務(wù),同時在 Portal 側(cè)會做 load balance、錯誤重試
為了簡化部署,我們實際上會把 Config Service、Eureka 和 Meta Server 三個邏輯角色部署在同一個 JVM 進程中
配置中心作為基礎(chǔ)服務(wù),可用性要求非常高,下面的表格描述了不同場景下Apollo的可用性:
場景 | 影響 | 降級 | 原因 |
---|---|---|---|
某臺 config service 下線 | 無影響 | Config service無狀態(tài),客戶端重連其它config service | |
所有 config service 下線 | 客戶端無法讀取最新配置,Portal無影響 | 客戶端重啟時,可以讀取本地緩存配置文件 | |
某臺 admin service 下線 | 無影響 | Admin service無狀態(tài),Portal重連其它 admin service | |
所有 admin service 下線 | 客戶端無影響,portal無法更新配置 | ||
某臺 portal 下線 | 無影響 | Portal域名通過slb綁定多臺服務(wù)器,重試后指向可用的服務(wù)器 | |
全部 portal 下線 | 客戶端無影響,portal無法更新配置 | ||
某個數(shù)據(jù)中心下線 | 無影響 | 多數(shù)據(jù)中心部署,數(shù)據(jù)完全同步,Meta Server/Portal 域名通過 slb 自動切換到其它存活的數(shù)據(jù)中心 |
接下來我們將創(chuàng)建一個 Apollo 的客戶端項目,引用 Apollo 來實現(xiàn)配置動態(tài)更新,不過在此之前我們需要提前進入 Apollo Portal 界面,在里面提前創(chuàng)建一個項目并在其配置一個參數(shù),方便后續(xù)客戶端引入該配置參數(shù),測試是否能動態(tài)變化。
我這里是部署到 Kubernetes 中,通過 NodePort 方式暴露出一個端口,打開這個地址登錄 Apollo:
用戶名:apollo
密 碼:admin
在登錄后創(chuàng)建項目時,選擇部門默認只能選擇 Apollo 自帶的 測試部門1與測試部門2兩個選項。
開始這真讓人迷糊,原來 Apoloo 沒有修改或新增部門信息的管理節(jié)目,只能通過修改數(shù)據(jù)庫,來新增或者修改數(shù)據(jù),這里打開 Portal
對月的數(shù)據(jù)庫中的表 ApolloPortalDB
修改 key
為 organizations
的 value
的 json 數(shù)據(jù),改成自己對于的部門信息。
修改完數(shù)據(jù)庫部門信息后,重新登錄 Apollo Portal,然后創(chuàng)建項目,這時候選擇部門可以看到已經(jīng)變成我們自己修改后的部門信息了,選擇我們自定義部門,然后設(shè)置應(yīng)用 ID 為 apollo-test
,應(yīng)用名為 apollo-demo
。
創(chuàng)建完成后進入配置管理界面
創(chuàng)建一個配置參數(shù),方便后續(xù) Apollo 客戶端項目引入該參數(shù),進行動態(tài)配置測試。
設(shè)置 key 為 test
value 為 123456
然后設(shè)置一個備注,保存。
創(chuàng)建完成后可以看到配置管理節(jié)目新增了一條配置。
接下來我們將此配置通過發(fā)布按鈕,進行發(fā)布。
這里創(chuàng)建一個 SpringBoot 項目,引入 Apollo 客戶端來來實現(xiàn)與 Apollo 配置中心服務(wù)端交互。
1
2 3 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4 4.0.0
5
6
7 org.springframework.boot
8 spring-boot-starter-parent
9 2.1.8.RELEASE
10
11
12 club.mydlq
13 apollo-demo
14 0.0.1
15 apollo-demo
16 Apollo Demo
17
18
19 1.8
20
21
22
23
24 org.springframework.boot
25 spring-boot-starter-web
26
27
28 com.ctrip.framework.apollo
29 apollo-client
30 1.4.0
31
32
33
34
35
36
37 org.springframework.boot
38 spring-boot-maven-plugin
39
40
41
在 application.yml 配置文件中添加下面參數(shù),這里簡單介紹下 Apollo 參數(shù)作用:
apollo.meta: Apollo 配置中心地址。
apollo.cluster: 指定使用某個集群下的配置。
apollo.bootstrap.enabled: 是否開啟 Apollo。
apollo.bootstrap.namespaces : 指定使用哪個 Namespace 的配置,默認 application。
apollo.cacheDir=/opt/data/some-cache-dir: 為了防止配置中心無法連接等問題,Apollo 會自動將配置本地緩存一份。
apollo.autoUpdateInjectedSpringProperties: Spring應(yīng)用通常會使用 Placeholder 來注入配置,如${someKey:someDefaultValue},冒號前面的是 key,冒號后面的是默認值。如果想關(guān)閉 placeholder 在運行時自動更新功能,可以設(shè)置為 false。
apollo.bootstrap.eagerLoad.enabled : 將 Apollo 加載提到初始化日志系統(tǒng)之前,如果設(shè)置為 false,那么將打印出 Apollo 的日志信息,但是由于打印 Apollo 日志信息需要日志先啟動,啟動后無法對日志配置進行修改,所以 Apollo 不能管理應(yīng)用的日志配置,如果設(shè)置為 true,那么 Apollo 可以管理日志的配置,但是不能打印出 Apollo 的日志信息。
1#應(yīng)用配置
2server:
3 port: 8080
4spring:
5 application:
6 name: apollo-demo
7
8#Apollo 配置
9app:
10 id: apollo-test #應(yīng)用ID
11apollo:
12 cacheDir: /opt/data/ #配置本地配置緩存目錄
13 cluster: default #指定使用哪個集群的配置
14 meta: http://192.168.2.11:30002 #DEV環(huán)境配置中心地址
15 autoUpdateInjectedSpringProperties: true #是否開啟 Spring 參數(shù)自動更新
16 bootstrap:
17 enabled: true #是否開啟 Apollo
18 namespaces: application #設(shè)置 Namespace
19 eagerLoad:
20 enabled: false #將 Apollo 加載提到初始化日志系統(tǒng)之前
寫一個 Controller 類來輸出 test 變量的值,使用了 Spring
的 @Value
注解,用于讀取配置文件中的變量的值,這里來測試該值,項目啟動后讀取到的變量的值是設(shè)置在 application 配置文件中的默認值,還是遠程 Apollo 中的值,如果是 Apollo 中配置的值,那么再測試在 Apollo 配置中心中改變該變量的值后,這里是否會產(chǎn)生變化。
1import org.springframework.beans.factory.annotation.Value;
2import org.springframework.web.bind.annotation.GetMapping;
3import org.springframework.web.bind.annotation.RestController;
4
5@RestController
6public class TestController {
7
8 @Value("${test:默認值}")
9 private String test;
10
11 @GetMapping("/test")
12 public String test(){
13 return "test的值為:" + test;
14 }
15}
SpringBoot 項目啟動類。
1import org.springframework.boot.SpringApplication;
2import org.springframework.boot.autoconfigure.SpringBootApplication;
3
4@SpringBootApplication
5public class Application {
6
7 public static void main(String[] args) {
8 SpringApplication.run(Application.class, args);
9 }
10
11}
由于本人的 Apollo 是部署在 Kubernetes 環(huán)境中的,JVM 參數(shù)中必須添加兩個變量:
env: 應(yīng)用使用 Apollo 哪個環(huán)境,例如設(shè)置為 DEV
就是指定使用開發(fā)環(huán)境,如果設(shè)置為 PRO
就是制定使用生產(chǎn)環(huán)境。
apollo.configService: 指定配置中心的地址,跳過 meta 的配置,在測試時指定 meta 地址無效果。如果 Apollo 是部署在 Kubernetes 中,則必須設(shè)置該參數(shù)為配置中心地址,如果 Apollo 不是在 Kubernetes 環(huán)境中,可以不設(shè)置此參數(shù),只設(shè)置 meta 參數(shù)即可。一般情況下,configService 和 meta 值一致。
如果是在 Idea 中啟動,可以配置啟動參數(shù),加上:
1-Dapollo.configService=http://192.168.2.11:30002 -Denv=DEV
如果是 java 命令啟動程序,需要 JVM 加上:
1$ java -Dapollo.configService=http://192.168.2.11:30002 -Denv=DEV -jar apollo-demo.jar
注意:上面 env 指定的環(huán)境,要和 apollo.meta 指定 Config 地址的環(huán)境一致,例如 -Denv=DEV 即使用開發(fā)環(huán)境,那么 apollo.meta=http://xxx.xxx.xxx:8080 這個url 的 Config 也是開發(fā)環(huán)境下的配置中心服務(wù),而不能是 PRO 或者其它環(huán)境下的配置中心。
啟動上面的測試用例,然后輸入地址 http://localhost:8080/test 查看:
1test的值為:123456
可以看到使用的是 Apollo 中配置的 test
參數(shù)的值 123456
,而不是默認的值。
修改 Apollo 配置中心參數(shù) test
值為 666666
,然后再次發(fā)布。
發(fā)布完成后再次輸入地址 http://localhost:8080/test 查看:
1test的值為:666666
可以看到示例應(yīng)用中的值已經(jīng)改變?yōu)樽钚碌闹怠?/p>
回滾完成后狀態(tài)將變?yōu)槲窗l(fā)布狀態(tài),則時候輸入地址 http://localhost:8080/test 查看:
1test的值為:123456
可以看到已經(jīng)回滾到之前的 test
配置的值了。
這里我們將 JVM 參數(shù)中 Apollo 配置中心地址故意改錯:
1-Dapollo.configService=http://192.168.2.100:30002 -Denv=DEV
然后輸入地址 http://localhost:8080/test 可以看到值為:
1test的值為:123456
可以看到顯示的值并不是我們定義的默認值,而還是 Apollo 配置中心配置的 test
參數(shù)的值。考慮到由于 Apollo 會在本地將配置緩存一份,出現(xiàn)上面原因,估計是緩存生效。當客戶端不能連接到 Apollo 配置中心時候,默認使用本地緩存文件中的配置。
上面我們配置了本地緩存配置文件存放地址為 “/opt/data/” ,接下來進入緩存目錄,找到對應(yīng)的緩存配置文件,刪除緩存配置文件后,重啟應(yīng)用,再次輸入地址查看:
1test的值為:默認值
刪除緩存配置文件后,可以看到輸出的值為自己定義的默認值。
這里我們進入 Apollo 配置中心,刪除之前創(chuàng)建的 test
參數(shù),然后發(fā)布。
然后再次打開地址 http://localhost:8080/test 查看:
1test的值為:默認值
可以看到顯示的是應(yīng)用程序中設(shè)置的默認值。
在 Apollo 中,配置可以根據(jù)不同的環(huán)境劃分為 Dev(開發(fā))、Prod(生產(chǎn)) 等環(huán)境,又能根據(jù)區(qū)域劃分為不同的 Cluster(集群),還能根據(jù)配置參數(shù)作用功能的不同劃分為不同的 Namespace(命名空間),這里探究下,如何使用上述能力。
(1)、Apollo 配置中心 PRO 環(huán)境添加參數(shù)
打開 Apollo 配置中心,環(huán)境列表點擊 PRO 環(huán)境,然后新增一條配置,和之前例子中參數(shù)保持一致,都為 test
參數(shù),創(chuàng)建完成后發(fā)布。
然后修改上面的示例項目,將配置參數(shù)指定為 PRO 環(huán)境:
(2)、示例項目修改 application.yml 配置文件
把 apollo.meta
參數(shù)改成 RPO 的配置中心地址
1......
2
3apollo:
4 meta: http://192.168.2.11:30005 #RPO環(huán)境配置中心地址
5
6......
(3)、示例項目修改 JVM 參數(shù)
把 apollo.configService
參數(shù)改成 PRO 配置中心地址,env
參數(shù)的值改為 PRO
。
1-Dapollo.configService=http://192.168.2.11:30005 -Denv=PRO
(4)、啟動示例項目觀察結(jié)果
啟動示例項目,然后接著輸入地址 http://localhost:8080/test 查看信息:
1test的值為:abcdefg
可以看到已經(jīng)改成生成環(huán)境配置,所以在實際項目中,如果要更換環(huán)境,需要修改 JVM 參數(shù) env
(如果 Apollo 部署在 Kubernetes 環(huán)境中,還需要修改 apollo.configService
參數(shù)),和修改 application.yml 配置文件的參數(shù) apollo.meta
值。
(1)、創(chuàng)建兩個集群
例如在開發(fā)過程中,經(jīng)常要將應(yīng)用部署到不同的機房,這里分別創(chuàng)建 beijing
、shanghai
兩個集群。
(2)、兩個集群都配置同樣的參數(shù)不同的值
在兩個集群 beijing
與 shanghai
中,都統(tǒng)一配置參數(shù) test
,并且設(shè)置不同的值。
(3)、示例項目 application.yml 修改集群配置參數(shù),并啟動項目觀察結(jié)果
指定集群為 beijing:
1......
2
3apollo:
4 cluster: beijing #指定使用 beijing 集群
5
6......
啟動示例項目,然后接著輸入地址 http://localhost:8080/test 查看信息:
1test的值為:Cluster-BeiJing
可以看到用的是 beijing 集群的配置
指定集群為 shanghai:
1......
2
3apollo:
4 cluster: shanghai #指定使用 shanghai 集群
5
6......
啟動示例項目,然后接著輸入地址 http://localhost:8080/test 查看信息:
1test的值為:Cluster-ShangHai
可以看到用的是 shanghai 集群的配置
(1)、創(chuàng)建兩個命名空間
命名空間有兩種,一種是 public(公開),一種是 private 私有,公開命名空間所有項目都能讀取配置信息,而私有的只能 app.id
值屬于該應(yīng)用的才能讀取配置。
這里創(chuàng)建 dev-1
與 dev-2
兩個私有的命名空間,用于測試。
(2)、兩個集群都配置同樣的參數(shù)不同的值
在兩個命名空間中,都統(tǒng)一配置參數(shù) test
,并且設(shè)置不同的值,設(shè)置完后發(fā)布。
(3)、示例項目 application.yml 修改命名空間配置參數(shù),并啟動項目觀察結(jié)果
指定命名空間為 dev-1:
1......
2
3apollo:
4 bootstrap:
5 namespaces: dev-1 #設(shè)置 dev-1 命名空間
6
7......
啟動示例項目,然后接著輸入地址 http://localhost:8080/test 查看信息:
1test的值為:dev-1 Namespace
可以看到用的是 dev-1 命名空間的配置
指定命名空間為 dev-2:
1......
2
3apollo:
4 bootstrap:
5 namespaces: dev-2 #設(shè)置 dev-1 命名空間
6
7......
啟動示例項目,然后接著輸入地址 http://localhost:8080/test 查看信息:
1test的值為:dev-2 Namespace
可以看到用的是 dev-2 命名空間的配置
本人的 Apollo 和 SpringBoot 應(yīng)用一般都是基于 Kubernetes 部署的,所以這里簡單介紹下,如何在 Kubernetes 環(huán)境下部署 SpringBoot 應(yīng)用且使用 Apollo 作為配置中心。
這里項目依舊使用上面的示例,不過首先要將其編譯成 Docker 鏡像,方便后續(xù)部署到 Kubernetes 環(huán)境下。
(1)、執(zhí)行 Maven 編譯
首先執(zhí)行 Maven 命令,將項目編譯成一個可執(zhí)行 JAR。
1$ mvn clean install
(2)、準備 Dockerfile
創(chuàng)建構(gòu)建 Docker 鏡像需要的 Dockerfile 文件,將 Maven 編譯的 JAR 復(fù)制到鏡像內(nèi)部,然后設(shè)置兩個變量,分別是:
JAVA_OPTS: Java JVM 啟動參數(shù)變量,這里需要在這里加一個時區(qū)參數(shù)。
APP_OPTS: Spring 容器啟動參數(shù)變量,方便后續(xù)操作時能通過此變量配置 Spring 參數(shù)。
Dockerfile:
1FROM openjdk:8u222-jre-slim
2VOLUME /tmp
3ADD target/*.jar app.jar
4RUN sh -c 'touch /app.jar'
5ENV JAVA_OPTS="-Duser.timezone=Asia/Shanghai"
6ENV APP_OPTS=""
7ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar $APP_OPTS" ]
(3)、構(gòu)建 Docker 鏡像
執(zhí)行 Docker Build 命令構(gòu)建 Docker 鏡像。
1$ docker build -t mydlqclub/springboot-apollo:0.0.1 .
(1)、創(chuàng)建 SpringBoot 且使用 Apollo 配置中心的 Kubernetes 部署文件
這里創(chuàng)建 Kubernetes 下的 SpringBoot 部署文件 apollo-demo-example.yaml
。在之前 Dockerfile 中設(shè)置了兩個環(huán)境變量,JAVA_OPTS
與 APP_OPTS
。其中 JAVA_OPTS
變量的值將會作為 JVM 啟動參數(shù),APP_OPTS
變量的值將會作為應(yīng)用的配置參數(shù)。所以,這里我們將 Apollo 配置參數(shù)放置到變量中,這樣一來就可以方便修改與維護 Apollo 的配置信息。
在下面配置的環(huán)境變量參數(shù)中,設(shè)置的配置中心地址為
http://service-apollo-config-server-dev.mydlqclub:8080
,這是因為 Apollo 部署在 K8S 環(huán)境中,且可以使用域名方式訪問,service-apollo-config-server-dev 是應(yīng)用的 Service 名稱,mydlqcloud 是 K8S 下的 Namespace 名稱。
springboot-apollo.yaml
1 apiVersion: v1
2 kind: Service
3 metadata:
4
name: springboot-apollo
5 spec:
6
type: NodePort
7
ports:
8
- name: server
9
nodePort: 31080
10
port: 8080
11
targetPort: 8080
12
- name: management
13
nodePort: 31081
14
port: 8081
15
targetPort: 8081
16
selector:
17
app: springboot-apollo
18 ---
19 apiVersion: apps/v1
20 kind: Deployment
21 metadata:
22
name: springboot-apollo
23
labels:
24
app: springboot-apollo
25 spec:
26
replicas: 1
27
selector:
28
matchLabels:
29
app: springboot-apollo
30
template:
31
metadata:
32
name: springboot-apollo
33
labels:
34
app: springboot-apollo
35
spec:
36
restartPolicy: Always
37
containers:
38
- name: springboot-apollo
39
image: mydlqclub/springboot-apollo:0.0.1
40
imagePullPolicy: Always
41
ports:
42
- containerPort: 8080
43
name: server
44
env:
45
- name: JAVA_OPTS
46
value: "-Denv=DEV"
47
##注意修改此處的 mydlqcloud 為你自己的 Namespace 名稱
48 - name: APP_OPTS
49 value: "
50 -- app.id=apollo-demo
51 -- apollo.bootstrap.enabled=true
52 -- apollo.bootstrap.eagerLoad.enabled=false
53 -- apollo.cacheDir=/opt/data/
54 -- apollo.cluster=default
55 -- apollo.bootstrap.namespaces=application
56 -- apollo.autoUpdateInjectedSpringProperties=true
57 -- apollo.meta=http://service-apollo-config-server-dev.mydlqcloud:8080
58 "
59 resources:
60 limits:
61 memory: 1000Mi
62 cpu: 1000m
63 requests:
64 memory: 500Mi
65 cpu: 500m
(2)、部署 SpringBoot 應(yīng)用到 Kubernetes
-n:創(chuàng)建應(yīng)用到指定的 Namespace 中。
1$ kubectl apply -f springboot-apollo.yaml -n mydlqcloud
關(guān)于“SpringBoot如何集成Apollo配置中心”這篇文章就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,使各位可以學到更多知識,如果覺得文章不錯,請把它分享出去讓更多的人看到。