Spring Cloud Alibaba系列(二)nacos作為服務配置中心

lican123發表於2020-05-09

Nacos 提供用於儲存配置和其他後設資料的 key/value 儲存,為分散式系統中的外部化配置提供伺服器端和客戶端支援。使用 Spring Cloud Alibaba Nacos Config,您可以在 Nacos Server 集中管理你 Spring Cloud 應用的外部屬性配置。

首先我們來看一下,微服務架構下關於配置檔案的一些問題:

  1. 配置檔案相對分散,在一個微服務架構中,配置檔案會隨著微服務的增多變得越來越多,而且分散在各個微服務中,不好統一管理和配置。
  2. 配置檔案無法區分環境,微服務專案可能會有多個環境,例如:開發環境、預釋出環境、生成環境。每個環境所使用的配置理論上都是不同的,一旦需要修改,就需要我們去各個微服務下手動維護,這比較困難。
  3. 配置檔案無法實時更新,我們修改好了配置檔案之後,必須重新啟動微服務才能使配置檔案生效,這對一個正在執行的專案來說是非常不友好的。

基於上面這些問題,我們就需要引入配置中心來解決。

建立一個config服務

  1. 新建一個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>
  1. 在配置檔案指定config地址等資訊
    注意:不能使用原來的application.yml作為配置檔案,而是新建一個bootstrap.yml作為配置檔案

配置檔案載入的優先順序(由高到低)

bootstrap.properties ->bootstrap.yml -> application.properties -> application.yml

server:
  port: 9002spring:
  profiles:
    active: dev
  application:
    name: nacos-config-server
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848 # 配置中心
        file-extension: yaml # 這裡指定的檔案格式需要和nacos上新建的配置檔案字尾相同,否則讀不到
  1. 在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},
  • 配置內容:根據你的配置格式按對應的格式填寫即可。
  1. 在config服務中獲取配置資訊
@SpringBootApplicationpublic 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也是支援這種寫法的。

  1. 我們在nacos中新建兩個Data ID 分別是log.yaml 和 file.yaml 的檔案。

我們在配置檔案中分別加入以下內容:log:level: 2,file:url: " "。

  1. 如何配置呢
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
  1. 深入思考,既然我們有兩個配置檔案,假如兩個配置檔案中出現一樣的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


來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/69973775/viewspace-2690767/,如需轉載,請註明出處,否則將追究法律責任。

相關文章