Spring Cloud Alibaba系列使用（一）----Nacos动态配置

今天药忘吃喽~ 2022-12-06 15:54 160阅读 0赞

Nacos 是 Alibaba 公司推出的开源工具，用于实现分布式系统的服务发现与配置管理。英文全称 Dynamic Naming and Configuration Service，Na 为 Naming/NameServer 即注册中心，co 为 Configuration 即配置中心，Service 是指该注册/配置中心都是以服务为核心。服务（Service）是 Nacos 世界的一等公民。

> 官网是这样说的：一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。

Nacos 致力于发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集，可以快速实现动态服务发现、服务配置、服务元数据及流量管理。

Nacos 可以更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构的服务基础设施。

使用 Nacos 简化服务发现、配置管理、服务治理及管理的解决方案，让微服务的发现、管理、共享、组合更加容易。

Nacos 官网：[https://nacos.io/zh-cn/][https_nacos.io_zh-cn]

Github：[https://github.com/alibaba/nacos][https_github.com_alibaba_nacos]

## ***2***|***0*****Nacos 安装** ##

### ***2***|***1*****环境准备** ###

Nacos 依赖 Java 环境来运行。如果您是从代码开始构建并运行 Nacos，还需要为此配置 Maven 环境，请确保是在以下版本环境中安装使用:

*  JDK 1.8+；
 *  Maven 3.2.x+。

### ***2***|***2*****下载源码或者安装包** ###

可以通过源码和发行包两种方式来获取 Nacos。

**源码方式**

从 Github 上下载源码方式。

git clone https://github.com/alibaba/nacos.git
    cd nacos/
    mvn -Prelease-nacos -Dmaven.test.skip=true clean install -U  
    ls -al distribution/target/
    
    // change the $version to your actual path
    cd distribution/target/nacos-server-$version/nacos/bin

**发行包方式**

您可以从 [https://github.com/alibaba/nacos/releases][https_github.com_alibaba_nacos_releases] 下载最新稳定版本的 `nacos-server` 包。

### ***2***|***3*****启动服务器** ###

**Linux/Unix/Mac**

在 Nacos 的解压目录 `nacos/bin` 目录下启动。

启动命令（standalone 代表着单机模式运行，非集群模式）:

sh startup.sh -m standalone

如果您使用的是 ubuntu 系统，或者运行脚本报错提示符号找不到，可尝试如下运行：

bash startup.sh -m standalone

**Windows**

启动命令：

cmd startup.cmd

或者双击 `startup.cmd` 运行文件。

### ***2***|***4*****访问** ###

访问：[http://localhost:8848/nacos/][http_localhost_8848_nacos] ，默认用户名/密码是 nacos/nacos。

[![format_png][]][format_png 1]

[![format_png 2][]][format_png 2 1]

### ***2***|***5*****关闭服务器** ###

**Linux/Unix/Mac**

sh shutdown.sh

**Windows**

cmd shutdown.cmd

或者双击 `shutdown.cmd` 运行文件。

## ***3***|***0*****配置 MySQL 数据库** ##

Nacos 在 `0.7` 版本之前，默认使用的是嵌入式数据库 `Apache Derby` 来存储数据（内嵌的数据库会随着 Nacos 一起启动，无需额外安装）；`0.7` 版本及以后，增加了对 `MySQL` 数据源的支持。

### ***3***|***1*****MySQL数据源** ###

环境要求：MySQL 5.6.5+（生产使用建议至少主备模式，或者采用高可用数据库）；

**初始化 MySQL 数据库**

创建数据库 `nacos_config`。

SQL源文件地址：[https://github.com/alibaba/nacos/blob/master/distribution/conf/nacos-mysql.sql][https_github.com_alibaba_nacos_blob_master_distribution_conf_nacos-mysql.sql] ，或者在 `nacos-server` 解压目录 `conf` 下，找到 `nacos-mysql.sql` 文件，运行该文件，结果如下：

[![format_png 3][]][format_png 3 1]

**application.properties 配置**

修改 `nacos/conf/application.properties` 文件的以下内容。

[![format_png 4][]][format_png 4 1]

最终修改结果如下：

#*************** Config Module Related Configurations ***************#
    ### If user MySQL as datasource:
    # 指定数据源为 MySQL
    spring.datasource.platform=mysql
    
    ### Count of DB:
    # 数据库实例数量
    db.num=1
    
    # 数据库连接信息，如果是 MySQL 8.0+ 版本需要添加 serverTimezone=Asia/Shanghai
    ### Connect URL of DB:
    db.url.0=jdbc:mysql://127.0.0.1:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&serverTimezone=Asia/Shanghai
    db.user=root
    db.password=1234

> 如果你和我一样使用的是 MySQL 8.0+ 版本，那么启动 Nacos 时肯定会报错。莫慌，在 Nacos 安装目录下新建 `plugins/mysql` 文件夹，并放入 8.0+ 版本的 mysql-connector-java-8.0.xx.jar，重启 Nacos 即可，启动时会提示更换了 MySQL 的 driver-class 类。

[![format_png 5][]][format_png 5 1]

## ***4***|***0*****Nacos 配置入门** ##

`nacos-config-demo` 聚合工程。`SpringBoot 2.3.0.RELEASE`、`Spring Cloud Hoxton.SR5`。

### ***4***|***1*****发布配置** ###

选择 `配置管理` 的 `配置列表` 页面，点击最右侧 `+` 按钮新建配置。

[![format_png 6][]][format_png 6 1]

Nacos Config 使用 `Data ID` 和 `Group` 来确定配置。

下图显示 `Data Id` 为 `product-service.yaml`，组使用默认组，并添加 `yaml` 格式的配置信息。

[![format_png 7][]][format_png 7 1]

project:
      name: SpringCloudAlibaba
      org: Aliababa

### ***4***|***2*****获取配置** ###

**创建项目**

我们创建聚合项目来讲解 Nacos，首先创建一个 pom 父工程。

[![format_png 8][]][format_png 8 1]

[![format_png 9][]][format_png 9 1]

**添加依赖**

pom.xml

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        
        <groupId>org.example</groupId>
        
        <artifactId>nacos-config-demo</artifactId>
        
        <version>1.0-SNAPSHOT</version>
    
        
        
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.3.0.RELEASE</version>
        </parent>
    
        
        <properties>
            
            <spring-cloud.version>Hoxton.SR5</spring-cloud.version>
            
            <spring-cloud-alibaba.version>2.1.0.RELEASE</spring-cloud-alibaba.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>${spring-cloud-alibaba.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
    </project>

**商品服务 product-service**

**创建项目**

在刚才的父工程下创建一个 `product-service` 项目。

**添加依赖**

主要添加 `spring-cloud-starter-alibaba-nacos-config` 依赖。

<dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>

完整依赖如下：

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    
        
        <parent>
            <artifactId>nacos-config-demo</artifactId>
            <groupId>org.example</groupId>
            <version>1.0-SNAPSHOT</version>
        </parent>
        <modelVersion>4.0.0</modelVersion>
    
        <artifactId>product-service</artifactId>
    
        
        <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.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <scope>provided</scope>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
                <exclusions>
                    <exclusion>
                        <groupId>org.junit.vintage</groupId>
                        <artifactId>junit-vintage-engine</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
        </dependencies>
    
    </project>

**配置文件**

在 `bootstrap.yml` 中配置 Nacos Server 的地址和应用名。

> 说明：之所以需要配置 `spring.application.name`，是因为它是构成 Nacos 配置管理 `dataId`字段的一部分。

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

`    ${prefix}-${spring.profile.active}.${file-extension}`

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

**控制层**

使用 Spring 的 `@Value` 注解来获取配置信息，`${}` 中对应 Nacos 配置中心配置内容的 key，`:`后跟默认值。

并且通过 Spring Cloud 原生注解 `@RefreshScope` 实现配置自动更新。

package org.example.controller;
    
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.cloud.context.config.annotation.RefreshScope;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import java.util.HashMap;
    import java.util.Map;
    
    @RefreshScope
    @RestController
    public class ConfigController {
    
        @Value("${project.name:}")
        private String projectName;
    
        @Value("${project.org:}")
        private String projectOrg;
    
        @GetMapping("/config")
        public Map<String, Object> getConfig() {
            Map<String, Object> configMap = new HashMap();
            configMap.put("projectName", projectName);
            configMap.put("projectOrg", projectOrg);
            return configMap;
        }
    
    }

**启动类**

package org.example;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class ProductServiceApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(ProductServiceApplication.class, args);
        }
    
    }

**测试**

访问：[http://localhost:7070/config][http_localhost_7070_config] 结果如下：

[![format_png 10][]][format_png 10 1]

修改配置为以下内容，重新发布：

project:
      name: SpringCloudAlibaba-Nacos
      org: Aliababa

[![format_png 11][]][format_png 11 1]

控制台打印信息如下：

c.a.c.n.c.NacosPropertySourceBuilder     : Loading nacos data, dataId: 'product-service.yaml', group: 'DEFAULT_GROUP'
    b.c.PropertySourceBootstrapConfiguration : Located property source: [BootstrapPropertySource {name='bootstrapProperties-product-service.yaml'}]
    o.s.boot.SpringApplication               : No active profile set, falling back to default profiles: default
    o.s.boot.SpringApplication               : Started application in 3.356 seconds (JVM running for 50.676)
    o.s.c.e.event.RefreshEventListener       : Refresh keys changed: [project.name]

访问：[http://localhost:7070/config][http_localhost_7070_config] 结果如下：

[![format_png 12][]][format_png 12 1]

## ***5***|***0*****Nacos 配置核心概念** ##

[![format_png 13][]][format_png 13 1]

### ***5***|***1*****配置** ###

> 为什么需要配置？概念。

在系统开发过程中，开发者通常会将一些需要变更的参数、变量等从代码中分离出来独立管理，以独立的配置文件的形式存在。目的是让静态的系统工件或者交付物（如 WAR，JAR 包等）更好地和实际的物理运行环境进行适配。配置管理一般包含在系统部署的过程中，由系统管理员或者运维人员完成。配置变更是调整系统运行时的行为的有效手段。

### ***5***|***2*****配置管理** ###

> 对配置的多维度管理。

系统配置的编辑、存储、分发、变更管理、历史版本管理、变更审计等所有与配置相关的活动。

### ***5***|***3*****配置项** ###

> 一个键值对 Key = Value。

一个具体的可配置的参数与其值域（一个键值对），通常以 param-key=param-value 的形式存在。例如我们常配置系统的日志输出级别（logLevel=INFO|WARN|ERROR） 就是一个配置项。

### ***5***|***4*****配置集** ###

> 多个键值对，一般指一个配置文件。

一组相关或者不相关的配置项的集合称为配置集（多个键值对/一个配置文件）。在系统中，一个配置文件通常就是一个配置集，包含了系统各个方面的配置。例如，一个配置集可能包含了数据源、线程池、日志级别等配置项。

### ***5***|***5*****配置集 ID** ###

> 给这个配置文件起一个全局唯一的 ID。

Nacos 中的某个配置集的 ID。配置集 ID 是组织划分配置的维度之一。Data ID 通常用于组织划分系统的配置集。一个系统或者应用可以包含多个配置集，每个配置集都可以被一个有意义的名称标识。Data ID 通常采用类 Java 包（如 com.taobao.tc.refund.log.level）的命名规则保证全局唯一性。此命名规则非强制。

### ***5***|***6*****配置分组** ###

> 多个配置文件放在一起，形成组，一般用于区分项目。例如，某学校多应用之间的区分，教师应用 TEACHER\_GROUP，学生应用 STUDENT\_GROUP。

Nacos 中的一组配置集，是组织配置的维度之一。通过一个有意义的字符串（如 Buy 或 Trade ）对配置集进行分组，从而区分 Data ID 相同的配置集。当您在 Nacos 上创建一个配置时，如果未填写配置分组的名称，则配置分组的名称默认采用 DEFAULT\_GROUP 。配置分组的常见场景：不同的应用或组件使用了相同的配置类型，如 database\_url 配置和 MQ\_topic 配置。

### ***5***|***7*****配置快照** ###

> 缓存配置信息。

Nacos 的客户端 SDK 会在本地生成配置的快照。当客户端无法连接到 Nacos Server 时，可以使用配置快照显示系统的整体容灾能力。配置快照类似于 Git 中的本地 commit，也类似于缓存，会在适当的时机更新，但是并没有缓存过期（expiration）的概念。

### ***5***|***8*****命名空间** ###

> 区分环境，比如：dev、test、prod 等等。

用于进行租户粒度的配置隔离。不同的命名空间下，可以存在相同的 Group 或 Data ID 的配置。Namespace 的常用场景之一是不同环境的配置的区分隔离，例如开发测试环境和生产环境的资源（如配置、服务）隔离等。

### ***5***|***9*****最佳实践** ###

通常我们可以这样定义 Namespace，Group，DataId：

*  `Namespace`：代表不同的**环境**，如：开发、测试， 生产等；
 *  `Group`：代表某个**项目**，如：XX物流项目，XX教育项目；
 *  `DataId`：每个项目下往往有若干个**应用**，每个配置集(DataId)是一个应用的**主配置文件**

[![format_png 14][]][format_png 14 1]

## ***6***|***0*****Namespace 命名空间** ##

前面已经介绍过命名空间的概念，用于隔离多个环境，而每个应用在不同环境的同一个配置（如数据库数据源）的值是不一样的。因此，我们针对企业项目实际研发流程和环境进行规划。

如某软件公司拥有开发、测试、生产三套环境，那么我们应该建立三个 Namespace 进行区分。

### ***6***|***1*****创建命名空间** ###

点击左侧菜单 `命名空间`，看到默认有一个 `public(保留空间)`，点击右侧 `新建命名空间`进行创建。

[![format_png 15][]][format_png 15 1]

按下图的方式分别创建 `dev(开发环境)`、`test(测试环境)`、`prod(生产环境)` 三个命名空间。

[![format_png 16][]][format_png 16 1]

最终结果如下：

[![format_png 17][]][format_png 17 1]

### ***6***|***2*****指定命名空间** ###

如果 `spring.cloud.nacos.config.namespace` 中没有指定名称空间，则使用 Nacos 的 public(保留空间)。还可以按以下方式指定自定义名称空间：

spring.cloud.nacos.config.namespace=b3404bc0-d7dc-4855-b519-570ed34b62d7

> 此配置必须在 bootstrap.yml 文件中。 spring.cloud.nacos.config.namespace 的值是命名空间的 ID，可以从 Nacos 控制台中检索 ID 的值。 添加配置时，请勿选择其他名称空间。 否则，将无法正确检索配置。

### ***6***|***3*****发布配置** ###

选择 `配置管理` 的 `配置列表` 页面，选择 `dev` 环境，点击最右侧 `+` 按钮新建配置。

[![format_png 18][]][format_png 18 1]

Nacos Config 使用 `Data ID` 和 `Group` 来确定配置。

下图显示 `Data Id` 为 `product-service.yaml`，组使用默认组，并添加 `yaml` 格式的配置信息。

[![format_png 19][]][format_png 19 1]

project:
      name: SpringCloudAlibaba-DEV
      org: Aliababa

### ***6***|***4*****获取配置** ###

**配置文件**

bootstrap.yml

**控制层**

使用 Spring 的 `@Value` 注解来获取配置信息，`${}` 中对应 Nacos 配置中心配置内容的 key，`:`后跟默认值。

并且通过 Spring Cloud 原生注解 `@RefreshScope` 实现配置自动更新。

**测试**

访问：[http://localhost:7070/config][http_localhost_7070_config] 结果如下：

[![format_png 20][]][format_png 20 1]

## ***7***|***0*****Group 组** ##

Group 组信息可以在新建配置时进行指定，如下图：

[![format_png 21][]][format_png 21 1]

## ***8***|***0*****配置管理** ##

这一小节我们通过大量配图演示控制台的相关操作。

### ***8***|***1*****新建/编辑/删除/查询** ###

右侧 `+` 新建配置。单条编辑或删除选择操作栏中的编辑或删除。批量删除勾选以后选择左下角红色删除。

[![format_png 22][]][format_png 22 1]

可以通过 `Data Id` 和 `Group` 查询配置，还可以将查询结果导出。

[![format_png 23][]][format_png 23 1]

### ***8***|***2*****导入/导出/克隆** ###

前文提到命名空间用于隔离多个环境，每个应用在不同环境的同一个配置（如数据库数据源）的值是不一样的。也就是说可能大量的配置项都是相同的，个别差异的配置项需要额外修改，在这种情况下，如果一条条重新添加肯定非常不友好，我们可以通过导入导出功能实现。

比如，我们将 `dev` 环境下的配置先全选导出。

[![format_png 24][]][format_png 24 1]

然后在 `test` 环境中导入，文件上传后将直接导入配置，请务必谨慎操作！

[![format_png 25][]][format_png 25 1]

通过克隆也可以达到相同的效果，不同的是克隆可以额外修改 `Data Id` 和 `Group` 信息。

[![format_png 26][]][format_png 26 1]

### ***8***|***3*****历史/回滚** ###

选择 `配置管理` 的 `历史版本` 页面，通过 `Data Id` 和 `Group` 查询历史，可以查看每个历史版本的详情，或选择回滚至该版本。

[![format_png 27][]][format_png 27 1]

### ***8***|***4*****监听查询** ###

Nacos 提供配置订阅者，也就是监听者查询能力，同时提供客户端当前配置的 MD5 校验值，以便帮助用户更好的检查配置变更以后是否推送到 Client 端。

选择 `配置管理` 的 `监听查询` 页面，通过 `配置或IP`、`Data Id` 和 `Group` 查询。

[![format_png 28][]][format_png 28 1]

## ***9***|***0*****权限控制** ##

Nacos 提供了基于 RBAC 的权限控制，通过左侧 `权限控制` 菜单的 `用户列表`、`角色管理`、`权限管理`实现，可以算是傻瓜式操作了，鼠标多点几下就会了。

[![format_png 29][]][format_png 29 1]

## ***10***|***0*****公共配置** ##

每个配置集对应一个应用，但是开发时我们可能会有一些公共配置被多个应用使用，这时候就需要扩展配置集或共享配置集来实现了。

### ***10***|***1*****扩展配置集** ###

我们先创建三个配置集，如下：

Data ID: ext-config-common01.yaml
    Group: DEFAULT_GROUP
    Configuration format: YAML
    Configuration content: common.name: common-service
    
    Data ID: ext-config-common02.yaml
    Group: GLOBAL_GROUP
    Configuration format: YAML
    Configuration content: global.name: global-service
    
    Data ID: ext-config-common03.yaml
    Group: REFRESH_GROUP
    Configuration format: YAML
    Configuration content: refresh.name: refresh-service

[![format_png 30][]][format_png 30 1]

**获取配置**

**配置文件**

bootstrap.yml

server:
      port: 7070 # 端口
    
    spring:
      application:
        name: product-service # 应用名称
      cloud:
        nacos:
          config:
            enabled: true # 如果不想使用 Nacos 进行配置管理，设置为 false 即可
            server-addr: 127.0.0.1:8848 # Nacos Server 地址
            group: MALL_GROUP # 组，默认为 DEFAULT_GROUP
            file-extension: yaml # 配置内容的数据格式，默认为 properties
            namespace: 450a3f07-08ee-49f6-8213-9b04b06cd3cc # 对应 dev 环境
            # 扩展配置集
            ext-config[0]:
              data-id: ext-config-common01.yaml # 配置集 id
            ext-config[1]:
              data-id: ext-config-common02.yaml # 配置集 id
              group: GLOBAL_GROUP # 组，默认为 DEFAULT_GROUP
            ext-config[2]:
              data-id: ext-config-common03.yaml # 配置集 id
              group: REFRESH_GROUP # 组，默认为 DEFAULT_GROUP
              refresh: true # 是否支持动态刷新

总结：

*  通过配置 `spring.cloud.nacos.config.ext-config[n].data-id` 来支持多个配置集。
 *  通过配置 `spring.cloud.nacos.config.ext-config[n].group` 来定制配置组。如果未指定，则使用默认组。
 *  通过配置 `spring.cloud.nacos.config. config[n].refresh` 来控制该配置集是否支持配置的动态刷新。默认情况下不支持。

**控制层**

使用 Spring 的 `@Value` 注解来获取配置信息，`${}` 中对应 Nacos 配置中心配置内容的 key，`:`后跟默认值。

并且通过 Spring Cloud 原生注解 `@RefreshScope` 实现配置自动更新。

package org.example.controller;
    
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.cloud.context.config.annotation.RefreshScope;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import java.util.HashMap;
    import java.util.Map;
    
    @RefreshScope
    @RestController
    public class ConfigController {
    
        @Value("${common.name:}")
        private String commonName;
    
        @Value("${global.name:}")
        private String globalName;
    
        @Value("${refresh.name:}")
        private String refreshName;
    
        @GetMapping("/extConfig")
        public Map<String, Object> getExtConfig() {
            Map<String, Object> configMap = new HashMap();
            configMap.put("commonName", commonName);
            configMap.put("globalName", globalName);
            configMap.put("refreshName", refreshName);
            return configMap;
        }
    
    }

**测试**

访问：[http://localhost:7070/extConfig][http_localhost_7070_extConfig] 结果如下：

[![format_png 31][]][format_png 31 1]

### ***10***|***2*****共享配置集** ###

通过共享配置集的方式也可以实现公共配置的功能，唯一的区别就是共享配置集无法设置组信息，只获取 DEFAULT\_GROUP。具体实现方式如下：

server:
      port: 7070 # 端口
    
    spring:
      application:
        name: product-service # 应用名称
      cloud:
        nacos:
          config:
            enabled: true # 如果不想使用 Nacos 进行配置管理，设置为 false 即可
            server-addr: 127.0.0.1:8848 # Nacos Server 地址
            group: MALL_GROUP # 组，默认为 DEFAULT_GROUP
            file-extension: yaml # 配置内容的数据格式，默认为 properties
            namespace: 450a3f07-08ee-49f6-8213-9b04b06cd3cc # 对应 dev 环境
            # 共享配置集
            shared-dataids: ext-config-common01.yaml,ext-config-common02.yaml,ext-config-common03.yaml # 多个配置集逗号隔开
            refreshable-dataids: ext-config-common01.yaml # 哪个配置集支持动态刷新

访问：[http://localhost:7070/extConfig][http_localhost_7070_extConfig] 结果如下：

[![format_png 32][]][format_png 32 1]

## ***11***|***0*****配置优先级** ##

Spring Cloud Alibaba Nacos Config 提供了三种从 Nacos 拉取配置的功能：

*  A：通过内部相关规则（应用名、配置内容的数据格式等）自动生成相关的 Data Id 配置；
 *  B：通过配置 `spring.cloud.nacos.config.ext-config[n].data-id` 来支持多个配置集。同时配置多个配置集时，优先级关系根据 `n` 的值决定，值越大，优先级越高；
 *  C：通过配置 `spring.cloud.nacos.config.shared-dataids` 配置多个共享配置集；

当三种方式同时使用时，优先级关系为：A > B > C。

## ***12***|***0*****Nacos 集群环境搭建** ##

集群模式跟我们平时进行扩容是一样的，可以通过 Nginx 转发到多个节点，如下图：

[![format_png 33][]][format_png 33 1]

如果为了方便省事，可以使用直连 ip 模式，配置中按如下编写即可：

spring:
      # 配置 Nacos 配置中心
      cloud:
        nacos:
          config:
            enabled: true # 如果不想使用 Nacos 进行配置管理，设置为 false 即可
            server-addr: 192.168.10.101:8848,192.168.10.102:8848,192.168.10.103:8848 # Nacos 服务器地址

PS：如果只是为了学习的话直接在本地启动 3 个实例，通过修改端口的方式即可。本文使用三台服务器的方式带大家搭建环境，其实这种方式反而更简单。

### ***12***|***1*****环境准备** ###

Nacos 单节点，也就是我们刚才使用的 `standalone` 模式，默认使用嵌入式数据库实现数据的存储，不方便观察数据存储的基本情况，0.7 版本以后增加了支持 MySQL 数据源能力。集群搭建的时候我们需要将 Nacos 对接 Mysql 进行数据存储。如果要搭建高可用的集群环境，至少要满足以下条件：

*  JDK 1.8+；
 *  Maven 3.2.x+；
 *  MySQL 5.6.5+（生产使用建议至少主备模式，或者采用高可用数据库）；
 *  3个或3个以上Nacos节点才能构成集群。

### ***12***|***2*****下载源码或者安装包** ###

可以通过源码和发行包两种方式来获取 Nacos。

**源码方式**

从 Github 上下载源码方式。

**发行包方式**

您可以从 [https://github.com/alibaba/nacos/releases][https_github.com_alibaba_nacos_releases] 下载最新稳定版本的 `nacos-server` 包。

### ***12***|***3*****配置集群配置文件** ###

将安装包解压。

tar -zxvf nacos-server-1.3.0.tar.gz -C /usr/local/ # 解压文件至 local 目录

在 Nacos 的解压目录 `nacos/conf` 目录下，复制配置文件 `cluster.conf.example` 并重命名为 `cluster.conf`，每行配置成 `ip:port`。（请配置3个或3个以上节点）

192.168.10.101:8848
    192.168.10.102:8848
    192.168.10.103:8848

### ***12***|***4*****配置 MySQL 数据库** ###

### ***12***|***5*****MySQL数据源** ###

环境要求：MySQL 5.6.5+（生产使用建议至少主备模式，或者采用高可用数据库）；

**初始化 MySQL 数据库**

创建数据库 `nacos_config`。

[![format_png 34][]][format_png 34 1]

**application.properties 配置**

修改 `nacos/conf/application.properties` 文件的以下内容。

[![format_png 35][]][format_png 35 1]

最终修改结果如下：

[![format_png 36][]][format_png 36 1]

### ***12***|***6*****启动服务器** ###

**Linux/Unix/Mac**

在 Nacos 的解压目录 `nacos/bin` 目录下启动。

启动命令（在没有参数模式，是集群模式）:     sh startup.sh

### ***12***|***7*****查看启动记录** ###

可通过 `/nacos/logs/nacos.log`（详细日志）或 `/nacos/conf/start.out`（启动记录）的输出内容查看是否启动成功。

查看命令：

tail -f /usr/local/nacos/logs/start.out

启动成功输出结果：

2020-04-29 22:47:56,204 INFO Nacos is starting...
    
    2020-04-29 22:47:56,556 INFO Nacos logs files: /usr/local/nacos/logs/
    
    2020-04-29 22:47:56,556 INFO Nacos conf files: /usr/local/nacos/conf/
    
    2020-04-29 22:47:56,556 INFO Nacos data files: /usr/local/nacos/data/
    
    2020-04-29 22:47:56,556 INFO Nacos started successfully in cluster mode.

### ***12***|***8*****访问** ###

访问以下链接，默认用户名/密码是 nacos/nacos ：

*  [http://192.168.10.101:8848/nacos/][http_192.168.10.101_8848_nacos]
 *  [http://192.168.10.102:8848/nacos/][http_192.168.10.102_8848_nacos]
 *  [http://192.168.10.103:8848/nacos/][http_192.168.10.103_8848_nacos]

[![format_png 37][]][format_png 37 1]

从下图可以看到集群节点共有三个，其中 `192.168.10.101:8848` 为 `leader`。

[![format_png 38][]][format_png 38 1]

### ***12***|***9*****关闭服务器** ###

**Linux/Unix/Mac**

sh shutdown.sh

### ***12***|***10*****测试** ###

**直连 ip 模式**

**发布配置**

选择 `配置管理` 的 `配置列表` 页面，点击最右侧 `+` 按钮新建配置。

Data ID: product-service.yaml
    Group: DEFAULT_GROUP
    Configuration format: YAML
    Configuration content: project.name: SpringCloudAlibaba
                           project.org: Aliababa

**获取配置**

bootstrap.yml

server:
      port: 7070 # 端口
    
    spring:
      application:
        name: product-service # 应用名称
      cloud:
        nacos:
          config:
            enabled: true # 如果不想使用 Nacos 进行配置管理，设置为 false 即可
            server-addr: 192.168.10.101:8848,192.168.10.102:8848,192.168.10.103:8848 # Nacos 服务器地址，集群版直连 ip 模式
            group: DEFAULT_GROUP # 组，默认为 DEFAULT_GROUP
            file-extension: yaml # 配置内容的数据格式，默认为 properties

使用之前的控制层代码，访问：[http://localhost:7070/config][http_localhost_7070_config] 结果如下：

[![format_png 10][]][format_png 10 1]

**Nginx 转发**

再启动一台服务器 `192.168.10.100`，安装 Nginx，配置代理转发规则。

upstream nacos {
        server 192.168.10.101:8848;
        server 192.168.10.102:8848;
        server 192.168.10.103:8848;
    }

[![format_png 39][]][format_png 39 1]

**获取配置**

bootstrap.yml

server:
      port: 7070 # 端口
    
    spring:
      application:
        name: product-service # 应用名称
      cloud:
        nacos:
          config:
            enabled: true # 如果不想使用 Nacos 进行配置管理，设置为 false 即可
            server-addr: 192.168.10.100:80 # Nacos 服务器地址，集群版 Nginx 转发
            group: DEFAULT_GROUP # 组，默认为 DEFAULT_GROUP
            file-extension: yaml # 配置内容的数据格式，默认为 properties

使用之前的控制层代码，访问：[http://localhost:7070/config][http_localhost_7070_config] 结果如下：

[![format_png 10][]][format_png 10 1]

至此 Nacos 配置中心所有的知识点就讲解结束了。

[参考][Link 1]

[参考][Link 2]

[https_nacos.io_zh-cn]: https://nacos.io/zh-cn/
[https_github.com_alibaba_nacos]: https://github.com/alibaba/nacos
[https_github.com_alibaba_nacos_releases]: https://github.com/alibaba/nacos/releases
[http_localhost_8848_nacos]: http://localhost:8848/nacos/
[format_png]: /images/20221123/4593519751784b70909c846c2d8b886c.png
[format_png 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb8196b2220de?w=1358&h=678&f=png&s=57575
[format_png 2]: /images/20221123/8b2f0db4645f4dbd90fd0ab141b946b2.png
[format_png 2 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819693ae028?w=1383&h=492&f=png&s=33549
[https_github.com_alibaba_nacos_blob_master_distribution_conf_nacos-mysql.sql]: https://github.com/alibaba/nacos/blob/master/distribution/conf/nacos-mysql.sql
[format_png 3]: /images/20221123/18ffe2d6682e46a8bf73cabcd71f5446.png
[format_png 3 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81968d85d86?w=243&h=301&f=png&s=7546
[format_png 4]: /images/20221123/25bc0cb9ef0d423c984db4d659887efc.png
[format_png 4 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb8196a6b21bc?w=743&h=251&f=png&s=23245
[format_png 5]: /images/20221123/d05b9bb6967f485c80a26535309ba1fa.png
[format_png 5 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81968ba5b69?w=983&h=61&f=png&s=4426
[format_png 6]: /images/20221123/74cc9264501a469bbb204b1f5cd4fcd7.png
[format_png 6 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819b0fbf608?w=1376&h=487&f=png&s=35971
[format_png 7]: /images/20221123/011b6dc92b534aa29ae4c7e545ffc525.png
[format_png 7 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819c99a6c40?w=920&h=584&f=png&s=26003
[format_png 8]: /images/20221123/91c1595ec3294598a751c563052c7aa7.png
[format_png 8 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819ce5e1e7e?w=629&h=493&f=png&s=52501
[format_png 9]: /images/20221123/9a6b98f831804c5d807ba49ba8a88ce1.png
[format_png 9 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819dc20ce35?w=629&h=493&f=png&s=18412
[http_localhost_7070_config]: http://localhost:7070/config
[format_png 10]: /images/20221123/9bce6c0b48f4476f9e8acbc2c3f66cab.png
[format_png 10 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819dcaaf692?w=364&h=135&f=png&s=12259
[format_png 11]: /images/20221123/9ff2dc42dc264a7fa2b30f784a0ce143.png
[format_png 11 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819ec651419?w=1198&h=333&f=png&s=28318
[format_png 12]: /images/20221123/ec78f5940c814e73a0af36bbf73469fb.png
[format_png 12 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819fabe48f4?w=399&h=130&f=png&s=13232
[format_png 13]: /images/20221123/9da548124785470aa28ed272efacc462.png
[format_png 13 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a0882bc08?w=688&h=582&f=jpeg&s=78225
[format_png 14]: /images/20221123/6843ce3fc992406a869ecebe03aa1e6c.png
[format_png 14 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb819fbe56e20?w=1280&h=396&f=png&s=92717
[format_png 15]: /images/20221123/cffaab96fc2044dc94d514e3e9cd3d00.png
[format_png 15 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a2af380f8?w=1378&h=490&f=png&s=28495
[format_png 16]: /images/20221123/0097dfa977c2444e920b25baa3802348.png
[format_png 16 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a2aebd6bc?w=703&h=333&f=png&s=11294
[format_png 17]: /images/20221123/ffb4b55341144daabb2ec8cdb0002799.png
[format_png 17 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a5cc2a06c?w=1197&h=330&f=png&s=23485
[format_png 18]: /images/20221123/cc23189e7f444611a70eccbc6df28f4b.png
[format_png 18 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a63a68440?w=1196&h=316&f=png&s=23064
[format_png 19]: /images/20221123/ef174364d0e345a4a358de34efe048e9.png
[format_png 19 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a8b4673bc?w=921&h=588&f=png&s=26422
[format_png 20]: /images/20221123/caedcfb5341846368d7553bd7bb594ed.png
[format_png 20 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a92850317?w=380&h=133&f=png&s=12913
[format_png 21]: /images/20221123/36282a1fc56a4debad7afc61c3bfef13.png
[format_png 21 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81a93c1bf90?w=907&h=561&f=png&s=25644
[format_png 22]: /images/20221123/64dd3018d25643d3839ee046f8b19147.png
[format_png 22 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81aa999283d?w=1197&h=336&f=png&s=32331
[format_png 23]: /images/20221123/a74900d931bd4214a50de19b9d5ac2ab.png
[format_png 23 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81aa9d72345?w=1196&h=330&f=png&s=30594
[format_png 24]: /images/20221123/d7e19a3eaff3474da91ce56b230f9941.png
[format_png 24 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81ab054fb25?w=1196&h=330&f=png&s=30271
[format_png 25]: /images/20221123/310e5e4b3e294e53906023fc03d1e504.png
[format_png 25 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81acd9433d0?w=1190&h=397&f=png&s=35761
[format_png 26]: /images/20221123/ba8f9648c9f046ab9237286490a7b4b1.png
[format_png 26 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81ad9abee97?w=1178&h=428&f=png&s=45371
[format_png 27]: /images/20221123/a11eda6c26c247efa772d9993200d8af.png
[format_png 27 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81adb7f2fd7?w=1367&h=479&f=png&s=50274
[format_png 28]: /images/20221123/577cc95f58cf405b85134baff1bb7e81.png
[format_png 28 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81ae78c26fe?w=1374&h=416&f=png&s=29757
[format_png 29]: /images/20221123/06712ff256e54b358633937e0ed450b6.png
[format_png 29 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b08256d23?w=1379&h=485&f=png&s=26040
[format_png 30]: /images/20221123/1bc1075b184e4babbd0b7d07e7096e15.png
[format_png 30 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b183199f3?w=1193&h=472&f=png&s=47853
[http_localhost_7070_extConfig]: http://localhost:7070/extConfig
[format_png 31]: /images/20221123/3e142c9bb3bf47f284b732886acccaa6.png
[format_png 31 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b3e73f460?w=355&h=160&f=png&s=16328
[format_png 32]: /images/20221123/07a065a33dac49c1a849a511f09de143.png
[format_png 32 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b5517fb43?w=359&h=161&f=png&s=12819
[format_png 33]: /images/20221123/444ffcacfe4740b4a100b28c837b4974.png
[format_png 33 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b74242c6c?w=1098&h=324&f=jpeg&s=32568
[format_png 34]: /images/20221123/573981efc8c84dd4892f8b8d476e9b7a.png
[format_png 34 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b5b41daf4?w=243&h=301&f=png&s=7546
[format_png 35]: /images/20221123/9da3df2882a84ed6a390664d095a714c.png
[format_png 35 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b780ab5ac?w=743&h=251&f=png&s=23245
[format_png 36]: /images/20221123/2eeebce5107a40adb661a6bb5f246abd.png
[format_png 36 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b79045260?w=983&h=61&f=png&s=4426
[http_192.168.10.101_8848_nacos]: http://192.168.10.101:8848/nacos/
[http_192.168.10.102_8848_nacos]: http://192.168.10.102:8848/nacos/
[http_192.168.10.103_8848_nacos]: http://192.168.10.103:8848/nacos/
[format_png 37]: /images/20221123/50c747e9300a46f8afc8b10e0114b8ce.png
[format_png 37 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b835723db?w=1059&h=591&f=png&s=99773
[format_png 38]: /images/20221123/32bcec1a038347a9b681bd7504e5ce65.png
[format_png 38 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b86ef092f?w=1362&h=433&f=png&s=32692
[format_png 39]: /images/20221123/5b2a19db3bc9442f96e78ea79e21cc20.png
[format_png 39 1]: https://user-gold-cdn.xitu.io/2020/6/16/172bb81b9657f05a?w=530&h=447&f=png&s=22822
[Link 1]: https://www.cnblogs.com/mrhelloworld/p/nacos-config.html
[Link 2]: https://blog.csdn.net/autfish/article/details/90173658