Spring Cloud 整合 nacos 实现动态配置中心

2022-10-31
浏览 (905)

nacos 除了有 服务注册与发现 的功能，还有提供 动态配置 服务的功能。本文主要讲解 Spring Cloud 整合 nacos 实现动态配置服务。主要参考官方部署手册点我。

前提条件

先下载 nacos 并启动 nacos 服务。操作步骤详见 Nacos 快速入门。

整合步骤

1. 添加依赖

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2.2.7.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.2.12.RELEASE</version>
</dependency>

版本 nacos 2.1.x.RELEASE 对应的是 Spring Boot 2.1.x 版本。版本 2.0.x.RELEASE 对应的是 Spring Boot 2.0.x 版本，版本 1.5.x.RELEASE 对应的是 Spring Boot 1.5.x 版本。版本不匹配的话，会出现很多莫名其妙的问题。 nacos 依赖版本要和 nacos 服务端版本要一致。

2. 新建 nacos 配置

在 nacos 控制台添加配置列表：

设置 dataId 为 nacos-config,文件后缀为 Properties，设置内容 user.name=jack：

3. bootstrap.properties 配置

在 application.yml 同目录下创建 bootstrap.yml 文件，并配置 Nacos 服务地址以及 namespace(没有就不需要配置)：

spring:
  application:
    name: nacos-config-client
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        namespace: 68468122-8955-45ee-a5b7-3d87972325b1

4. 配置dataId

dataId 对应 步骤2 里面的 dataId，有两种配置方式，一种是官方自动构建 dataId ，另一种是指定 dataId。

4.1 自动配置 dataId

在 Nacos Spring Cloud 中，dataId的完整格式如下：

${prefix}-${spring.profiles.active}.${file-extension}

prefix 默认为 spring.application.name 的值，也可以通过配置项 spring.cloud.nacos.config.prefix 来配置。
spring.profiles.active 即为当前环境对应的 profile。注意：当 spring.profiles.active 为空时，对应的连接符 - 也将不存在， dataId 的拼接格式变成 ${prefix}.${file-extension}
file-exetension 为配置内容的数据格式，可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

比如项目名称为 nacos-config-client，当前环境为 test,格式文件为 properties，那就需要新建一个 dataId 为 nacos-config-client.properties 配置。

4.2 手动设置 dataId

在 NacosConfigProperties 类里面 name 字段就是配置 dataId：

public class NacosConfigProperties {
  /**
	 * nacos config dataId name.
	 */
	private String name;
  //省略其他配置
}

在 bootstrap.yml 添加 spring.cloud.nacos.config.name 就可以设置 dataId。

5.获取数据

通过 @Value 就能获取配置文件的数据：

@Component
@RefreshScope
public class TestConfig {

    @Value(value = "${user.name:null}")
    private String test;

    public String getTest(){
        return test;
    }

要实现配置的自动更新，需要添加 Spring Cloud 原生注解 @RefreshScope。 controller 直接调用即可:

@RestController
public class TestController {

    @Autowired
    private TestConfig testConfig;

    @GetMapping("/config")
    public String testConfig(){
        String config = testConfig.getTest();
        return config;
    }
}

如果想通过 @NacosValues 注解获取数据，需要引入 nacos-config-spring-boot-starter 依赖：

<dependency>
    <groupId>com.alibaba.boot</groupId>
    <artifactId>nacos-config-spring-boot-starter</artifactId>
    <version>0.2.7</version>
</dependency>

总结

nacos-config 配置首先添加 spring-cloud-starter-alibaba-nacos-config 依赖。
在配置列表添加配置
bootstrap.properties 添加 nacos server 地址和 namespace
配置 dataId 有两种方式
- 手动配置，配置 spring.cloud.nacos.config.name
- 自动配置，根据 ${prefix}-${spring.profiles.active}.${file-extension} 规则配置，其中 prefix 为项目名称， spring.profiles.active 为项目运行环境， file-extension 配置内容的数据格式。
通过 @Value(value = "${user.name:null}") 设置在字段上就能获取到属性，要实现自动更新配置需要添加 @RefreshScope 注解。

源码

Github源码

参考

0 赞

所属分类： 前端技术
本文标签： Spring Boot
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/3GlYwi