Spring Cloud Alibaba学习笔记（22） - Nacos配置管理

目前业界流行的统一配置管理中心组件有Spring Cloud Config、Spring Cloud Alibaba的Nacos及携程开源的Apollo，本文将介绍Nacos做为统一配置管理中心的使用。

使用Nacos管理配置

好比我如今有这样一段代码：

@Value("${your.configuration}")
private String yourConfiguration;

@GetMapping("/test_configuration")
public String testConfiguration(){
    return yourConfiguration;
}

这段代码读取了一个配置项，常规的配置方式应该配置于项目的application.yaml或者.properties文件中，那么使用Nacos要如何管理这段配置呢？

首先，添加依赖

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

而后在resources目录下新建一个名为bootstrap.yml的文件，添加配置项：

spring:
  application:
    name: study01
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        namespace: 888ac051-ae5f-44f1-940a-30c7824a0e91
        cluster-name: HZ
        file-extension: yaml
  profiles:
    active: dev

打开Nacos控制台-配置管理-配置列表，点击+号新建配置，详情以下。

注意，这里的Data ID是具备必定格式的，须要与项目中的配置对应上。如上图中的：study01-dev.yaml，其中study01是微服务名称，dev是环境，yaml是配置文件的格式，对应关系以下：

到目前为止，咱们就已经为项目整合了Nacos的配置管理功能，并在Nacos Server上新建了项目所需的配置。启动项目，访问/test_configuration接口，返回结果以下则表明整合成功：

动态刷新配置及回滚

动态刷新配置

在实际的应用开发中，咱们一般但愿在配置中心上修改了配置项后，不须要重启项目就可以实现实时的动态配置刷新。对于整合了Nacos的微服务项目来讲，想要实现这个功能是很简单的，只须要在读取了配置属性的类上加上@RefreshScope注解便可。

添加完该注解后，重启项目，而后到Nacos上修改以前配置项的值，点击发布后会有一个内容比较的提示：

点击确认发布后，而后再访问/test_configuration接口，返回的就是修改后的值了，而此时咱们并无重启项目：

回滚

咱们能够在Nacos控制台-配置管理-历史版本中查询指定配置的历史版本，Data ID和Group必填，点击查询能够看见全部的历史版本：

点击“回滚”则能够回滚到指定的历史版本。须要注意的是当选择回滚的版本是最第一版本时就会触发一个Bug，回滚失败，配置丢失，官方称会在1.2版本中修复该问题。只要回滚的不是初始版本则不会触发这个bug，回滚其余版本是能够正常使用的，因此该问题注意一下便可规避。

配置共享

不一样环境之间的配置共享

想要实现配置共享只须要新建一个配置文件便可，首先咱们来看一段日志信息，当咱们启动项目时，控制台会出输出以下一段日志信息：

2019-10-29 09:35:17.986  INFO 9104 --- [           main] b.c.PropertySourceBootstrapConfiguration : Located property source: CompositePropertySource {name='NACOS', propertySources=[NacosPropertySource {name='study01-dev.yaml'}, NacosPropertySource {name='study01.yaml'}]}

该日志信息能够看到，项目在启动时会到Nacos上读取两个配置文件，即study01-dev.yaml和study01.yaml，其中study01-dev.yaml里保存的是开发环境下特定的配置，而study01.yaml里保存的则是全部环境下通用的配置。项目在启动时具体读取哪一个环境的配置文件是由bootstrap.yml文件中的spring.profiles.active配置项所决定的。
既然咱们知道保存在content-center.yaml里的配置项会在全部环境中共享，那么只须要到Nacos上新建这个配置文件便可，配置方法同上。
PS：特定环境下的配置优先级高于通用环境配置，例如${your.configuration}配置项同时存在于content-center-dev.yaml和content-center.yaml中，若spring.profiles.active的值为dev，那么读取的将是content-center-dev.yaml里所配置的值。

不一样应用之间的配置共享

目前Nacos提供了两种方式能够实现不一样应用之间的配置共享

使用shared-dataids

实现

首先须要到Nacos上建立一些共享配置

修改项目中的bootstrap.yml文件以下

spring:
  application:
    name: study01
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        namespace: 888ac051-ae5f-44f1-940a-30c7824a0e91
        cluster-name: HZ
        file-extension: yaml
        # 共享配置的DataId，多个使用，分隔
        # 越靠后，优先级越高
        # .yaml后缀不能少，只支持yaml/properties
        shared-dataids: common1.yaml,common2.yaml
        # 哪些共享配置支持动态刷新，多个使用，分隔
        refreshable-dataids: common1.yaml
  profiles:
    active: dev

从以上的配置示例能够看出，其实shared-dataids的主要做用就是用来指定共享配置的Data ID，使得该微服务能够读取这些共享配置。同理，其余微服务若想读取这些共享配置，只需在项目的bootstrap.yml文件中添加相应的shared-dataids配置便可，如此一来就实现了多个微服务之间的配置共享。

测试代码

@Value("${common1.configuration1}")
private String common1Configuration;

@Value("${common2.configuration2}")
private String common2Configuration;

@GetMapping("/test_common_configuration1")
public String testCommonConfiguration1() {
    return common1Configuration;
}

@GetMapping("/test_common_configuration2")
public String testCommonConfiguration2() {
    return common2Configuration;
}

测试结果

使用ext-config

实现

spring:
  application:
    name: study01
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yaml
        ext-config:
          # 需共享的DataId，yaml后缀不能少，目前只支持yaml/properties
          # 越靠后，优先级越高 优先级common2.yaml > common1.yaml
          - data-id: common1.yaml
            # common1.yaml所在的group
            group: DEFAULT_GROUP
            # 是否容许刷新，默认false
            refresh: true
          - data-id: common2.yaml
            group: DEFAULT_GROUP
            refresh: true
  profiles:
    active: dev

ext-config提供了较为细化的配置方式，而且能够指定配置组。到目前为止，咱们介绍了三种从Nacos上读取配置的方式，其优先级以下：

• shared-dataids < ext-config < 自动

除此以外，当存在相同的远程配置和本地配置时，远程配置优先级要高于本地配置文件。但能够经过添加以下配置调整，须要注意的是这段配置须要放在远程配置才会生效：

spring:
  cloud:
    config:
      # 是否容许本地配置覆盖远程配置，默认true
      allow-override: true
      # 是否一切以本地配置为准，默认false
      override-none: false
      # 系统环境变量或系统属性才能覆盖远程配置文件的配置
      # 本地配置文件中配置的优先级低于远程配置，默认true
      override-system-properties: true