SpringCloud 配置管理:Nacos


目录
  • 统一配置管理
  • 配置热更新
  • 配置共享
    • 多环境配置共享
    • 多服务配置共享


统一配置管理

将配置交给 Nacos 管理的步骤:

  1. 在 Nacos 中添加配置文件。
  2. 在微服务中引入 nacos 的 config 依赖。
  3. 在微服务中添加 bootstrap.yml,配置 nacos 地址、当前环境、服务名称、文件后缀名。这些决定了程序启动时去 nacos 读取哪个文件。

具体操作:

1)在 Nacos 中添加配置信息

2)在弹出表单中填写配置信息

3)配置获取的步骤如下

4)引入 Nacos 的配置管理客户端依赖



    com.alibaba.cloud
    spring-cloud-starter-alibaba-nacos-config

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

方式二:使用 @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 这个文件一定会加载,因此多环境共享配置可以写入这个文件。

配置加载优先级:


多服务配置共享

不同服务之间共享配置文件的两种方式:

  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

多种配置的优先级: