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 内容如下：

    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        2.3.7.RELEASE
         
    
    me.leehao
    springcloudstudy
    0.0.1-SNAPSHOT
    springcloudstudy
    Demo project for Spring Cloud
    pom

    
        UTF-8
        Hoxton.SR9
        1.8
    

    
        
            
                org.springframework.cloud
                spring-cloud-dependencies
                ${spring-cloud.version}
                pom
                import
            

            
                com.alibaba.cloud
                spring-cloud-alibaba-dependencies
                2.2.3.RELEASE
                pom
                import
            
        
    

    
        nacosconfig
    

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

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

    4.0.0
    
        me.leehao
        springcloudstudy
        0.0.1-SNAPSHOT
    
    nacosconfig
    0.0.1-SNAPSHOT
    nacosconfig
    Demo project for Spring Cloud Nacos Config
    jar

    
        
            com.alibaba.cloud
            spring-cloud-starter-alibaba-nacos-config
        
        
            org.springframework.boot
            spring-boot-starter-web
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
    

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
                
                    ${project.name}
                
            
        
    

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

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

使用 Nacos 配置

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

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 完整格式如下:

${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
配置内容：
 

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 的值：

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

配置实现了动态更新。