? ?我的博客:蘭陵笑笑生,歡迎瀏覽博客闸准!
? ?上一章 SpringCloud基礎(chǔ)教程(三)-Eureka進(jìn)階當(dāng)中,我們?cè)趯?duì)Eureka的有了基本的基礎(chǔ)認(rèn)識(shí)之上辆童,深入的了解Eureka高可用集群和其他的生產(chǎn)環(huán)境中用到的一些配置凿可。本章將開(kāi)始了解分布式環(huán)境下的配置中心敛瓷。
前言
?為什么需要配置中心材失,在單體的應(yīng)用中蓝丙,配置文件就可以很好的解決配置問(wèn)題。但是在微服務(wù)架構(gòu)模式下疲憋,系統(tǒng)不可避免的被拆分了許多個(gè)微服務(wù)組件,如果還是通過(guò)以前的方式梁只,配置的工作量會(huì)很大缚柳。為此埃脏,一個(gè)通用的分布式的配置管理中心是必不可少的彩掐。Spring Cloud提供了另外一個(gè)組件Spring Cloud Config。
?Spring Cloud Config提供了服務(wù)端和客戶端的支持堵幽,基于Spring環(huán)境,能夠無(wú)縫的集成Spring朴下,默認(rèn)的實(shí)現(xiàn)是基于Git倉(cāng)庫(kù)苦蒿。當(dāng)然也支持SVN,本地文件等佩迟,甚至自定義實(shí)現(xiàn)。
一 报强、快速構(gòu)建Config Server配置服務(wù)端
?這里我們使用Git作為配置文件的存儲(chǔ)倉(cāng)庫(kù),首先建立Maven項(xiàng)目秉溉,并在Pom.xml文件中引入相關(guān)依賴力惯。
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-config</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-config-server</artifactId>
</dependency>
?創(chuàng)建ConfigServerApplicaition.java 類,使用@EnableConfigServer注解坚嗜,表示允許該服務(wù)以HTTP形式對(duì)外提供配置管理服務(wù):
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;
@SpringBootApplication
@EnableConfigServer
public class ConfigServerApplicaition {
public static void main(String[] args) {
SpringApplication.run(ConfigServerApplicaition.class, args);
}
}
?添加applicaiton.yml,配置如下:
spring:
application:
name: single
cloud:
config:
server:
git:
uri: https://gitee.com/lnxxs/springCloudConfig.git
password:
username:
search-paths: conf
label: master
- spring.cloud.config.server.git.uri:配置Git的倉(cāng)庫(kù)位置夯膀。
- spring.cloud.config.server.git.search-paths:配置Git的倉(cāng)庫(kù)路徑下的相對(duì)搜索位置。
- spring.cloud.config.server.git.username:Git的用戶名苍蔬,如果倉(cāng)庫(kù)是公開(kāi)的可以不填
- spring.cloud.config.server.git.password:配置Git用戶密碼诱建。
- spring.cloud.config.lable:git的分支名稱
?在這之前,事先創(chuàng)建Git倉(cāng)庫(kù)碟绑,添加配置文件俺猿,master分支添加如下文件和內(nèi)容:
ConfigServer.properties: k1=master-default-v1
ConfigServer-dev.properties:k1=master-dev-v1
ConfigServer-test.properties:k1=master-test-v1
ConfigServer-pro.properties:k1=master-pro-v1
?在服務(wù)啟動(dòng)后刀脏,可以基于HTTP請(qǐng)求訪問(wèn)如下的URL進(jìn)行配置信息的獲取啸罢,獲取的格式有如下幾種:
- /{application}/{profile}
- /{application}/{profile}[/{lable}]
- /{application}-{profile}.properties
- /{lable}/{application}-{profile}.properties
- /{lable}/{application}/{profile}[/{lable}
其中applicaiton是文件的名稱。如
1) http://localhost:6001/ConfigServer-dev.properties
2) http://localhost:6001/master/ConfigServer-dev.properties :加載指定分支的屬性:
3) http://localhost:6001/ConfigServer/default :顯示默認(rèn)的配置
{
"name":"ConfigServer",
"profiles":[
"default"
],
"label":null,
"version":"f516174f308769468f1ac683cfeffa803a63c9af",
"state":null,
"propertySources":[
{
"name":"https://gitee.com/lnxxs/springCloudConfig.git/ConfigServer.properties",
"source":{
"k1":"master-default-v1"
}
}
]
}
4) http://localhost:6001/ConfigServer/dev :顯示默認(rèn)和dev的信息
{
"name":"ConfigServer",
"profiles":[
"dev"
],
"label":null,
"version":"f516174f308769468f1ac683cfeffa803a63c9af",
"state":null,
"propertySources":[
{
"name":"https://gitee.com/lnxxs/springCloudConfig.git/ConfigServer-dev.properties",
"source":{
"k1":"master-dev-v1"
}
},
{
"name":"https://gitee.com/lnxxs/springCloudConfig.git/ConfigServer.properties",
"source":{
"k1":"master-default-v1"
}
}
]
}
5) http://localhost:6001/ConfigServer/test/master 顯示指定的分支的test和默認(rèn)的配置
{
"name":"ConfigServer",
"profiles":[
"test"
],
"label":"master",
"version":"f516174f308769468f1ac683cfeffa803a63c9af",
"state":null,
"propertySources":[
{
"name":"https://gitee.com/lnxxs/springCloudConfig.git/ConfigServer-test.properties",
"source":{
"k1":"master-test-v1"
}
},
{
"name":"https://gitee.com/lnxxs/springCloudConfig.git/ConfigServer.properties",
"source":{
"k1":"master-default-v1"
}
}
]
}
?如果通過(guò)以上的URL獲取到Git倉(cāng)庫(kù)的配置信息耕皮,說(shuō)明配置服務(wù)端正常凯肋。
二 谊惭、構(gòu)建Config Client配置客戶端
?接下來(lái)我們創(chuàng)建一個(gè)SpringBoot應(yīng)用作為客戶端來(lái)讀取Config Server中提供的配置。(我們開(kāi)發(fā)的任何一個(gè)微服務(wù)組件都可以認(rèn)為是一個(gè)Config Client客戶端。)
?新建ConfigClientApplication,java啟動(dòng)類圈盔,并在項(xiàng)目文件pom.xml中添加依賴:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!--web依賴-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-config</artifactId>
</dependency>
?添加bootstrap.yml,注意這些配置必須是在bootstrap.yml中豹芯,配置才能生效,如果配置在applicaiton.yml中是沒(méi)有任何效果的驱敲。
spring:
application:
name: server-client
cloud:
config:
label: master
name: ConfigServer
profile: test
uri: http://localhost:6001/
- spring.cloud.config.label:指定分支
- spring.cloud.config.name:指定配置文件的名稱铁蹈,我的git倉(cāng)庫(kù)的配置文件的名稱為ConfigServer
- spring.cloud.config.profile:指定激活那個(gè)配置文件
- spring.cloud.config.uri:指定配置中心的url,所有的配置信息都是從配置中心獲取众眨。
?創(chuàng)建ConfigClientApplication.java啟動(dòng)類握牧,并添加EnableAutoConfiguration注解,表示自動(dòng)獲取項(xiàng)目中的配置變量娩梨。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@EnableAutoConfiguration
public class ConfigClientApplication {
public static void main(String[] args) {
SpringApplication.run(ConfigClientApplication.class, args);
}
}
?創(chuàng)建控制器,測(cè)試獲取配置信息:
@RestController
public class ValueController {
@Value("${k1}")
String value;
@GetMapping("/get")
public String getValue(){
return value;
}
}
?調(diào)用接口測(cè)試矫俺,正確的獲取到了配置中心的信息:
三厘托、其他配置
3.1 客戶端快速失敗
?在無(wú)法連接Config Server的時(shí)候铅匹,我們有時(shí)候要求客戶端需要啟動(dòng)失敗包斑,我們可以通過(guò)配置bootstrap配置項(xiàng):
spring:
cloud:
config:
fail-fast: true
retry:
initial-interval: 1000
max-attempts: 6
max-interval: 2000
multiplier: 1.1
3.2 客戶端重試
?如果我們要求客戶端組件在Config Server不可用是罗丰,讓客戶端重試萌抵,那么我們也可以通過(guò)設(shè)置:
spring:
cloud:
config:
fail-fast: false
?同時(shí)在客戶端的配置文件中引入spring-retry和aop依賴:
<dependency>
<groupId>org.springframework.retry</groupId>
<artifactId>spring-retry</artifactId>
<version>1.2.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>
3.3 HTTP權(quán)限
?如果需要對(duì)Config Server的http請(qǐng)求進(jìn)行賬號(hào)密碼控制,在服務(wù)端配置:
spring:
application:
name: single
cloud:
config:
server:
git:
uri: https://gitee.com/lnxxs/springCloudConfig.git
password:
username:
search-paths: conf
label: master
username:
password:
uri: http://localhost:6001/
enabled: true
security:
user:
name: user
password: pwd
?注意用戶名讨永、密碼的屬性是spring.security.user.name和spring.security.user.password
spring.cloud.config.username和spring.cloud.config.password服務(wù)端配置是沒(méi)有什么作用卿闹,是客戶端用來(lái)配置用的
?并在服務(wù)端的pom文件中引入security依賴:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
?我們只需要將用戶名和密鑰復(fù)制并配置再每個(gè)客戶端中bootstrap.xml中就可以,客戶端是不需要引入security依賴的插佛。
spring:
application:
name: server-client
cloud:
config:
label: master
profile: test
uri: http://localhost:6001/
name: ConfigServer
username: user
password: pwd
?在配置HTTP權(quán)限的時(shí)候量窘,如果服務(wù)端在引入security之后蚌铜,沒(méi)有配置用戶名和密碼冬殃,那么服務(wù)端項(xiàng)目啟動(dòng)時(shí)审葬,就會(huì)隨機(jī)生成一個(gè)全局的密鑰涣觉。這里我們不使用隨機(jī)的密碼血柳。如果配置了用戶名和密碼难捌,那么客戶端必須同時(shí)配置一樣的用戶名和加密的密鑰员淫。
四击敌、總結(jié):
?這一篇文章簡(jiǎn)單的介紹了Spring Cloud ConfIf組件的使用愚争,并結(jié)合git倉(cāng)庫(kù)搭建了分布式配置中心轰枝,實(shí)現(xiàn)了程序和配置的隔離,解耦編碼與環(huán)境之間的耦合步淹,這是非常重要的缭裆,當(dāng)然這樣的配置還是存在確定澈驼,在實(shí)際的生成環(huán)境中,所有的服務(wù)配置都依賴于配置中心挎塌,那么如果配置中心出現(xiàn)宕機(jī)該怎么辦榴都,下一章我們將繼續(xù)了解分布式配置中心的集群搭建.
?以上就是本期的分享嘴高,你可以關(guān)注本博客的#Spring Cloud基礎(chǔ)教程!#
? 還可以關(guān)注公眾號(hào): 程序員笑笑生拴驮,關(guān)注更多精彩內(nèi)容莹汤!
本文由博客一文多發(fā)平臺(tái) OpenWrite 發(fā)布!