Spring Cloud Alibaba系列教程-04-使用Nacos管理配置

之前,筆者詳細探討了如何使用 Spring Cloud Config 管理配置,詳見:

本節來探討如何使用Nacos管理配置。

Nacos配置

1 進入Nacos控制檯,點擊導航欄的“配置列表”,然後點擊右側的“+” 按鈕,如下圖所示:

Spring Cloud Alibaba系列教程-04-使用Nacos管理配置

2 即可看到類似下圖的界面:

Spring Cloud Alibaba系列教程-04-使用Nacos管理配置

其中,dataId 的完整格式為:${prefix}-${spring.profile.active}.${file-extension} 。

  • prefix 默認為 spring.application.name 的值,也可以通過配置項 spring.cloud.nacos.config.prefix來配置。
  • spring.profile.active 即為當前環境對應的 profile,詳情可以參考 Spring Boot文檔。 注意:當 spring.profile.active 為空時,對應的連接符 - 也將不存在,dataId 的拼接格式變成​{file-extension}
  • file-exetension 為配置內容的數據格式,可以通過配置項 spring.cloud.nacos.config.file-extension 來配置。目前只支持 properties 和 yaml 類型。

編碼

1 添依賴:

<dependencies>
<dependency>
<groupid>org.springframework.boot/<groupid>
<artifactid>spring-boot-starter-web/<artifactid>
/<dependency>
<dependency>
<groupid>org.springframework.cloud/<groupid>
<artifactid>spring-cloud-starter-alibaba-nacos-config/<artifactid>
/<dependency>
/<dependencies>

<dependencymanagement>
<dependencies>
<dependency>
<groupid>org.springframework.cloud/<groupid>
<artifactid>spring-cloud-dependencies/<artifactid>
<version>Greenwich.RELEASE/<version>
<type>pom/<type>
<scope>import/<scope>

/<dependency>
<dependency>
<groupid>org.springframework.cloud/<groupid>
<artifactid>spring-cloud-starter-alibaba-nacos-config/<artifactid>
<version>0.2.1.RELEASE/<version>
/<dependency>
/<dependencies>
/<dependencymanagement>

2 加註解:

@SpringBootApplication
public class ConfigClientApplication {
public static void main(String[] args) {
SpringApplication.run(ConfigClientApplication.class, args);
}
}

3 寫配置:bootstrap.yml

spring:
application:
name: microservice-foo
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848
# 指定group
group: DEFAULT_GROUP
# 文件後綴,默認為properties
file-extension: properties
profiles:
active: dev

4 寫配置:application.yml

server:
port: 8081

5 編寫Controller:

@RestController
@RefreshScope
public class ConfigClientController {

@Value("${profile}")
private String profile;

@GetMapping("/profile")
public String hello() {
return this.profile;
}
}

如代碼所示,這裡使用@Value("${profile}") 引用了一個名為profile 的配置屬性。該配置屬性使用Nacos進行管理。(dev-1.0)

測試1:配置管理

1 啟動應用,可看到類似如下的日誌:

2019-02-15 22:13:14.472 INFO 4474 --- [ main] o.s.c.a.n.c.NacosPropertySourceBuilder : Loading nacos data, dataId: 'microservice-foo-dev.properties', group: 'DEFAULT_GROUP'
2019-02-15 22:13:14.473 INFO 4474 --- [ main] b.c.PropertySourceBootstrapConfiguration : Located property source: CompositePropertySource {name='NACOS', propertySources=[NacosPropertySource {name='microservice-foo-dev.properties'}, NacosPropertySource {name='microservice-foo.properties'}]}

這兩行日誌比較重要,它告訴我們當前應用獲取了Nacos中的哪些配置文件。

2 訪問http://localhost:8081/profile ,返回dev-1.0

測試2:配置刷新

1 將配置修改為dev-2.0 ,併發布,如下圖:

Spring Cloud Alibaba系列教程-04-使用Nacos管理配置

2 再次訪問http://localhost:8081/profile ,返回dev-2.0

3 可打印類似如下的日誌:

2019-02-15 22:16:07.237 INFO 4474 --- [-127.0.0.1_8848] o.s.c.e.event.RefreshEventListener : Refresh keys changed: [profile]

該日誌也比較重要,它告訴我們哪些配置屬性刷新了。

注意點

  • Nacos中的Data ID的格式務必寫對,和應用對應,否則無法正確找到相應配置文件;
  • 要想刷新配置屬性,@RefreshScope 不能少,否則配置無法正常刷新。


分享到:


相關文章: