Nacos(七):Nacos共享配置


前言

本文參考文章:

SpringCloud Alibaba - Nacos Config 自定義共享配置

前景回顧:

前幾章已經基本介紹了springcloud項目結合Nacos的大部分用法,本文介紹一下Nacos作為配置中心時,如何讀取共享配置

我的環境

  • Windows10
  • JDK8
  • SpringCloud:Finchley.RELEASE
  • SpringBoot:2.0.4.RELEASE
  • spring-cloud-alibaba-dependencies:0.2.2.RELEASE
  • Nacos-server:1.0.1

本文的項目Demo繼續沿用之前文章中的聚合工程Nacos,若小伙伴還沒有之前的環境,可至源碼地址中下載

場景描述

一個項目中服務數量增加后,配置文件相應增加,多個配置文件中會存在相同的配置,那么我們可以將相同的配置獨立出來,作為該項目中各個服務的共享配置文件,每個服務都可以通過Nacos進行共享配置的讀取

下面用一個demo演示下,是否可行

  • demo工程:nacos-config-share
  • 配置文件:nacos-config-share.yml
  • 共享配置文件:shareconfig1.yml,shareconfig2.yml

創建項目

一如往常,還是在聚合工程Nacos下創建名為nacos-config-share的子工程,其pom.xml文件依賴與之前的項目都一致,如果您沒有之前的項目可參考源碼地址

1、修改springboot啟動類NacosConfigShareApplication.java

@SpringBootApplication
@EnableDiscoveryClient
@RestController
@RefreshScope
public class NacosConfigShareApplication {

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

    @Value("${nacos.share}")
    private String share;


    @Value("${share.config1}")
    private String shareConfig1;

    @Value("${share.config2}")
    private String shareConfig2;

    @RequestMapping("/getValue")
    public String getValue() {
        return share;
    }

    @RequestMapping("/getShare1")
    public String getShare1() {
        return shareConfig1;
    }

    @RequestMapping("/getShare2")
    public String getShare2() {
        return shareConfig2;
    }
}

2、修改該項目的配置文件bootstrap.yml

spring:
  application:
    name: nacos-config-share
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848
        prefix: ${spring.application.name}
        file-extension: yml
        shared-dataids: shareconfig1.yml,shareconfig2.yml
        refreshable-dataids: shareconfig1.yml,shareconfig2.yml

從配置文件可以看出,通過shared-dataids屬性來指定要讀取共享配置文件的DataID,多個文件用,分隔
使用refreshable-dataids指定共享配置文件支持自動刷新

新建配置文件

這里我們作為演示,暫不加入Namespace,直接在公共空間中創建及測試

創建配置文件nacos-config-share.yml,詳細如下:

  • DataId:nacos-config-share.yml
  • 配置格式:YAML
  • 配置內容:
    server:
        port: 9984
    nacos: 
        share: nacos-config-share
    

創建共享配置文件1shareconfig1.yml,詳細如下:

  • DataId:shareconfig1.yml
  • 配置格式:YAML
  • 配置內容:
    share: 
        config1: 這里是共享配置文件1
    

創建共享配置文件1shareconfig2.yml,詳細如下:

  • DataId:shareconfig2.yml
  • 配置格式:YAML
  • 配置內容:
    share: 
        config2: 這里是共享配置文件2
    

創建成功后,配置列表如下圖:

shareconfig

啟動測試

直接啟動項目,如果啟動成功。可以看到日志中如下信息:

startup

訪問啟動類中提供的接口,測試下能否獲取到共享配置文件中的值

訪問127.0.0.1:9984/getValue,返回:nacos-config-share
訪問127.0.0.1:9984/getShare1,返回:這里是共享配置文件1
訪問127.0.0.1:9984/getShare2,返回:這里是共享配置文件2

再測試下refreshable-dataids配置的自動刷新是否生效

在Nacos控制台中修改共享配置文件shareconfig2.yml的值為:這里是共享配置文件2這里是共享配置文件2

編輯保存后,重新請求 127.0.0.1:9984/getShare2 ,觀察返回結果如下:

這里是共享配置文件2這里是共享配置文件2

以上返回結果說明通過在配置文件中指定shared-dataidsrefreshable-dataids是可以實現共享配置文件的讀取和自動刷新的。

需求變更

假設現在要讀取shareconfig3.ymlshareconfig4.yml文件但是它的Group為SHARE3_GROUPSHARE4_GROUP, 即共享配置文件與項目自身配置文件不在同一Group中(上邊的例子是全都在DEFAULT_GROUP分組) 那如果繼續用上邊的方法,就無法讀取共享配置文件

這時可以使用另一個配置ext-config,它可以由用戶自定義指定需要加載的配置DataID、Group以及是否自動刷新

並且ext-config是一個集合(List),支持多個配置文件的指定。

新建共享配置文件

先創建配置配置文件shareconfig3.ymlshareconfig4.yml,注意他們的Group屬性

  • DataId:shareconfig3.yml
  • Group:SHARE3_GROUP
  • 配置格式:YAML
  • 配置內容:
    share: 
        config3: 這里是共享配置文件3,Group:SHARE3_GROUP
    
  • DataId:shareconfig4.yml
  • Group:SHARE4_GROUP
  • 配置格式:YAML
  • 配置內容:
    share: 
        config4: 這里是共享配置文件4,Group:SHARE4_GROUP
    

創建成功頁面如下:

shareconfig34

修改項目代碼

1、在啟動類NacosConfigShareApplication.java中新增如下代碼

    @Value("${share.config3}")
    private String shareConfig3;

    @Value("${share.config4}")
    private String shareConfig4;


    @RequestMapping("/getShare3")
    public String getShare3() {
        return shareConfig3;
    }

    @RequestMapping("/getShare4")
    public String getShare4() {
        return shareConfig4;
    }

2、修改項目配置文件bootstrap.yml,增加ext-config配置

spring:
  application:
    name: nacos-config-share
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848
        prefix: ${spring.application.name}
        file-extension: yml
        shared-dataids: shareconfig1.yml,shareconfig2.yml
        refreshable-dataids: shareconfig1.yml,shareconfig2.yml
        ext-config:
          - data-id: shareconfig3.yml
            group: SHARE3_GROUP
            refresh: true
          - data-id: shareconfig4.yml
            group: SHARE4_GROUP
            refresh: true

啟動進行測試

項目經過修改后,可以看到

  1. 項目自身的nacos配置文件屬於DEFAULT_GROUP下,默認讀取
  2. shareconfig1.yml,shareconfig2.yml 都屬於DEFAULT_GROUP下,通過shared-dataids指定進行讀取
  3. shareconfig3.yml,shareconfig4.yml 都屬於非DEFAULT_GROUP下,通過ext-config配置屬性進行自定義讀取

啟動項目,測試所有的配置文件是否可以正常讀取

訪問127.0.0.1:9984/getValue,返回:nacos-config-share
訪問127.0.0.1:9984/getShare1,返回:這里是共享配置文件1
訪問127.0.0.1:9984/getShare2,返回:這里是共享配置文件2這里是共享配置文件2
訪問127.0.0.1:9984/getShare3,返回:這里是共享配置文件3,Group:SHARE3_GROUP
訪問127.0.0.1:9984/getShare4,返回:這里是共享配置文件4,Group:SHARE4_GROUP

修改shareconfig4.yml的配置內容為:這里是共享配置文件4,Group:SHARE4_GROUP,支持自動刷新,保存后,再次調用127.0.0.1:9984/getShare4,返回如下:

這里是共享配置文件4,Group:SHARE4_GROUP,支持自動刷新

調用接口后發現,兩種共享配置的加載方式都可以正常讀取,並且可以一起使用。ext-config的方式實現了用戶自定義配置共享配置文件。

總結

上面的demo已經演示Nacos共享配置的兩種實現方式,兩種方式針對不同的場景,總結如下:

  • shared-dataids方式:
    • 適合於共享配置文件與項目默認配置文件處於相同Group時,直接兩條命令就可以搞定
    • 優點:配置方便
    • 缺點:只能在同一Group中
  • ext-config方式:
    • 它可以由開發者自定義要讀取的共享配置文件的DataId、Group、refresh屬性,這樣剛好解決了shared-dataids存在的局限性。
    • 優點:可以與shared-dataids方案結合使用,用戶自定義配置。靈活性強
    • 缺點:配置容易出錯,要熟悉YAML語法

可見兩種方式各有長處,所以如果在開發中需要使用共享配置,大家可以是具體情況而定選擇自己最合適的方案。

本文源碼https://github.com/larscheng/larscheng-learning-demo/tree/master/Nacos




免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM