Nacos 提供用于存盤配置和其他元資料的 key/value 存盤,為分布式系統中的外部化配置提供服務器端和客戶端支持,使用 Spring Cloud Alibaba Nacos Config,您可以在 Nacos Server 集中管理你 Spring Cloud 應用的外部屬性配置,
首先我們來看一下,微服務架構下關于組態檔的一些問題:
- 組態檔相對分散,在一個微服務架構中,組態檔會隨著微服務的增多變得越來越多,而且分散在各個微服務中,不好統一管理和配置,
- 組態檔無法區分環境,微服務專案可能會有多個環境,例如:開發環境、預發布環境、生成環境,每個環境所使用的配置理論上都是不同的,一旦需要修改,就需要我們去各個微服務下手動維護,這比較困難,
- 組態檔無法實時更新,我們修改好了組態檔之后,必須重新啟動微服務才能使組態檔生效,這對一個正在運行的專案來說是非常不友好的,
基于上面這些問題,我們就需要引入配置中心來解決,
創建一個config服務
- 新建一個config服務,在pom檔案中添加必要依賴
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.2.5.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<dependencyManagement>
<dependencies>
<!--Spring cloud Hoxton.SR3-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Hoxton.SR3</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!--Spring cloud alibaba 2.1.0.RELEASE-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.2.1.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
</dependencies>
- 在組態檔指定config地址等資訊
注意:不能使用原來的application.yml作為組態檔,而是新建一個bootstrap.yml作為組態檔
組態檔加載的優先級(由高到低)
bootstrap.properties ->bootstrap.yml -> application.properties -> application.yml
server:
port: 9002
spring:
profiles:
active: dev
application:
name: nacos-config-server
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848 # 配置中心
file-extension: yaml # 這里指定的檔案格式需要和nacos上新建的組態檔后綴相同,否則讀不到
- 在nacos客戶端配置管理新建一個配置

- Data ID:默認為 ${spring.application.name}-${spring.profile.active}.${spring.cloud.nacos.config.file-extension} 或 ${spring.application.name}.${spring.cloud.nacos.config.file-extension}
- Group:對應組態檔中的${spring.cloud.nacos.config.group},默認為DEFAULT_GROUP
- 配置格式:對應組態檔中的${spring.cloud.nacos.config.file-extension},
- 配置內容:根據你的配置格式按對應的格式填寫即可,
- 在config服務中獲取配置資訊
@SpringBootApplication
public class NacosConfigServerApplication {
public static void main(String[] args) {
SpringApplication.run(NacosConfigServerApplication.class, args);
}
@RestController
class TestController {
@Value("${config.info}")
private String config;
@GetMapping("/test")
public String hello() {
return config;
}
}
}
我們通過@Value注解可以獲取到配置中心的值,
@RefreshScope動態重繪配置
在TestController上加個@RefreshScope注解,然后我們去nacos客戶端手動修改config.info的資訊,然后重新呼叫這個/test介面,會發現回應的是修改后的內容,
配置自定義的命名空間
用于進行租戶粒度的配置隔離,不同的命名空間下,可以存在相同的 Group 或 Data ID 的配置,Namespace 的常用場景之一是不同環境的配置的區分隔離,例如開發測驗環境和生產環境的資源(如配置、服務)隔離等,
在沒有明確指定命名空間配置的情況下, 默認使用的是 Nacos 上 Public 這個namespae,
首先我們在nacos客戶端新建一個命名空間,

然后我們在組態檔中新增下面這個屬性,具體的值填寫我們新增命名空間的ID,這樣啟動config服務后,就會自動去這個命名空間下尋找對應的組態檔了,
spring:
cloud:
nacos:
config:
namespace:
多環境配置的三種方式
最開始的時候我們也說過微服務專案會有多個環境,我們如何實作和管理這些環境呢?
1.通過Data ID 和profiles實作
我們可以在組態檔中指定spring.profiles.active = **,然后在nocas客戶端新建對應的${spring.cloud.nacos.config.prefix}-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}配置來區分不同的環境,
2.通過Group實作
我們可以為不同的環境新建不同的分組,然后的組態檔中指定spring.cloud.nacos.config.group=組名,這樣也可以實作不同環境的區分,
3.通過Namespace實作
這種方式是官方建議的方式,在nacos客戶端中新建不同的分組,然后再組態檔中指定namespace就可以區分不同的環境了,
自定義擴展的Data ID
大多數時候我們可能更加傾向于將不同的配置分開寫到不同的組態檔中,比如我想把檔案類和日志類的配置拆分開寫到兩個配置中,nacos也是支持這種寫法的,
- 我們在nacos中新建兩個Data ID 分別是log.yaml 和 file.yaml 的檔案,
我們在組態檔中分別加入以下內容:log:level: 2,file:url: "http://123.com",
- 如何配置呢
spring:
cloud:
nacos:
config:
extension-configs[0]:
data-id: log.yaml
group: DEFAULT_GROUP # 默認為DEFAULT_GROUP
refresh: true # 是否動態重繪,默認為false
extension-configs[1]:
data-id: file.yaml
group: DEFAULT_GROUP
refresh: true
為了更加清晰的在多個應用間配置共享的 Data Id,官方推薦使用如下配置:
spring:
cloud:
nacos:
config:
shared-configs[0]:
data-id: log.yaml
group: DEFAULT_GROUP # 默認為DEFAULT_GROUP
refresh: true # 是否動態重繪,默認為false
shared-configs[1]:
data-id: file.yaml
group: DEFAULT_GROUP
refresh: true
- 深入思考,既然我們有兩個組態檔,假如兩個組態檔中出現一樣的key值,這樣我們程式中會加載哪個配置呢,其實nacos在設計的時候也考慮到了優先級問題,下面我們一起來看看,
我們將file.yaml中的配置改成log:level: 22,這時候我們加載寫個介面取一下配置,看看它取到的是哪個檔案的內容,
RestController
@RefreshScope
class TestController {
@Value("${log.level}")
private String log;
@GetMapping("/test")
public String hello() {
return "log.lelve="+log;
}
}

結果取到的是file.yaml中的配置,這是因為多個 Data Id 同時配置時,他的優先級關系是 spring.cloud.nacos.config.extension-configs[n].data-id 其中 n 的值越大,優先級越高,
注意:spring.cloud.nacos.config.extension-configs[n].data-id 的值必須帶檔案擴展名,檔案擴展名既可支持 properties,又可以支持 yaml/yml, 此時 spring.cloud.nacos.config.file-extension 的配置對自定義擴展配置的 Data Id 檔案擴展名沒有影響,
擴展:不同方式配置加載優先級
Spring Cloud Alibaba Nacos Config 目前提供了三種配置能力從 Nacos 拉取相關的配置,
- A: 通過
spring.cloud.nacos.config.shared-configs[n].data-id支持多個共享 Data Id 的配置 - B: 通過
spring.cloud.nacos.config.extension-configs[n].data-id的方式支持多個擴展 Data Id 的配置 - C: 通過內部相關規則(spring.cloud.nacos.config.prefix
、spring.cloud.nacos.config.file-extension、spring.cloud.nacos.config.group)自動生成相關的 Data Id 配置
當三種方式共同使用時,他們的一個優先級關系是:A < B < C
代碼示例
- github:https://github.com/binzh303/spring-cloud-alibaba-learning
- gitee:https://gitee.com/zhixie/spring-cloud-alibaba-learning
轉載請註明出處,本文鏈接:https://www.uj5u.com/ruanti/3083.html
標籤:架構設計
