Spring Cloud構(gòu)建微服務(wù)架構(gòu)(四)分布式配置中心
Spring Cloud Config為服務(wù)端和客戶端提供了分布式系統(tǒng)的外部化配置支持。配置服務(wù)器為各應(yīng)用的所有環(huán)境提供了一個(gè)中心化的外部配置。它實(shí)現(xiàn)了對(duì)服務(wù)端和客戶端對(duì)Spring Environment和PropertySource抽象的映射,所以它除了適用于Spring構(gòu)建的應(yīng)用程序,也可以在任何其他語言運(yùn)行的應(yīng)用程序中使用。作為一個(gè)應(yīng)用可以通過部署管道來進(jìn)行測(cè)試或者投入生產(chǎn),我們可以分別為這些環(huán)境創(chuàng)建配置,并且在需要遷移環(huán)境的時(shí)候獲取對(duì)應(yīng)環(huán)境的配置來運(yùn)行。
配置服務(wù)器默認(rèn)采用git來存儲(chǔ)配置信息,這樣就有助于對(duì)環(huán)境配置進(jìn)行版本管理,并且可以通過git客戶端工具來方便的管理和訪問配置內(nèi)容。當(dāng)然他也提供本地化文件系統(tǒng)的存儲(chǔ)方式,下面從這兩方面介紹如何使用分布式配置來存儲(chǔ)微服務(wù)應(yīng)用多環(huán)境的配置內(nèi)容。
構(gòu)建Config Server
通過Spring Cloud構(gòu)建一個(gè)Config Server,非常簡(jiǎn)單,只需要三步:
- pom.xml中引入spring-cloud-config-server依賴,完整依賴配置如下:
 
- <parent>
 - <groupId>org.springframework.boot</groupId>
 - <artifactId>spring-boot-starter-parent</artifactId>
 - <version>1.3.5.RELEASE</version>
 - <relativePath/> <!-- lookup parent from repository -->
 - </parent>
 - <dependencies>
 - <dependency>
 - <groupId>org.springframework.boot</groupId>
 - <artifactId>spring-boot-starter-test</artifactId>
 - <scope>test</scope>
 - </dependency>
 - <dependency>
 - <groupId>org.springframework.cloud</groupId>
 - <artifactId>spring-cloud-config-server</artifactId>
 - </dependency>
 - </dependencies>
 - <dependencyManagement>
 - <dependencies>
 - <dependency>
 - <groupId>org.springframework.cloud</groupId>
 - <artifactId>spring-cloud-dependencies</artifactId>
 - <version>Brixton.RELEASE</version>
 - <type>pom</type>
 - <scope>import</scope>
 - </dependency>
 - </dependencies>
 - </dependencyManagement>
 
- 創(chuàng)建Spring Boot的程序主類,并添加@EnableConfigServer注解,開啟Config Server
 
- @EnableConfigServer
 - @SpringBootApplication
 - public class Application {
 - public static void main(String[] args) {
 - new SpringApplicationBuilder(Application.class).web(true).run(args);
 - }
 - }
 
- application.properties中配置服務(wù)信息以及git信息,例如:
 
- spring.application.name=config-server
 - server.port=7001
 - # git管理配置
 - spring.cloud.config.server.git.uri=http://git.oschina.net/didispace/SpringBoot-Learning/
 - spring.cloud.config.server.git.searchPaths=Chapter9-1-4/config-repo
 - spring.cloud.config.server.git.username=username
 - spring.cloud.config.server.git.password=password
 
- spring.cloud.config.server.git.uri:配置git倉庫位置
 - spring.cloud.config.server.git.searchPaths:配置倉庫路徑下的相對(duì)搜索位置,可以配置多個(gè)
 - spring.cloud.config.server.git.username:訪問git倉庫的用戶名
 - spring.cloud.config.server.git.password:訪問git倉庫的用戶密碼
 
到這里,使用一個(gè)通過Spring Cloud Config實(shí)現(xiàn),并使用git管理內(nèi)容的配置中心已經(jīng)完成了,啟動(dòng)該應(yīng)用,成功后開始下面的內(nèi)容。
Spring Cloud Config也提供本地存儲(chǔ)配置的方式。我們只需要設(shè)置屬性spring.profiles.active=native,Config Server會(huì)默認(rèn)從應(yīng)用的src/main/resource目錄下檢索配置文件。也可以通過spring.cloud.config.server.native.searchLocations=file:F:/properties/屬性來指定配置文件的位置。雖然Spring Cloud Config提供了這樣的功能,但是為了支持更好的管理內(nèi)容和版本控制的功能,還是推薦使用git的方式。
服務(wù)端驗(yàn)證
為了驗(yàn)證上面完成的配置服務(wù)器,在http://git.oschina.net/didispace/SpringBoot-Learning/Chapter9-1-4/ 下創(chuàng)建了一個(gè)config-repo目錄作為配置倉庫,并根據(jù)不同環(huán)境新建了下面四個(gè)配置文件:
- didispace.properties
 - didispace-dev.properties
 - didispace-test.properties
 - didispace-prod.properties
 
其中設(shè)置了一個(gè)from屬性,為每個(gè)配置文件分別設(shè)置了不同的值,如:
- from=git-default-1.0
 - from=git-dev-1.0
 - from=git-test-1.0
 - from=git-prod-1.0
 
為了測(cè)試版本控制,在master中,我們都加入1.0的后綴,同時(shí)創(chuàng)建一個(gè)config-label-test分支,并將各配置文件中的值用2.0作為后綴。
完成了這些準(zhǔn)備工作之后,我們就可以通過瀏覽器或POSTMAN等工具直接來訪問到我們的配置內(nèi)容了。
URL與配置文件的映射關(guān)系如下:
- /{application}/{profile}[/{label}]
 - /{application}-{profile}.yml
 - /{label}/{application}-{profile}.yml
 - /{application}-{profile}.properties
 - /{label}/{application}-{profile}.properties
 
上面的url會(huì)映射{application}-{profile}.properties對(duì)應(yīng)的配置文件,{label}對(duì)應(yīng)git上不同的分支,默認(rèn)為master。
我們可以嘗試構(gòu)造不同的url來訪問不同的配置內(nèi)容,比如:要訪問config-label-test分支,didispace應(yīng)用的prod環(huán)境,可以通過這個(gè)url:http://localhost:7001/didispace/prod/config-label-test
- {
 - "name": "didispace",
 - "profiles": [
 - "prod"
 - ],
 - "label": "config-label-test",
 - "version": "19de8a25575a7054a34230f74a22aa7f5575a9d1",
 - "propertySources": [
 - {
 - "name": "http://git.oschina.net/didispace/SpringBoot-Learning/Chapter9-1-4/config-repo/didispace-prod.properties",
 - "source": {
 - "from": "git-prod-2.0"
 - }
 - },
 - {
 - "name": "http://git.oschina.net/didispace/SpringBoot-Learning/Chapter9-1-4/config-repo/didispace.properties",
 - "source": {
 - "from": "git-default-2.0"
 - }
 - }
 - ]
 - }
 
微服務(wù)端映射配置
在完成并驗(yàn)證了配置服務(wù)中心之后,下面看看我們?nèi)绾卧谖⒎?wù)應(yīng)用中獲取配置信息。
- 創(chuàng)建一個(gè)Spring Boot應(yīng)用,在pom.xml中引入spring-cloud-starter-config依賴,完整依賴關(guān)系如下:
 
- <parent>
 - <groupId>org.springframework.boot</groupId>
 - <artifactId>spring-boot-starter-parent</artifactId>
 - <version>1.3.5.RELEASE</version>
 - <relativePath/> <!-- lookup parent from repository -->
 - </parent>
 - <dependencies>
 - <dependency>
 - <groupId>org.springframework.boot</groupId>
 - <artifactId>spring-boot-starter-test</artifactId>
 - <scope>test</scope>
 - </dependency>
 - <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>
 - </dependencies>
 - <dependencyManagement>
 - <dependencies>
 - <dependency>
 - <groupId>org.springframework.cloud</groupId>
 - <artifactId>spring-cloud-dependencies</artifactId>
 - <version>Brixton.RELEASE</version>
 - <type>pom</type>
 - <scope>import</scope>
 - </dependency>
 - </dependencies>
 - </dependencyManagement>
 
- 創(chuàng)建最基本的Spring Boot啟動(dòng)主類
 
- @SpringBootApplication
 - public class Application {
 - public static void main(String[] args) {
 - new SpringApplicationBuilder(Application.class).web(true).run(args);
 - }
 - }
 
- 創(chuàng)建bootstrap.properties配置,來指定config server,例如:
 
- spring.application.name=didispace
 - spring.cloud.config.profile=dev
 - spring.cloud.config.label=master
 - spring.cloud.config.uri=http://localhost:7001/
 - server.port=7002
 
- spring.application.name:對(duì)應(yīng)前配置文件中的{application}部分
 - spring.cloud.config.profile:對(duì)應(yīng)前配置文件中的{profile}部分
 - spring.cloud.config.label:對(duì)應(yīng)前配置文件的git分支
 - spring.cloud.config.uri:配置中心的地址
 
這里需要格外注意:上面這些屬性必須配置在bootstrap.properties中,config部分內(nèi)容才能被正確加載。因?yàn)閏onfig的相關(guān)配置會(huì)先于application.properties,而bootstrap.properties的加載也是先于application.properties。
- 創(chuàng)建一個(gè)Rest Api來返回配置中心的from屬性,具體如下:
 
- @RefreshScope
 - @RestController
 - class TestController {
 - @Value("${from}")
 - private String from;
 - @RequestMapping("/from")
 - public String from() {
 - return this.from;
 - }
 - }
 
通過@Value("${from}")綁定配置服務(wù)中配置的from屬性。
啟動(dòng)該應(yīng)用,并訪問:http://localhost:7002/from ,我們就可以根據(jù)配置內(nèi)容輸出對(duì)應(yīng)環(huán)境的from內(nèi)容了。
完整示例:Chapter9-1-4















 
 
 






 
 
 
 