5--SpringCloud搭建分布式配置中心
Spring Cloud Config為服務端和客戶端提供了分布式系統的外部化配置支持。配置服務器為各應用的所有環境提供了一個中心化的外部配置。作為一個應用可以通過部署管道來進行測試或者投入生產,我們可以分別為這些環境創建配置,并且在需要遷移環境的時候獲取對應環境的配置來運行。
配置服務器默認采用git來存儲配置信息,這樣就有助于對環境配置進行版本管理,并且可以通過git客戶端工具來方便的管理和訪問配置內容。當然他也提供本地化文件系統的存儲方式,下面從這兩方面介紹如何使用分布式配置來存儲微服務應用多環境的配置內容。
構建Config Server
創建一個簡單的springBoot項目 pom加上依賴
<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>
創建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配置文件
spring.application.name=config-server server.port=7001 # git配置 #所在項目根目錄 配置git倉庫位置 spring.cloud.config.server.git.uri=https://gitee.com/cengjiang/springcloud_learning/ #所在地址目錄 配置倉庫路徑下的相對搜索位置,可以配置多個 spring.cloud.config.server.git.searchPaths=5--SpringCloud--Config #如果是公開項目則不用寫用戶名密碼 spring.cloud.config.server.git.username=username spring.cloud.config.server.git.password=password
到這里,使用一個通過Spring Cloud Config實現,并使用git管理內容的配置中心已經完成了,啟動該應用,成功后開始下面的內容。
Spring Cloud Config也提供本地存儲配置的方式。我們只需要設置屬性spring.profiles.active=native,Config Server會默認從應用的src/main/resource目錄下檢索配置文件。也可以通過spring.cloud.config.server.native.searchLocations=file:F:/properties/屬性來指定配置文件的位置。雖然Spring Cloud Config提供了這樣的功能,但是為了支持更好的管理內容和版本控制的功能,還是推薦使用git的方式。
服務器端驗證
我的git倉庫是在碼云上創建的,里面存放在springCloud系列的示例代碼。大家不想創建git倉庫的也可以使用我這個地址。
在倉庫地址https://gitee.com/cengjiang/springcloud_learning/下面創建了一個目錄5--SpringCloud--Confi存放配置文件作為配置倉庫,并根據不同環境新建了下面四個配置文件:
其中設置了一個from屬性,為每個配置文件分別設置了不同的值,如:
from=git-default-1.0
from=git-dev-1.0
from=git-test-1.0
from=git-prod-1.0
為了測試版本控制,在master中,我們都加入1.0的后綴,同時創建一個config-label-test分支,并將各配置文件中的值用2.0作為后綴。

URL與配置文件的映射關系如下: application(應用)、profile(環境)、label(分支)
/{application}/{profile}[/{label}]
yml文件:
/{application}-{profile}.yml
/{application}-{profile}/{label}.yml
properties
/{application}-{profile}.properties
/{application}-{profile}/{label}.properties
訪問:
{label}對應git上不同的分支,默認為master。
我們可以嘗試構造不同的url來訪問不同的配置內容,比如:要訪問config-label-test分支,ghghspace應用的prod環境,可以通過這個url:http://localhost:7001/ghghspace/prod/config-label-test

微服務端映射配置
在完成并驗證了配置服務中心之后,下面看看我們如何在微服務應用中獲取配置信息。
創建一個簡單的springBoot項目config-client pom加上依賴
<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>
創建啟動主類
@SpringBootApplication public class Application { public static void main(String[] args) { new SpringApplicationBuilder(Application.class).web(true).run(args); } }
創建bootstrap.properties
#對應前配置文件中的{application}部分 spring.application.name=ghghspace #對應前配置文件中的{profile}部分 spring.cloud.config.profile=dev #對應前配置文件的git分支 spring.cloud.config.label=master #配置中心的訪問地址 spring.cloud.config.uri=http://localhost:7001/ server.port=7002
這里需要格外注意:上面這些屬性必須配置在bootstrap.properties中,config部分內容才能被正確加載。因為config的相關配置會先于application.properties,而bootstrap.properties的加載也是先于application.properties。
創建一個Rest Api來返回配置中心的from屬性,具體如下:
@RefreshScope @RestController public class TestController { @Value("${from}") private String from; @RequestMapping("/from") public String from() { return this.from; } }
通過@Value("${from}")綁定配置服務中配置的from屬性。
啟動該應用,并訪問:http://localhost:7002/from ,我們就可以根據配置內容輸出對應環境的from內容了。

源碼下載: 5--SpringCloud--Config

浙公網安備 33010602011771號