当前位置：首页 > news >正文

SpringCloudAlibaba基础五 Nacos配置中心

news 来源：原创 2024/9/20 1:25:53

一 Nacos配置中心介绍

官方文档：https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-config
Nacos 提供用于存储配置和其他元数据的 key/value 存储，为分布式系统中的外部化配置提供服务器端和客户端支持。使用 Spring Cloud Alibaba Nacos Config，您可以在 Nacos Server 集中管理你 Spring Cloud 应用的外部属性配置。

1.维护性 2.时效性 3.安全性
在这里插入图片描述

Nacos与springcloud config 对比

三大优势：

springcloud config大部分场景结合git 使用, 动态变更还需要依赖Spring Cloud Bus 消息总线来通过所有的客户端变化.
springcloud config不提供可视化界面
nacos config使用长轮询更新配置, 一旦配置有变动后，通知Provider的过程非常的迅速, 从速度上秒杀springcloud原来的config几条街

二快速开始

2.1 准备配置

nacos server中新建nacosconfig.properties
在这里插入图片描述

默认是properties的扩展名，如果想改为yaml的话，可以参考官网https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-config#:~:text=%E5%9F%BA%E4%BA%8E%20dataId%20%E4%B8%BA%20yaml%20%E7%9A%84%E6%96%87%E4%BB%B6%E6%89%A9%E5%B1%95%E5%90%8D%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F

在这里插入图片描述

最佳实践：

Namespace：代表不同环境，如开发、测试、生产环境。
Group：代表某项目，如XX医疗项目、XX电商项目
DataId：每个项目下往往有若干个工程（微服务），每个配置集(DataId)是一个工程（微服务）的主配置文件

在这里插入图片描述
启动权限：修改conf/application.properties

改完后就可以进行权限设置了

2.2 搭建nacos-config服务

Nacos服务端初始化
在这里插入图片描述

通过 Nacos Server 和 spring-cloud-starter-alibaba-nacos-config 实现配置的动态变更
引入依赖

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

添加bootstrap.properties或bootstrap.yml文件，来配置Nacos地址
在这里插入图片描述

启动服务，测试微服务是否使用配置中心的配置

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.context.ConfigurableApplicationContext;import java.util.concurrent.TimeUnit;@SpringBootApplication
public class ConfigApplication {public static void main(String[] args) throws InterruptedException {ConfigurableApplicationContext applicationContext = SpringApplication.run(ConfigApplication.class, args);while (true) {String userName = applicationContext.getEnvironment().getProperty("user.name");String userAge = applicationContext.getEnvironment().getProperty("user.age");String config = applicationContext.getEnvironment().getProperty("user.config");System.err.println("user name :" + userName + "; age: " + userAge+";config:"+config);TimeUnit.SECONDS.sleep(1);}// nacos客户端 每10ms去 注册中心进行判断，  根据MD5}
}

在这里插入图片描述

2.3 Config相关配置

Nacos 数据模型 Key 由三元组唯一确定, Namespace默认是空串，公共命名空间（public），分组默认是 DEFAULT_GROUP
在这里插入图片描述
支持配置的动态更新

@SpringBootApplication
public class NacosConfigApplication {public static void main(String[] args) throws InterruptedException {ConfigurableApplicationContext applicationContext = SpringApplication.run(NacosConfigApplication.class, args);while(true) {//当动态配置刷新时，会更新到 Enviroment中，因此这里每隔一秒中从Enviroment中获取配置String userName = applicationContext.getEnvironment().getProperty("common.name");String userAge = applicationContext.getEnvironment().getProperty("common.age");System.err.println("common name :" + userName + "; age: " + userAge);TimeUnit.SECONDS.sleep(1);}}}

ps：除了默认的配置文件，其他dataId都要加上后缀（跟服务名相同的dataid的配置文件，称之为默认的配置文件）

支持profile粒度的配置
多套环境使用不同的配置文件

springcloudstarteralibabanacosconfig 在加载配置的时候，不仅仅加载了以 dataid 为${spring.application.name}.${file-extension:properties} 为前缀的基础配置，还加载了dataid为${spring.application.name}-${profile}.${file-extension:properties} 的基础配置。在日常开发中如果遇到多套环境下的不同配置，可以通过Spring 提供的 ${spring.profiles.active} 这个配置项来配置。

1 spring.profiles.active=dev

profile 的配置文件大于默认配置的文件。并且形成互补

ps：只有默认的配置文件，才会应用profile

eg：创建一个dev的配置文件（由于不是默认配置文件，所以必须加后缀，且后缀必须和默认配置文件后缀一样）
在这里插入图片描述
激活dev后，就能读取到了

不建议使用上边这种配置，因为这种没法使用nacos提供的权限配置，而是建议使用下边nacos提供的命名空间的方式来配置（下边的dev和pro是需要手动新建的）

支持自定义 namespace 的配置

namespace指的就是：
在这里插入图片描述
项目里不配置的话，默认使用public命名空间；改为dev命名空间

将public的配置文件克隆一份到dev

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

在没有明确指定 ${spring.cloud.nacos.config.namespace} 配置的情况下，默认使用的是 Nacos 上 Public 这个namespace。如果需要使用自定义的命名空间，可以通过以下配置来实现：

spring.cloud.nacos.config.namespace=71bb9785‐231f‐4eca‐b4dc‐6be446e12ff8

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

在没有明确指定 ${spring.cloud.nacos.config.group} 配置的情况下，默认是DEFAULT_GROUP 。如果需要自定义自己的Group，可以通过以下配置来实现：

spring.cloud.nacos.config.group=DEVELOP_GROUP

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

通过自定义扩展的 Data Id 配置，既可以解决多个应用间配置共享的问题，又可以支持一个应用有多个配置文件

 # 自定义 Data Id 的配置#不同工程的通用配置 支持共享的 DataIdspring.cloud.nacos.config.sharedConfigs[0].data‐id= common.yamlspring.cloud.nacos.config.sharedConfigs[0].group=REFRESH_GROUPspring.cloud.nacos.config.sharedConfigs[0].refresh=true# config external configuration# 支持一个应用多个 DataId 的配置 一定要加扩展名spring.cloud.nacos.config.extensionConfigs[0].data‐id=ext‐config‐common01.propertiesspring.cloud.nacos.config.extensionConfigs[0].group=REFRESH_GROUPspring.cloud.nacos.config.extensionConfigs[0].refresh=truespring.cloud.nacos.config.extensionConfigs[1].data‐id=ext‐config‐common02.propertiesspring.cloud.nacos.config.extensionConfigs[1].group=REFRESH_GROUPspring.cloud.nacos.config.extensionConfigs[1].refresh=true

eg：新建一个配置文件（这个文件的扩展名随意）
在这里插入图片描述

2.4 配置的优先级

Spring Cloud Alibaba Nacos Config 目前提供了三种配置能力从 Nacos 拉取相关的配置。

A: 通过 spring.cloud.nacos.config.shared-configs 支持多个共享 Data Id 的配置
B: 通过 spring.cloud.nacos.config.ext-config[n].data-id 的方式支持多个扩展 Data Id 的配置
C: 通过内部相关规则(应用名、应用名+ Profile )自动生成相关的 Data Id 配置

当三种方式共同使用时，他们的一个优先级关系是:A < B < C
优先级从高到低：

nacosconfigproduct.yaml 精准配置
nacosconfig.yaml 同工程不同环境的通用配置
extconfig: 不同工程扩展配置
shareddataids 不同工程通用配置

2.5 @RefreshScope

@Value注解可以获取到配置中心的值，但是无法动态感知修改后的值，需要利用@RefreshScope注解

@RestController
@RefreshScope
public class TestController {@Value("${common.age}")private String age;@GetMapping("/common")public String hello() {return age;}}