Nacos.02.组件之统一配置中心

拼搏现实的明天。 2022-08-31 15:15 182阅读 0赞

### Nacos组件之统一配置中心 ###

*   *  前言
     *  介绍
     *  核心概念
     *   *  命名空间
         *  Group
         *  Data ID
     *  configclient-profile.properties
     *  Config Client开发
     *   *  1.新建Module
         *  2.pom.xml
         *  3.bootstrap.properties
         *  4.ConfigClientApplication.java
         *  5.TestController.java
         *  6.测试
     *  历史版本

## 前言 ##

前面我们提到过**Nacos**是alibaba提供的既可以作为服务注册中心也可以作为统一配置中心的组件。上一节我们已经了解了其作为服务注册中心简单使用，下面我们来学习一下Nacos作为统一配置中心的简单使用。

## 介绍 ##

之前我们介绍springcloud的统一配置中心组件config的时候，我们知道各服务节点的配置文件是放在远程Git仓库中的，Config Server拉取远程仓库里面的配置文件到本地之后通过负载均衡策略提供给Config Client。

Nacos则不然！相较于Spring Cloud Config，client端的配置文件不需要放在远程仓库中，而是放在Nacos Server中。我们可以在Nacos的管理界面查看client的配置文件，如下图①

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70]

## 核心概念 ##

Nacos中有三个核心概念：**命名空间、Data ID、Group**，分别对应上面的②、③、④。对于不同公司或者不同人对于这三个概念的理解和使用略有差别，但归根结底都是用来区分项目或者服务的。

### 命名空间 ###

Nacos中将命名空间单独作为一个菜单，提供了一个默认的保留空间**public**，默认最大的配置数是200。如下图所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 1]

> 默认的保留空间public是不可以编辑、删除的；
> 
> 每一个命名空间对应一个唯一的ID，Nacos Client的预配置文件中配置命名空间时用到的就是这个ID；

这里我们将命名空间用作隔离每个项目配置文件的作用来使用，我们新建一个命名空间：STUDY，如下图

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 2]

### Group ###

我们站在项目中的每个服务的角度来看，Group的作用就是**用来隔离每个项目中不同服务的配置文件**，通常我们将一个服务归为一个Group。同样的Nacos提供了一个默认Group–`DEFAULT_GROUP`。

如果我们不想使用默认的分组可以在新建项目配置文件的时候修改分组名称。

### Data ID ###

Data ID是获取一个配置文件的唯一标识，通常我们以配置文件的文件名来命名。同一个命名空间的同一个分组下面的Data ID是不能重复的，这样通过`namespace + Group + Data ID`的组合就可以唯一确定一个配置文件。

## configclient-profile.properties ##

我们在配置列表页面右上角点击`+`打开新建配置文件页面，如下图

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 3]

按照下图内容所示添加`configclient-dev.properties`，最后点击发布即可

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 4]

发布成功后我们可以在配置列表中看到我们刚才创建的配置文件

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 5]

> 如果有多个命名空间的话创建配置文件之前记得先选择命名空间

同样我们新建配置文件`configclient-prod.properties`，如下图

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 6]

返回配置文件列表可以看到`configclient-dev.properties`与`configclient-prod.properties`，这样我们后面Config Client所需要的两个配置文件就准备完毕了

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 7]

> 在上述两个配置文件中加上`spring.cloud.nacos.discovery.namespace=50c32b33-b5e8-48ac-a731-7dbb556301f8`，作用是指定当前服务注册到STUDY命名空间。否组默认注册到PUBLIC。

## Config Client开发 ##

### 1.新建Module ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 8]

### 2.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">
        <parent>
            <artifactId>springcloud_alibaba_parent</artifactId>
            <groupId>com.christy</groupId>
            <version>1.0-SNAPSHOT</version>
        </parent>
        <modelVersion>4.0.0</modelVersion>
    
        <artifactId>02.springcloud_alibaba_config_client</artifactId>
    
        <properties>
            <maven.compiler.source>8</maven.compiler.source>
            <maven.compiler.target>8</maven.compiler.target>
        </properties>
    
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
            </dependency>
        </dependencies>
    </project>

### 3.bootstrap.properties ###

# 告诉config server地址
    spring.cloud.nacos.config.server-addr=192.168.8.120:8848
    
    # 告诉从哪个命名空间获取配置
    spring.cloud.nacos.config.namespace=50c32b33-b5e8-48ac-a731-7dbb556301f8
    # 告诉从哪个组进行配置获取
    spring.cloud.nacos.config.group=CONFIG_CLIENT
    
    # 第一种获取配置文件方式 dataId = name + file-extension
    # 从这个组中拉取那个配置文件
    spring.cloud.nacos.config.name=configclient-prod
    # 拉取这个配置那个后缀的配置文件
    spring.cloud.nacos.config.file-extension=properties
    
    # 第二种获取配置文件方式 dataId = prefix + env + file-extension
    # spring.cloud.nacos.config.prefix=configclient
    # spring.profiles.active=prod
    # spring.cloud.nacos.config.file-extension=properties

### 4.ConfigClientApplication.java ###

import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    /** * @Author Christy * @Date 2021/7/22 10:31 **/
    @SpringBootApplication
    public class ConfigClientApplication { 
        public static void main(String[] args) { 
            SpringApplication.run(ConfigClientApplication.class, args);
        }
    }

### 5.TestController.java ###

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.RestController;
    
    /** * @Author Christy * @Date 2021/7/22 10:33 **/
    @RestController
    @RequestMapping("/test")
    @RefreshScope
    public class TestController { 
        private static final Logger log = LoggerFactory.getLogger(TestController.class);
    
        @Value("${customer.username}")
        private String username;
    
        @RequestMapping("/hello")
        public String sayHello() { 
            log.info("Hello," + username);
            return "Hello," + username;
        }
    }

> @RefreshScope不要忘记加了，Nacos另外一个比较强大的功能就是通过这个注解可以自动实现刷新配置文件，而不需要像SpringCloud Config那样通过Bus+webHook的方式来实现自动刷新配置文件

### 6.测试 ###

我们启动服务，在浏览器输入`http://localhost:8811/test/hello`。由于我们访问的prod的配置文件，所以页面显示`Hello,Christy`。如下图：

![在这里插入图片描述][185bcee37729492588d5f5a2ef0b9f7a.png]

我们修改`configclient-prod.properties`配置文件中的username，再次访问结果如下：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 9]

当我们修改username的时候，控制台会显示出修改的键，再次访问浏览器结果也会显示出刷新后的值

## 历史版本 ##

Nacos也可以像git远程仓库一样记录配置文件每次修改的记录，我们可以在`配置管理-历史版本`中输入Data ID和Group进行查询

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 10]

我们可以查看每个版本的具体配置，也可以选择后面的回滚按钮回滚到指定版本，比如我们回滚到上个版本

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 11]

点击`回滚配置`后我们在浏览器中再次访问`http://localhost:8811/test/hello`，输出结果也回到了上个版本，而且回滚的时候控制台也打印出了刷新的键

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 12]

> 本系列专题源码已经上传至gitee：https://gitee.com/tide001/springcloud\_parent，欢迎下载交流

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70]: /images/20220829/f01ba629e8964ab09236abb284401596.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 1]: /images/20220829/5bac46ae11664d3fa8255cb0b8b28f76.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 2]: /images/20220829/e62a090bb99a4f8b89efc4f25bfe8fec.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 3]: /images/20220829/cd5c2c5a7105414ab983d258ee0a1372.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 4]: /images/20220829/cce4cbfa8f6243b680fec4f778e8f441.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 5]: /images/20220829/e3dc7c3c244c4e62bb992772eb0e74a3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 6]: /images/20220829/a37b65b4278443f9918ec0026f839966.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 7]: /images/20220829/05324e7362694577a9323075df1ade1f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 8]: /images/20220829/c597fd70403d4e09a195f56978a51101.png
[185bcee37729492588d5f5a2ef0b9f7a.png]: /images/20220829/15f6cac7c1f441379902160d6f53886e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 9]: /images/20220829/8b42bc6dd1fc4663a87c2daaac3b90f1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 10]: /images/20220829/33f4699a4a524f618d2650ac6828d653.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 11]: /images/20220829/0f79aad441744a1397e8a5e42dc75bbb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JieHlscWYxMjZjb20_size_16_color_FFFFFF_t_70 12]: /images/20220829/880541b155b74b9c93ea44c815fc98ab.png