Nacos配置管理
统一配置管理
配置更改热更新
在Nacos中添加配置信息:
在弹出表单中编写配置信息:
配置获取的步骤如下:
- 引入Nacos的配置管理客户端依赖:
<!-- nacos配置管理-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
- 在userservice中的resource目录添加一个bootstrap.yml文件,这个文件时引导文件,优先级高于application.yml:
spring:
application:
name: user-service # 服务名称
profiles:
active: dev # 开发环境,这里是dev
cloud:
nacos:
server-addr: localhost.com:8848 # Nacos地址
discovery:
# cluster-name: HZ # 配置集群名称,也就是机房位置,例如:HZ,杭州
namespace: 77dc98c5-6788-4f2e-86ac-b9dd0ba8105a # 命名空间,填ID
config:
file-extension: yaml # 文件后缀名
namespace: 77dc98c5-6788-4f2e-86ac-b9dd0ba8105a # 命名空间,填ID
注意:config也有namespace配置,注意添加的配置信息命名空间是否与创建的一致
总结:
将配置交给Nacos管理的步骤
- 在Nacos中添加配置文件
- 在微服务中引入nacos的config依赖
- 在微服务中添加bootstrap.yml,配置nacos地址、当前环境、服务名称、文件后缀名。这些决定了程序启动时去nacos读取哪个文件
配置热更新
Nacos中的配置文件变更后,微服务无需重启就可以感知。不过需要通过下面两种配置实现:
- 方式一:在@Value注入的变量所在类上添加注解@RefreshScope
- 方式二:使用@ConfigurationProperties注解
总结:
Nacos配置更改后,微服务可以实现热更新,方式:
- 通过@Value注解注入,结合@RefreshScope来刷新
- 通过@ConfigurationProperties注入,自动刷新
注意事项:
- 不是所有的配置都适合放到配置中心,维护起来比较麻烦
- 建议将一些关键参数,需要运行时调整的参数放到nacos配置中心,一般都是自定义配置
配置共享
微服务启动时会从nacos读取多个配置文件:
- [spring.application.name]-[spring.profiles.active].yaml,例如:userservice-dev.yaml
- [spring.application.name].yaml,例如:userservice.yaml
无论profile如何变化,[spring.application.name].yaml这个文件一定会加载,因此多环境共享配置可以写入这个文件
多种配置的优先级:
总结:
微服务会从nacos读取的配置文件:
- [服务名]-[spring.profile.active].yaml,环境配置
- [服务名].yaml,默认配置,多环境共享
优先级:
- [服务名]-[环境].yaml >[服务名].yaml > 本地配置
不同微服务之间可以共享配置文件,通过下面的两种方式来指定:
方式一:
spring:
application:
name: user-service # 服务名称
profiles:
active: dev # 开发环境,这里是dev
cloud:
nacos:
server-addr: localhost:8848 # Nacos地址
discovery:
# cluster-name: HZ # 配置集群名称,也就是机房位置,例如:HZ,杭州
namespace: 77dc98c5-6788-4f2e-86ac-b9dd0ba8105a # 命名空间,填ID
config:
file-extension: yaml # 文件后缀名
namespace: 77dc98c5-6788-4f2e-86ac-b9dd0ba8105a # 命名空间,填ID
shared-configs: # 多微服务间共享的配置列表
- dataId: common.yaml # 要共享的配置文件id
方式二:
spring:
application:
name: user-service # 服务名称
profiles:
active: dev # 开发环境,这里是dev
cloud:
nacos:
server-addr: localhost.com:8848 # Nacos地址
discovery:
# cluster-name: HZ # 配置集群名称,也就是机房位置,例如:HZ,杭州
namespace: 77dc98c5-6788-4f2e-86ac-b9dd0ba8105a # 命名空间,填ID
config:
file-extension: yaml # 文件后缀名
namespace: 77dc98c5-6788-4f2e-86ac-b9dd0ba8105a # 命名空间,填ID
extension-configs: # 多微服务间共享的配置列表
- dataId: common.yaml # 要共享的配置文件id
多种配置的优先级:
总结:
微服务默认读取的配置文件:
- [服务名]-[spring.profile.active].yaml,默认配置
- [服务名].yaml,多环境共享
不同微服务共享的配置文件:
- 通过shared-configs指定
- 通过extension-configs指定
优先级:
- 环境配置 >服务名.yaml > extension-config > extension-configs > shared-configs > 本地配置