Spring Cloud 使用 Nacos 作配置中心

发表于 更新于 分类于 阅读次数：

Nacos 是 Spring Cloud Alibaba 核心组件之一，可以用作 Spring Cloud 的注册中心和配置中心。

本文讲述如何在 Spring Cloud 中使用 Nacos 作为配置中心。

安装 Nacos

与 Spring Cloud Config 和 Eureka 的使用方式不同，Nacos Server 需要独立部署。Nacos Server 的部署方式包括单机模式和集群模式，集群模式可以解决 Nacos 高可用的问题。

为简单起见，本文采用单机模式 Nacos Server 作为配置中心。单机模式搭建过程比较简单，可以通过下载源代码编译方式安装和二进制可执行文件安装。

具体安装步骤可以参考官方文档：

https://nacos.io/zh-cn/docs/quick-start.html

安装完成后，使用用户 nacos 和密码 nacos 访问 Nacos 控制台：

图中可以看到访问端口被改成了 8868，而不是 8848。Nacos Server 启动端口的修改也比较简单，修改其配置文件 conf/application.propertie 中端口配置 server.port 即可。

创建 Spring Cloud 项目

利用 IntelliJ Idea 创建 Spring Cloud 项目，其中的父（parent ）项目 springcloudstudy 的 pom.xml 内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.7.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>me.leehao</groupId>
    <artifactId>springcloudstudy</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springcloudstudy</name>
    <description>Demo project for Spring Cloud</description>
    <packaging>pom</packaging>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <spring-cloud.version>Hoxton.SR9</spring-cloud.version>
        <java.version>1.8</java.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>2.2.3.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <modules>
        <module>nacosconfig</module>
    </modules>
</project>

父项目的 pom.xml 定义了 Spring Cloud 和 Spring Cloud Alibaba 依赖版本，这样，各子项目都使用同一版本下的子依赖版本。

接着创建一个名称为 nacosconfig 的 module 。nacosconfig 的 pom.xml 内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>me.leehao</groupId>
        <artifactId>springcloudstudy</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <artifactId>nacosconfig</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>nacosconfig</name>
    <description>Demo project for Spring Cloud Nacos Config</description>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <finalName>${project.name}</finalName>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

nacosconfig 的 pom.xml 继承自 springcloudstudy 的 pom.xml。且引入依赖：

  • spring-cloud-starter-alibaba-nacos-config ：作为 Nacos 客户端读取 Nacos 配置
  • spring-boot-starter-web：对外提供 Web 接口

完整的源代码可以在以下链接下载：

https://github.com/haozlee/springcloudstudy

使用 Nacos 配置

在 nacosconfig 项目 bootstrap.yml 配置文件添加应用名称和 Nacos Server 地址：

1
2
3
4
5
6
7
8
spring:
  application:
    name: nacosconfig
  cloud:
    nacos:
      config:
        server-addr: 10.88.115.137:8868
        file-extension: yaml

之所以需要配置 spring.application.name 的名称，是因为它是构成 Nacos 配置 Data Id 的一部分。Nacos Data Id 完整格式如下:

1
${prefix}-${spring.profiles.active}.${file-extension}
  • prefix：默认为 spring.application.name 的值
  • spring.profiles.active：即当前环境对应的 profile，如果为空，则 -${spring.profiles.active} 为空
  • file-extension：配置内容格式，支持 properties 和 yaml 格式

Nacos Server 有关配置：

  • server-addr：Nacos Server 地址
  • file-extension：Nacos Data Id 配置格式，此处配置为 yaml 格式

即，采用上述配置，nacosconfig 会从 Nacos Server 读取 Data Id 为 nacosconfig.yaml 的配置。

从 Nacos 读取端口配置

在 Nacos 控制台添加一个新的配置，其中：

  • Data Id：nacosconfig
  • Group：DEFAULT_GROUP
  • 配置格式：YAML

配置内容：

1
2
3
4
server:
  port: 9080

user: leolee

启动 nacosconfig 项目，可以看到打印日志：

2021-01-14 11:00:28.146 INFO 25112 — [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 9080 (http)

即说明 nacosconfig 项目监听端口从默认的 8080 改成了 9080。

从 Nacos 读取变量配置

添加一个 REST 接口 /config，读取变量 user 的值：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
package me.leehao.nacosconfig;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;


@RefreshScope
@RestController
public class ConfigController {
    private static final Logger logger = LoggerFactory.getLogger(ConfigController.class);

    @Value("${user:leo}")
    private String user;

    @RequestMapping(value = "/config", method = RequestMethod.GET)
    public String index() {
        logger.info("get user config value from nacos: {}", user);
        return user;
    }
}

为实现配置自动更新，使用了注解 @RefreshScope。

访问 http://localhost:9080/config，返回：

leolee

在 Nacos 控制台修改 nacosconfig 配置，将 user 值修改为 leehao.me，可以看到 nacosconfig 项目打印日志：

2021-01-14 15:44:37.651 INFO 25112 — [88.115.137_8868] c.a.n.client.config.impl.ClientWorker : [fixed-10.88.115.137_8868] [data-received] dataId=nacosconfig, group=DEFAULT_GROUP, tenant=null, md5=396057d762f85e3cfa28e2d2f450e722, content=server:
port: 9080
user: leehao.me, type=yaml

说明 nacosconfig 项目已接收到最新的 Nacos 配置。

访问 http://localhost:9080/config，返回：

leehao.me

配置实现了动态更新。

参考资料