目录
1.Nacos定位
2.Nacos的安装配置
3.整合Nacos
3.1.Nacos安装
3.2.Nacos登录
3.3.配置Nacos
4.Nacos使用
4.1.引入 Maven 依赖
4.2.配置bootstrap.yml
4.3.Nacos配置类
4.4.启用Nacos服务
4.5.测试获取配置
5.加载多个配置文件
datasource-dev.yaml
mybatis-plus-dev.yaml
本地文件bootstrap.yml
Contro代码
测试结果
总结
6.异常处理
鸣谢
1.Nacos定位
微服务架构下关于配置文件的一些问题:
配置文件相对分散。在一个微服务架构下,配置文件会随着微服务的增多变的越来越多,而且分散
在各个微服务中,不好统一配置和管理。
配置文件无法区分环境。微服务项目可能会有多个环境,例如:测试环境、预发布环境、生产环
境。每一个环境所使用的配置理论上都是不同的,一旦需要修改,就需要我们去各个微服务下手动
维护,这比较困难。
配置文件无法实时更新。我们修改了配置文件之后,必须重新启动微服务才能使配置生效,这对一
个正在运行的项目来说是非常不友好的。
基于上面这些问题,我们就需要配置中心的加入来解决这些问题。
配置中心的思路是:
- 首先把项目中各种配置全部都放到一个集中的地方进行统一管理,并提供一套标准的接口。
- 当各个服务需要获取配置的时候,就来配置中心的接口拉取自己的配置。
- 当配置中心中的各种参数有更新的时候,也能通知到各个服务实时的过来同步最新的信息,使之动态更新。
总结:
服务管理平台:服务注册、配置和路由
配置管理:统一的配置管理
2.Nacos的安装配置
Nacos的学习资源主要有以下两个
Nacos官网: Nacos官网
Nacos GitHub: NacosGitHub
快速下载 nacos 的地址 :快速下载地址
3.整合Nacos
本项目使用版本一览,测试两个版本都ok
Spring Boot | Spring Cloud | Spring Cloud Alibaba | Nocos | JDK |
---|---|---|---|---|
2.7.7 | 2021.0.5 | 2021.0.5.0 | 2.2.9.RELEASE | 1.8 |
2.3.12.RELEASE |
2.2.9.RELEASE |
1.8 |
注意:SpringBoot3.0开始不支持jdk8
3.1.Nacos安装
参考博客:Nacos安装(二)
3.2.Nacos登录
单机模式启动Nocos服务后,访问登录
地址:http://127.0.0.1:8848
用户名/密码:nacos/nocos
3.3.配置Nacos
1)配置中心简介
-
命名空间Namespace:用来区分环境
- 开发(dev)、测试(test)、生产(prod):利用命名空间来做环境隔离
-
Data ID: 用来区分配置,可以理解成对应我们的一个微服务
- 例如:数据空配置,redis配置,kafka配置。
- 命名规则:application.name + profiles.active + file-extension。
- 如果bootstrap.yml文件中没有配置profiles.active + file-extension,我们只需要用服务名命名即可。
- Group:用来区分不同的应用,默认DEFAULT_GROUP,如果在bootstrap.yml配置了profiles.active,这里填写profiles.active的值即可。
- 配置格式:和项目对应
2)创建命名空间
如果想指定不同开发环境配置,如开发环境,测试环境等,我们就需要配置我们刚刚在上面讲的namespace。创建命名空间如下图所示:
命名空间ID:测试环境、生产环境
描述:对环境的描述
创建命名空间后,我们就可以在配置列表中看到我们创建的命名空间
3)创建配置文件
选择对应的命名空间,点击右边加号创建配置文件
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 类型。
比如说我们现在要获取应用名称为
nacos-config-client
的应用在dev
环境下的yaml
配置,dataid如下:nacos-config-client-dev.yaml
4.Nacos使用
使用nacos作为配置中心,Nacos读取的是bootstrap.yml,而我们项目中的配置文件名称是application.properties/application.yml,所以我们要修改我们项目中的配置文件名为bootstrap.yml。
4.1.引入 Maven 依赖
首先,我们还是要引入 Maven 依赖,在maven仓库使用最新版本:
Maven Repository: nacos
<!--注册中心的依赖-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
<version>2.2.9.RELEASE</version>
</dependency>
<!-- 配置中心的依赖 -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
<version>2.2.9.RELEASE</version>
</dependency>
注意:注册中心和配置中心的依赖版本要根据 SpringBoot 版本来选择。
具体版本对应关系;版本说明 · alibaba/spring-cloud-alibaba Wiki (github.com)
4.2.配置bootstrap.yml
在微服务resources中创建bootstrap.yml文件,添加如下nacos配置信息:
spring:
application:
name: nacos-test
profiles:
#指定启动环境
active: dev
cloud:
nacos:
discovery:
# Nacos服务注册中心地址
server-addr: 127.0.0.1:8848
# 分组,不同分组之间不能调用,用于微服务之间的隔离
group: DEFAULT_GROUP
# 生产环境
namespace: 534c904d-7f24-4086-acbd-daf628cb1446
config:
# 是否开启配置中心 默认true
enabled: true
# 指定Nacos配置中心的地址
server-addr: 127.0.0.1:8848
# 区分环境:开发环境、测试环境、预发布环境、⽣产环境
namespace: 91d34e57-55b0-4182-b881-ab0b5aefabe9
# 区分不同应⽤:同⼀个环境内,不同应⽤的配置,通过group来区分。
group: ${spring.profiles.active}
#指定yaml格式的配置 默认properties
file-extension: yaml
# 自动刷新配置文件,默认true
refresh-enabled: true
# Nacos 认证用户
username: nacos
# Nacos 认证密码
password: nacos
# 配置文件prefix
prefix: ${spring.application.name}
4.3.Nacos配置类
增加一个 Nacos 的配置文件,通过这个类可以拉取nacos中配置:
import com.alibaba.cloud.nacos.NacosConfigProperties;
import com.alibaba.cloud.nacos.NacosDiscoveryProperties;
import com.alibaba.nacos.api.exception.NacosException;
import com.alibaba.nacos.api.naming.NamingService;
import lombok.Data;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;
/**
* @program: NacosConfig
* @description: NacosConfig
* @author: dyt
* @create: 2022-07-29 16:39
**/
// 刷新配置
@RefreshScope
@Data
@Component
public class NacosConfig {
@Value("${server.port}")
private Integer serverPort;
@Value("${spring.application.name}")
private String applicationName;
// @NacosInjected
// private NamingService namingService;
@Autowired
NacosConfigProperties nacosConfigProperties;
@Autowired
NacosDiscoveryProperties nacosDiscoveryProperties;
/**
* 通过Naming服务注册实例到注册中心
*
* @throws NacosException
*/
@PostConstruct
public void registerInstance() throws NacosException {
NamingService namingService = nacosDiscoveryProperties.namingServiceInstance();
namingService.registerInstance(applicationName, "127.0.0.1", serverPort);
}
}
- @NacosValue注解是Spring Cloud Alibaba Nacos提供的注解,用于获取Nacos配置中心的配置值。它可以自动监听配置变化并动态更新
@Value注解是Spring框架提供的注解,用于获取配置文件中的值,可以用于获取任意配置文件(如application.properties、application.yml)中的配置项。使用@Value注解时,需要指定配置项的完整路径,例如:@Value("${config.key}")。
我这里NamingService 始终报空指针异常,只能自己初始化
4.4.启用Nacos服务
在Spring Boot的启动类上添加@EnableDiscoveryClient注解,启用Nacos的服务注册和发现功能。
//启用Nacos作为服务发现的功能
@EnableDiscoveryClient
//引入了spring-cloud-starter-alibaba-nacos-discovery依赖时,默认情况下会自动启用Nacos的服务注册和发现功能
@SpringBootApplication
public class NacosTestApplication {
public static void main(String[] args) {
SpringApplication.run(NacosTestApplication.class, args);
}
}
- 如果想要配置项的值自动刷新,仅在
@NacosPropertySource
加autoRefreshed = true
是不够的,在@NacosValue
上面也得加autoRefreshed = true
- @EnableDiscoveryClient 注解,开启 Spring Cloud 的注册发现功能。不过从 Spring Cloud Edgware 版本开始,实际上已经不需要添加
@EnableDiscoveryClient
注解,只需要引入 Spring Cloud 注册发现组件,就会自动开启注册发现的功能。例如说,我们这里已经引入了spring-cloud-starter-alibaba-nacos-discovery
依赖,就不用再添加@EnableDiscoveryClient
注解了
4.5.测试获取配置
最后我们写一个模拟获取配置参数的 Controller 类👇
import com.dyt.nacos.config.NacosConfig;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
@RestController
@RequestMapping("/nacos")
public class NacosController {
@Resource
private NacosConfig nacosConfig;
/**
* 获取配置中心配置
* @return
*/
@RequestMapping("/getConfig")
public String getConfig(){
return nacosConfig.getMaxThreads()+nacosConfig.getCommon()+nacosConfig.getTest();
}
}
5.加载多个配置文件
-
Nacos在配置路径
spring.cloud.nacos.config.extension-config
下,允许我们指定⼀个或多个额外配置。 -
Nacos在配置路径
spring.cloud.nacos.config.shared-configs
下,允许我们指定⼀个或多个共享配置。 - 上述两类配置都⽀持三个属性:
data-id
、group
(默认为字符串DEFAULT_GROUP
)、refresh
(默认为true
)。
datasource-dev.yaml
#mysql和阿里druid配置
spring:
datasource:
dynamic:
primary: oracle-db #设置默认的数据源或者数据源组
datasource:
oracle-db:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: oracle.jdbc.OracleDriver
url: jdbc:oracle:thin:@192.168.5.100:1521:kylwspwh
username: root
password: MsI1#11OI1#1sW
mysql-adb:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://192.168.5.22:3306/ordercenter?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username: dzkp
password: H2!b1t#ub1_1n
mybatis-plus-dev.yaml
# mybatis-plus相关配置
mybatis-plus:
configuration:
#开启sql日志
# log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
# 是否开启自动驼峰命名规则映射:从数据库列名到Java属性驼峰命名的类似映射
map-underscore-to-camel-case: true
# 解决oracle更新数据为null时无法转换报错,mysql不会出现此情况
jdbc-type-for-null: 'null'
#实体类所在包
type-aliases-package: com.batchUtil.model,com.batchUtil.bxp.model
# xml扫描,多个目录用逗号或者分号分隔(告诉 Mapper 所对应的 XML 文件位置)
mapper-locations: classpath:mapper/*.xml
本地文件bootstrap.yml
application.yml作用域在于当前应用有效,bootstrap.yml系统级别的配置有效(一般采用远程配置的时候才会用到)。
因此,将项目中原来的application.yml、application-dev.yml对应改成bootstrap.yml、bootstrap-dev.yml 。
在应用程序的bootstrap.yml里的config节点下增加配置 extension-configs,表明额外配置文件:
spring:
application:
name: nacos-test
profiles:
#指定启动环境
active: dev
cloud:
nacos:
discovery:
# Nacos服务注册中心地址
server-addr: 127.0.0.1:8848
# 分组,不同分组之间不能调用,用于微服务之间的隔离
group: ${spring.profiles.active}
# 生产环境
namespace: ${nacos.client.namespace}
config:
# 是否开启配置中心 默认true
enabled: true
# 指定Nacos配置中心的地址
server-addr: 127.0.0.1:8848
# 区分环境:开发环境、测试环境、预发布环境、⽣产环境
namespace: 91d34e57-55b0-4182-b881-ab0b5aefabe9
# 区分不同应⽤:同⼀个环境内,不同应⽤的配置,通过group来区分。
group: ${spring.profiles.active}
# 配置文件的格式:指定yaml格式,配置 默认properties
file-extension: yaml
# 自动刷新配置文件,默认true
refresh-enabled: true
# Nacos 认证用户
username: nacos
# Nacos 认证密码
password: nacos
# 配置文件prefix
prefix: ${spring.application.name}
#共享配置文件:支持多个共享Data Id的配置,优先级小于extension-configs,自定义 Data Id 配置 属性是个集合,
# 内部由 Config POJO 组成。Config 有 3 个属性,分别是 dataId, group 以及 refresh
# 用于共享的配置文件
shared-configs:
- data-id: datasource-${spring.profiles.active}.yaml
group: ${spring.profiles.active}
refresh: true
# 扩展配置文件:支持多个扩展Data Id的配置,优先级大于shared-configs,自定义 Data Id 配置 属性是个集合,
- data-id: mybatis-plus-${spring.profiles.active}.yaml
group: ${spring.profiles.active}
refresh: true
# 常规配置文件
# 优先级大于 shared-configs,在 shared-configs 之后加载
extension-configs:
- data-id: datasource-${spring.profiles.active}.yaml
group: ${spring.profiles.active}
refresh: true
- data-id: mybatis-plus-${spring.profiles.active}.yaml
group: ${spring.profiles.active}
refresh: true
Contro代码
import com.alibaba.cloud.nacos.NacosConfigProperties;
import com.alibaba.cloud.nacos.NacosDiscoveryProperties;
import com.alibaba.nacos.api.exception.NacosException;
import com.alibaba.nacos.api.naming.NamingService;
import lombok.Data;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;
/**
* @program: NacosConfig
* @description: NacosConfig
* @author: dyt
* @create: 2022-07-29 16:39
**/
// 刷新配置
@RefreshScope
@Data
@Component
public class NacosConfig {
@Value("${server.port}")
private Integer serverPort;
@Value("${spring.application.name}")
private String applicationName;
/*
@NacosInjected
private NamingService namingService;*/
@Value("${spring.datasource.dynamic.primary}")
private String primary;
@Autowired
NacosConfigProperties nacosConfigProperties;
@Autowired
NacosDiscoveryProperties nacosDiscoveryProperties;
/**
* 通过Naming服务注册实例到注册中心
*
* @throws NacosException
*/
@PostConstruct
public void registerInstance() throws NacosException {
NamingService namingService = nacosDiscoveryProperties.namingServiceInstance();
namingService.registerInstance(applicationName, "127.0.0.1", serverPort);
}
}
import com.dyt.nacos.config.NacosConfig;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
@RestController
@RequestMapping("/nacos")
public class NacosController {
@Resource
private NacosConfig nacosConfig;
/**
* 获取配置中心默认数据源名称
*
* @return
*/
@RequestMapping("/primary")
public String getPrimary(){
return nacosConfig.getPrimary();
}
}
测试结果
总结
关于优先级
1)对同种配置,排在后⾯的相同配置,将覆盖排在前⾯的同名配置。
2)不同种类配置之间,优先级按顺序如下:主配置 > 扩展配置(extension-configs) > 共享配置(shared-configs)
上面的demo已经演示Nacos共享配置的两种实现方式,两种方式针对不同的场景,总结如下:
shared-dataids方式:
适合于共享配置文件与项目默认配置文件处于相同Group时,直接两条命令就可以搞定
优点:配置方便
缺点:只能在同一Group中
ext-config方式:
它可以由开发者自定义要读取的共享配置文件的DataId、Group、refresh属性,这样刚好解决了shared-dataids存在的局限性。
优点:可以与shared-dataids方案结合使用,用户自定义配置。灵活性强
缺点:配置容易出错,要熟悉YAML语法
6.异常处理
搭建过程中遇到控制针异常,NamingService使用初始化为null,只能寻求其他方式
1)空指针:通过Naming服务注册实例到注册中心NamingService
// 刷新配置
@RefreshScope
@Data
@Component
public class NacosConfig {
@Value("${server.port}")
private Integer serverPort;
@Value("${spring.application.name}")
private String applicationName;
@Autowired
NacosConfigProperties nacosConfigProperties;
@Autowired
NacosDiscoveryProperties nacosDiscoveryProperties;
/**
* 通过Naming服务注册实例到注册中心
*
* @throws NacosException
*/
@PostConstruct
public void registerInstance() throws NacosException {
NamingService namingService = nacosDiscoveryProperties.namingServiceInstance();
namingService.registerInstance(applicationName, "127.0.0.1", serverPort);
}
}
鸣谢
[1].https://blog.csdn.net/weixin_63719049/article/details/128263045
[2].https://www.jianshu.com/p/8715072d3f4c
[3].https://www.jianshu.com/p/df87a308edff
[4].https://juejin.cn/post/6953045578095788068
[5].https://juejin.cn/post/7152438783269421093
[6].https://blog.csdn.net/qq_33619378/article/details/98972790
[7].https://blog.csdn.net/ysj1241267542/article/details/112562611
[8].https://blog.csdn.net/z69183787/article/details/109467120文章来源:https://www.toymoban.com/news/detail-701136.html
[9].https://blog.csdn.net/weixin_42329623/article/details/131018680文章来源地址https://www.toymoban.com/news/detail-701136.html
到了这里,关于SpringBoot整合Nacos实现配置中心的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!