24小时在线平台

当前位置: 24小时在线平台 > 部署教程大全 > 文章页

bootstrap中如何配置nacos中的namespace nacos配置文件详解

时间:2025-05-30 15:50来源: 作者:admin 点击: 7 次
bootstrap中如何配置nacos中的namespace nacos配置文件详解,目录一、服务配置中心介绍二、NacosConfig入门三、NacosConfig深入3.1配置动态刷新3.2配置共享3.2.1同一个微服务的不同环境之间共享配置3.2.2不同微服务中间共享配置四、nacos的几个概

一、服务配置中心介绍

二、Nacos Config入门

三、Nacos Config深入

3.1配置动态刷新

3.2配置共享

3.2.1同一个微服务的不同环境之间共享配置

3.2.2不同微服务中间共享配置

四、nacos的几个概念

4.1创建命名空间(Namespace)

4.2组

五、bootstrap

六、总结


一、服务配置中心介绍

首先我们来看一下,微服务架构下关于配置文件的一些问题:

配置文件相对分散。在一个微服务架构下,配置文件会随着微服务的增多变的越来越多,而且分散 在各个微服务中,不好统一配置和管理。
配置文件无法区分环境。微服务项目可能会有多个环境,例如:测试环境、预发布环境、生产环 境。每一个环境所使用的配置理论上都是不同的,一旦需要修改,就需要我们去各个微服务下手动 维护,这比较困难。
配置文件无法实时更新。我们修改了配置文件之后,必须重新启动微服务才能使配置生效,这对一 个正在运行的项目来说是非常不友好的。 基于上面这些问题,我们就需要配置中心的加入来解决这些问题。

配置中心的思路是:

首先把项目中各种配置全部都放到一个集中的地方进行统一管理,并提供一套标准的接口。

当各个服务需要获取配置的时候,就来配置中心的接口拉取自己的配置。

当配置中心中的各种参数有更新的时候,也能通知到各个服务实时的过来同步最新的信息,使之动 态更新。

当加入了服务配置中心之后,我们的系统架构图会变成下面这样:

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务

在业界常见的服务配置中心,有下面这些:
Apollo Apollo是由携程开源的分布式配置中心。特点有很多,比如:配置更新之后可以实时生效,支持灰 度发布功能,并且能对所有的配置进行版本管理、操作审计等功能,提供开放平台API。并且资料 也写的很详细。
Disconf Disconf是由百度开源的分布式配置中心。它是基于Zookeeper来实现配置变更后实时通知和生效 的。
SpringCloud Config 这是Spring Cloud中带的配置中心组件。它和Spring是无缝集成,使用起来非常方便,并且它的配 置存储支持Git。不过它没有可视化的操作界面,配置的生效也不是实时的,需要重启或去刷新。
Nacos 这是SpingCloud alibaba技术栈中的一个组件,前面我们已经使用它做过服务注册中心。其实它也 集成了服务配置的功能,我们可以直接使用它作为服务配置中心。

二、Nacos Config入门

使用nacos作为配置中心,其实就是将nacos当做一个服务端,将各个微服务看成是客户端,我们 将各个微服务的配置文件统一存放在nacos上,然后各个微服务从nacos上拉取配置即可。 接下来我们以商品微服务为例,学习nacos config的使用。 1 搭建nacos环境【使用现有的nacos环境即可】 2 在微服务公共模块中引入nacos的依赖
注:由于配置中心的依赖在多个微服务中都需要引入,所以此处建议将其加入到common公共模块中。

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

3 在微服务shop-product中添加nacos config的配置
注: 1)不能使用原来的application.yml作为配置文件,而是新建一个bootstrap.yml作为配置文件; 2)在bootstrap和application数据项相同时,bootstrap中的配置不会被覆盖;

配置文件优先级(由高到低): bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml

spring: application: name: service-product cloud: nacos: config: server-addr: localhost:8848 # nacos的服务端地址 file-extension: yaml # 配置文件格式 profiles: active: dev # 环境标识

说明:之所以需要配置 spring.application.name ,是因为它是构成 Nacos 配置管理 dataId字段的一部分。在 Nacos Spring Cloud 中,dataId 的完整格式如下:

${prefix}-${spring.profiles.active}.${file-extension}

prefix:默认为 spring.application.name 的值,也可以通过配置项 spring.cloud.nacos.config.prefix来配置

spring.profiles.active:即为当前环境对应的 profile。 注意:当 spring.profiles.active 为空时,对应的连接符 - 也将不存在,dataId 的拼接格式变

file-exetension:为配置内容的数据格式,可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

配置完成之后,请启动微服务shop-product并查看控制台日志信息:

20220704221026 这个时候可以很明显发现启动项目之后,已经开始从nacos配置中心拉去相应配置信息了,只是现在还没有到nacos配置中心去配置而已。

4 在nacos中添加配置 点击配置列表,点击右边+号,新建配置。在新建配置过程中,要注意下面的细节:

1)Data ID不能随便写,要跟配置文件中的对应,对应关系如图所示 2)配置文件格式要跟配置文件的格式对应,且目前仅仅支持YAML和Properties 3)配置内容按照上面选定的格式书写

bootstrap中如何配置nacos中的namespace nacos配置文件详解_spring_02

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_03

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_04

三、Nacos Config深入3.1配置动态刷新

硬编码方式

package com.yzp.shopproduct.controller; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.ConfigurableApplicationContext; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController @RequestMapping("/nacos-config") public class NacosConfigController { @Autowired private ConfigurableApplicationContext applicationContext; //1 硬编码方式 @GetMapping("/test1") public String nacosConfingTest1() { return applicationContext.getEnvironment().getProperty("config.appName"); } }

通过代码拿到配置中的appName

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_05

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_06

方式二: 注解方式(推荐)

package com.yzp.shopproduct.controller; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.ConfigurableApplicationContext; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.context.annotation.RequestScope; @RestController @RequestMapping("/nacos-config") @RequestScope public class NacosConfigController { @Autowired private ConfigurableApplicationContext applicationContext; //1 硬编码方式 @GetMapping("/test1") public String nacosConfingTest1() { return applicationContext.getEnvironment().getProperty("config.appName"); } @Value("${config.appName}") private String appName; //2 注解方式 @GetMapping("/test2") public String nacosConfingTest2() { return appName; } }

注入配置文件属性:@Value @ConfigurationProperties应的bean的后置处理器为 ConfigurationPropertiesBindingPostProcessor,它是实现了BeanPostProcessor接口,在bean被实例化后,会调用后置处理,递归的查找属性,通过反射注入值,属性需提供其setter和getter方法。

bootstrap中如何配置nacos中的namespace nacos配置文件详解_java_07


bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_08

3.2配置共享

当配置越来越多的时候,我们就发现有很多配置是重复的,这时候就考虑可不可以将公共配置文件 提取出来,然后实现共享呢?当然是可以的。接下来我们就来探讨如何实现这一功能。

3.2.1同一个微服务的不同环境之间共享配置

如果想在同一个微服务的不同环境之间实现配置共享,其实很简单。 只需要提取一个以spring.application.name 命名的配置文件,然后将其所有环境的公共配置放在里 面即可。 1 新建一个名为shop-product.yml配置存放商品微服务的公共配置 2 添加测试方法

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_09

//3 读取shop-product所有环境共享配置 @Value("${config.os}") private String os; @RequestMapping("/test3") public String nacosConfingTest3() { return os; }

bootstrap中如何配置nacos中的namespace nacos配置文件详解_spring_10


如果需要覆盖配置信息中的某一个东西可以在shop-product-dev.yml里面直接覆盖即可

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_11


bootstrap中如何配置nacos中的namespace nacos配置文件详解_java_12

3.2.2不同微服务中间共享配置

不同为服务之间实现配置共享的原理类似于文件引入,就是定义一个公共配置,然后在当前配置中引 入。

1 在nacos中定义一个DataID为all-service.yaml的配置,用于所有微服务共享

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_13


修改bootstrap.yml

spring: application: name: shop-product cloud: nacos: config: server-addr: localhost:8848 # nacos的服务端地址 file-extension: yml # 配置文件格式 # shared-dataids: all-service.yml # 配置要引入的配置 # refreshable-dataids: all-service.yml # 配置要实现动态配置刷新的配置 extension-configs[0]: data-id: all-service.yml group: DEFAULT_GROUP refresh: true shared-configs[0]: data-id: all-service.yml group: DEFAULT_GROUP refresh: true profiles: active: dev # 环境标识

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_14

四、nacos的几个概念

命名空间(Namespace) 命名空间可用于进行不同环境的配置隔离。一般一个环境划分到一个命名空间
配置分组(Group) 配置分组用于将不同的服务可以归类到同一分组。一般将一个项目的配置分到一组
配置集(Data ID) 在系统中,一个配置文件通常就是一个配置集。一般微服务的配置就是一个配置集

bootstrap中如何配置nacos中的namespace nacos配置文件详解_java_15

4.1创建命名空间(Namespace)

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_16

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_17


bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_18


然后我们可以看all-service.yml里面的文件内容:

test命名空间里面的内容

bootstrap中如何配置nacos中的namespace nacos配置文件详解_配置文件_19


public里面的

bootstrap中如何配置nacos中的namespace nacos配置文件详解_配置文件_20

我们现在访问的是test里面的,
namespace位置有关系
先进行克隆,然后我们可以在test命名空间里面看到我们克隆的文件,然后我们对我们之前的all-service.yml文件进行修改,我们应该如何访问到test里面的配置呢,namespace首先我们应该先在bootstrap.yml里面配置namespace

spring: application: name: shop-product cloud: nacos: config: server-addr: localhost:8848 # nacos的服务端地址 file-extension: yml # 配置文件格式 # shared-dataids: all-service.yml # 配置要引入的配置 # refreshable-dataids: all-service.yml # 配置要实现动态配置刷新的配置 extension-configs[0]: data-id: all-service.yml group: DEFAULT_GROUP refresh: true shared-configs[0]: data-id: all-service.yml group: DEFAULT_GROUP refresh: true namespace: 2de5c454-ceb2-4c7b-9d92-654dafd628ac profiles: active: dev # 环境标识

最终结果:

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_21

4.2组

注意我们这个shop-product-dev.yml里面必须有之前shop-product-dev.yml的配置

之前版本

bootstrap中如何配置nacos中的namespace nacos配置文件详解_java_22

新版

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_23

然后我们通过在bootstrap.yml可以里面加入group

bootstrap中如何配置nacos中的namespace nacos配置文件详解_git_24


然后我们可以重启商品微服务进行测试:

bootstrap中如何配置nacos中的namespace nacos配置文件详解_微服务_25

五、bootstrap

Spring Cloud 构建于 Spring Boot 之上,在 Spring Boot 中有两种上下文,一种是 bootstrap, 另外一种是 application, bootstrap 是应用程序的父上下文,也就是说 bootstrap 加载优先于 applicaton。bootstrap 主要用于从额外的资源来加载配置信息,还可以在本地外部配置文件中解密属性。这两个上下文共用一个环境,它是任何Spring应用程序的外部属性的来源。bootstrap 里面的属性会优先加载,它们默认也不能被本地相同配置覆盖。

什么配置在application配置?什么配置在bootstrap里面配置?

1、当使用 Spring Cloud Config Server 的时候,spring.application.name 和 spring.cloud.config.server.git.uri应该在 bootstrap.yml 里面指定

2、一些加密解密的配置也应该配置在bootstrap里面

六、总结

如果多个share-configs中存在多个相同配置,以谁为准?
以数组中最后一个为准
如果share-configs与extension-configs中有多个相同配置,以谁为准?
nacos-config.yaml与nacos-config-dev.yaml
nacos-config-dev.yml>nacos-config.yml>extension-configs>share-configs>bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml

(责任编辑:)
------分隔线----------------------------
发表评论
请自觉遵守互联网相关的政策法规,严禁发布色情、暴力、反动的言论。
评价:
表情:
用户名: 验证码:
发布者资料
查看详细资料 发送留言 加为好友 用户等级: 注册时间:2025-06-07 09:06 最后登录:2025-06-07 09:06
栏目列表
推荐内容