SpringCloud 配置管理:Nacos

Juno3550發表於2022-06-07


統一配置管理

image

將配置交給 Nacos 管理的步驟:

  1. 在 Nacos 中新增配置檔案。
  2. 在微服務中引入 nacos 的 config 依賴。
  3. 在微服務中新增 bootstrap.yml,配置 nacos 地址、當前環境、服務名稱、檔案字尾名。這些決定了程式啟動時去 nacos 讀取哪個檔案。

具體操作:

1)在 Nacos 中新增配置資訊

image

2)在彈出表單中填寫配置資訊

image

3)配置獲取的步驟如下

image

4)引入 Nacos 的配置管理客戶端依賴

<!-- nacos配置管理依賴 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

5)在 resource 目錄新增一個 bootstrap.yml 檔案,這個檔案是引導檔案,優先順序高於 application.yml

spring:
application:
  name: userservice  # 服務名稱
profiles:
  active: dev  # 開發環境,這裡是dev
cloud:
  nacos:
    server-addr: localhost:8848  # Nacos地址
    config:
      file-extension: yaml  # 檔案字尾名

6)測試:將(Nacos 配置內容中的)pattern.dateformat 這個屬性注入到 UserController 中

@RestController
    @RequestMapping("/user")
    public class UserController {
    
    // 注入nacos中的配置屬性
    @Value("${pattern.dateformat}")
    private String dateformat;
     
    // 編寫controller,通過日期格式化器來格式化現在時間並返回
    @GetMapping("now")
    public String now(){
        return LocalDate.now().format(
            DateTimeFormatter.ofPattern(dateformat, Locale.CHINA)
        );
    }
    // ... 略
    }

配置熱更新

Nacos 配置更改後,微服務可以實現熱更新,兩種方式如下:

  1. 通過 @Value 註解注入,結合 @RefreshScope 來重新整理。
  2. 通過 @ConfigurationProperties 注入,自動重新整理。

注意事項:

  • 不是所有的配置都適合放到配置中心,否則維護起來比較麻煩。
  • 建議將一些關鍵引數,需要執行時調整的引數放到 nacos 配置中心,一般都是自定義配置。

方式一:在 @Value 注入的變數所在類上新增註解 @RefreshScope

image

方式二:使用 @ConfigurationProperties 註解

@Component
@Data
@ConfigurationProperties(prefix="pattern")
public class PatternProperties {
    private String dateformat;
}

配置共享

多環境配置共享

微服務會從 nacos 讀取的配置檔案:

  • [服務名]-[spring.profile.active].yaml環境配置(例如 userservice-dev.yaml)。
  • [服務名].yaml預設配置,多環境共享(例如 userservice.yaml)。
  • 無論 profile 如何變化,[服務名].yaml 這個檔案一定會載入,因此多環境共享配置可以寫入這個檔案。

image

配置載入優先順序:

image


多服務配置共享

不同服務之間共享配置檔案的兩種方式:

  1. 通過 shared-configs 指定
  2. 通過 extension-configs 指定

方式一:通過 shared-configs 指定

spring:
  application:
    name: userservice  # 服務名稱
  profiles:
    active: dev  # 環境
  cloud:
    nacos:
      server-addr: localhost:8848  # Nacos 地址
      config: 
        file-extension: yaml  # 檔案字尾名
        shared-configs:  # 多微服務間共享的配置列表
          - dataId: common.yaml  # 要共享的配置檔案 id

方式二:通過 extension-configs 指定

spring:
  application:
    name: userservice  # 服務名稱
  profiles:
    active: dev  # 環境
  cloud:
    nacos:
      server-addr: localhost:8848  # Nacos 地址
      config:
        file-extension: yaml  # 檔案字尾名
        extends-configs:  # 多微服務間共享的配置列表
          - dataId: extend.yaml  # 要共享的配置檔案 id

多種配置的優先順序:

image

相關文章