配置中心 Nacos

来源：https://cloud.iocoder.cn/config-center/

1. 配置中心 Nacos

项目使用 Nacos 作为配置中心，实现配置的动态管理。

1.1 搭建 Nacos Server

① 参考《芋道 Nacos 极简入门》文章的「2. 单机部署（最简模式）」或「3. 单机部署（基于 MySQL 数据库）」小节。

② 点击 Nacos 控制台的 [命名空间] 菜单，创建一个 ID 和名字都为 dev 的命名空间，稍后会使用到。如下图所示：

命名空间

注意！新建命名空间时，它的“命名空间ID”、“命名空间名”都要是 dev 噢！！！

1.2 项目接入 Nacos

友情提示：以 yudao-module-system 服务为例子。

1.2.1 引入依赖

在 yudao-module-system-server 模块的 pom.xml 中，引入 Nacos 对应的依赖。如下所示：

<!-- Config 配置中心相关 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

1.2.2 添加配置

① 在 application-local.yaml 中，添加 nacos.config 配置。如下所示：

--- #################### 配置中心相关配置 ####################

spring:
  cloud:
    nacos:
      server-addr: 127.0.0.1:8848 # Nacos 服务器地址
      username: # Nacos 账号
      password: # Nacos 密码
      config: # 【注册中心】配置项
        namespace: dev # 命名空间。这里使用 dev 开发环境
        group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
      ## 注意：如下是原本就有的 discovery 配置，还是需要保留的！！！
      discovery: # 【配置中心】配置项
        namespace: dev # 命名空间。这里使用 dev 开发环境
        group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
        metadata:
          version: 1.0.0 # 服务实例的版本号，可用于灰度发布

spring.cloud.nacos.config.namespace 配置项：设置为 dev，就是刚创建的命名空间

② 在 application.yaml 中，添加 spring.cloud.config.import 配置项。

spring:
  cloud:
    import:
      - optional:classpath:application-${spring.profiles.active}.yaml # 加载【本地】配置
      - optional:nacos:${spring.application.name}-${spring.profiles.active}.yaml # 加载【Nacos】的配置
  ## 注意：如下是原本就有的配置，还是需要保留的！！！不然无法解析上面的配置项。
  application:
    name: system-server # 注意：需要换成你的服务名
  profiles:
    active: local # 注意：需要换成你的环境名，例如说 local

其中 optional:nacos:${spring.application.name}-${spring.profiles.active}.yaml 表示，从 Nacos 加载 dataId 为 system-server-local.yaml 的配置项。

1.2.3 配置管理

友情提示：

如果你不会使用 Nacos 配置中心，可以参考《芋道 Spring Cloud Alibaba 配置中心 Nacos 入门》文档，学习 Nacos 配置中心的使用。

按照需要，将不同环境存在差异的 application-local.yaml 和 application-dev.yaml 中的配置，迁移到 Nacos 配置中心。以 application-local.yaml 为例子。

① 将 application-local.yaml 中，除了如下 Nacos 配置外的配置，迁移到 Nacos 配置中心中。如下图所示：

--- #################### 注册中心 + 配置中心相关配置 ####################

spring:
  cloud:
    nacos:
      server-addr: 127.0.0.1:8848 # Nacos 服务器地址
      username: # Nacos 账号
      password: # Nacos 密码
      discovery: # 【配置中心】配置项
        namespace: dev # 命名空间。这里使用 dev 开发环境
        group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
        metadata:
          version: 1.0.0 # 服务实例的版本号，可用于灰度发布
      config: # 【注册中心】配置项
        namespace: dev # 命名空间。这里使用 dev 开发环境
        group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP

= = 如果把这部分 Nacos 配置也放进去，都不知道 Nacos 地址信息了！！！

新建配置

Data ID 为 ${spring.application.name}-${spring.profiles.active}.yaml，例如说 system-server-local.yaml。
配置格式：YAML 格式
配置内容：将 application-local.yaml 中的配置，迁移到 Nacos 配置中心中。

提示

① 疑问：为什么项目中的 application-{env}.yaml 中的配置，没有放到 Nacos 配置中心中？

回答：主要考虑大家《快速启动》可以更简单。

实际项目中，是建议放到 Nacos 配置中心，进行配置的动态管理的。

② 疑问：是否建议将 application.yaml 中的配置，迁移到 Nacos 配置中心中？

回答：一般情况下，不建议将 application.yaml 中的配置，迁移到 Nacos 配置中心。因为 application.yaml 中的配置，是通用的配置，无需动态管理。

所以目前在大厂里的最佳实践：

固定配置，放在 application.yaml 配置文件
动态配置，按需放在 Nacos 等配置中心
敏感配置，放在 KMS 密钥服务，类似阿里云的密钥管理服务

③ 推荐文章：

《yudao-cloud 将配置文件迁移至 nacos》

2. 配置管理

友情提示：该功能是从 Boot 项目延用到 Cloud 项目，一般情况下不会使用到，使用 Nacos 管理配置即可。

在 [基础设施 -> 配置管理] 菜单，可以查看和管理配置，适合业务上需要动态的管理某个配置。

例如说：创建用户时，需要配置用户的默认密码，这个密码是不会变的，但是有时候需要修改这个默认密码，这个时候就可以通过配置管理来修改。

配置中心

对应的后端代码是 yudao-module-infra 的 config 业务模块。

2.1 配置的表结构

infra_config 的表结构如下：

CREATE TABLE `infra_config` (
    `id` int NOT NULL AUTO_INCREMENT COMMENT '参数主键',
    `group` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '参数分组',
    `type` tinyint NOT NULL COMMENT '参数类型',
    `name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '参数名称',
    `key` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '参数键名',
    `value` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '参数键值',
    `sensitive` bit(1) NOT NULL COMMENT '是否敏感',
    `remark` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
    `creator` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '创建者',
    `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `updater` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '' COMMENT '更新者',
    `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    `deleted` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否删除',
    PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='参数配置表';

key 字段，对应到 Spring Boot 配置文件的配置项，例如说 yudao.captcha.enable、sys.user.init-password 等等。

2.2 后端案例

调用 ConfigApi 的 #getConfigValueByKey(String key) 方法，可以读取指定 key 的参数值。

具体案例，可见 AdminUserServiceImpl 的 #importUserList(...) 方法，在导入 Excel 用户时，它会读取 system.user.init-password 作为用户初始化密码。

2.3 前端案例

后端提供了 /admin-api/infra/config/get-value-by-key RESTful API 接口，返回指定配置项的值。前端的使用示例如下图：

前端案例