Nacos 提取公共配置

本章将通过在 Spring Cloud 中集成 Nacos,并且通过配置扩展引入多个配置。

Nacos 配置

打开 Nacos 页面,在 dev 命名空间下添加一个名为 “public1”、“public2”、 “nacos_spring_cloud” 的配置集,如下图:

Nacos 提取公共配置

其中,public1 配置集内容如下:

name: public1
key1: value1
age: 20

public2  配置集内容如下:

name: public2
key2: value2
age: 30

nacos_spring_cloud  配置集内容如下:

name: nacos_spring_cloud

创建项目

使用 IDEA 创建 Spring Boot 项目,项目结构如下:

Nacos 提取公共配置

项目依赖

添加 Spring Cloud 和 Spring Cloud Alibaba 依赖到项目 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>
   <parent>
       <groupId>com.hxstrive.nacos</groupId>
       <artifactId>springcloud_alibaba_nacos</artifactId>
       <version>1.0-SNAPSHOT</version>
   </parent>
   <artifactId>nacos_spring_cloud2</artifactId>
   <name>nacos_spring_cloud2</name>

   <properties>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
       <maven.compiler.source>1.8</maven.compiler.source>
       <maven.compiler.target>1.8</maven.compiler.target>
   </properties>

   <!-- 导入所有依赖 -->
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>com.alibaba.cloud</groupId>
               <artifactId>spring-cloud-alibaba-dependencies</artifactId>
               <version>2.1.2.RELEASE</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
           <!-- https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-dependencies -->
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>Greenwich.RELEASE</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
           <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-dependencies -->
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-dependencies</artifactId>
               <version>2.1.3.RELEASE</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>

   <dependencies>
       <!-- Spring Boot Begin -->
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-actuator</artifactId>
       </dependency>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-test</artifactId>
           <scope>test</scope>
       </dependency>
       <!-- Spring Boot End -->

       <!-- Spring Cloud Begin -->
       <dependency>
           <groupId>com.alibaba.cloud</groupId>
           <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
       </dependency>
       <!-- Spring Cloud End -->
   </dependencies>

   <build>
       <plugins>
           <plugin>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
           </plugin>
       </plugins>
   </build>
</project>

配置项目

在项目的 resources 目录下面创建一个 bootstrap.yaml 配置文件,内容如下:

server:
 port: 8080

spring:
 application:
   # 应用名称,用来匹配 Nacos 中的配置集
   # 默认将根据下面指定的 spring.cloud.config.namespace + spring.cloud.config.group + spring.application.name + file-extension
   # 进行匹配,例如:当前应用将匹配
   # 8719efd1-94a6-49f7-9846-2debd66f6c0f 命名空间中 DEFAULT_GROUP 分组下
   # 名为 nacos_spring_cloud 且格式为 yaml 的配置集
   name: nacos_spring_cloud
 cloud:
   nacos:
     config:
       # Nacos 服务地址
       server-addr: 127.0.0.1:8848
       # Nacos 配置文件扩展名
       file-extension: yaml
       # Nacos 命名空间ID
       namespace: 8719efd1-94a6-49f7-9846-2debd66f6c0f
       # Nacos 分组
       group: DEFAULT_GROUP
       # Nacos 登录账号
       username: nacos
       # Nacos 登录密码
       password: nacos
       # 配置扩展
       extension-configs:
         # 如果指定 group,则默认在 DEFAULT_GROUP 组
         # 注意:扩展配置的 data-id 必须和 Nacos 中的 data ID 保持一直
         - data-id: public1.yaml
           group: DEFAULT_GROUP
         # refresh 用来指定是否支持自动刷新
         - data-id: public2.yaml
           group: DEFAULT_GROUP
           refresh: true

项目启动类

创建 BootstrapApp 类,该类其实就是一个简单的 Spring Boot 启动类,并且将该类声明为一个简单的控制器,提供一个 get 方法,用来获取 name 配置信息。代码如下:

package com.hxstrive.nacos;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
* 入口类
* @author hxstrive.com
*/
@SpringBootApplication
@RestController
@RequestMapping("/config")
public class BootstrapApp {
   public static void main(String[] args) {
       SpringApplication.run(BootstrapApp.class, args);
   }

   @Value("${name}")
   private String name;

   @GetMapping("/get")
   public String get() {
       return name;
   }
}

启动&验证

和运行 Spring Boot 项目一样,项目启动成功后,使用浏览器访问 http://localhost:8080/config/get 地址访问配置信息,如下图:

Nacos 提取公共配置

从上图输出可知:

(1)成功将 public1.yaml 和 public2.yaml 配置加载到项目,见 key1、key2 可知;

(2)public1.yaml、public2.yaml 和 nacos_spring_cloud.yaml 三个配置文件,nacos_spring_cloud.yaml 优先级最高,见 name 可知;

(3)public1.yaml、public2.yaml 两个扩展配置,其中数组下标越大优先级越高,见 age = 30 可知,它来源 public2.yaml;

如果我们再创建一个 nacos_spring_cloud.yaml 配置集(刚好等于服务名 + 文件扩展),内容如下:

name: nacos_spring_cloud.yaml

重启应用,输出如下:

Nacos 提取公共配置

从上图输出可知,nacos_spring_cloud.yaml 配置集优先级大于 nacos_spring_cloud 配置优先级。

另外,Nacos 除了提供 extension-configs 扩展配置,还提供了 shared-configs 共享配置。Nacos 中并未对 extension-configs 和 shared-configs 的差别进⾏详细阐述。我们从他们的结构,看不出本质差别;除了优先级不同以外(extension-configs 优先级大于 shared-configs,在 shared-configs 之后加载),也没有其他差别。那么,Nacos 项⽬组为什么要引⼊两个类似的配置呢?我们可以从当初该功能的需求(issue)上找到其原始⽬的:

(1)主配置是应⽤专有的配置,主配置应当在 dataId 上要区分,同时最好还要有 group 的区分,因为 group 区分应⽤。

(2)要在各应⽤之间共享⼀个配置,请使⽤上⾯的 shared-configs,shared-configs 指定的配置,本来应该是不指定 group 的,也就是应当归⼊ DEFAULT_GROUP 这个公共分组。

(3)如果要在特定范围内(⽐如某个应⽤上)覆盖某个共享 dataId 上的特定属性,请使⽤ extension-config

下面是一个示例:

spring:
 application:
   name: nacos-config-multi
 main:
   allow-bean-definition-overriding: true
 cloud:
   nacos:
     username: ${nacos.username}
     password: ${nacos.password}
     config:
       server-addr: ${nacos.server-addr}
       namespace: ${nacos.namespace}
       # 用于共享的配置文件
       shared-configs:
         - data-id: common-mysql.yaml
           group: SPRING_CLOUD_EXAMPLE_GROUP

         - data-id: common-redis.yaml
           group: SPRING_CLOUD_EXAMPLE_GROUP

         - data-id: common-base.yaml
           group: SPRING_CLOUD_EXAMPLE_GROUP

       # 常规配置文件
       # 优先级大于 shared-configs,在 shared-configs 之后加载
       extension-configs:
         - data-id: nacos-config-advanced.yaml
           group: SPRING_CLOUD_EXAMPLE_GROUP
           refresh: true

         - data-id: nacos-config-base.yaml
           group: SPRING_CLOUD_EXAMPLE_GROUP
           refresh: true

其中:

(1)主配置 > 扩展配置(extension-configs) > 共享配置 (shared-configs)

(2)“服务名 + 文件扩展” 优先级大于 “服务名” 配置

(3)同为扩展配置,数组元素对应的下标越⼤,优先级越⾼,如:extension-configs[3] > extension-configs[2] > extension-configs[1] > extension-configs[0]。

(4)同为共享配置,数组元素对应的下标越⼤,优先级越⾼,如:shared-configs[3] > shared-configs[2] > shared-configs[1] > shared-configs[0]。

说说我的看法
全部评论(
没有评论
关于
本网站属于个人的非赢利性网站,转载的文章遵循原作者的版权声明,如果原文没有版权声明,请来信告知:hxstrive@outlook.com
公众号