目录
首先我们来看一下,微服务架构下关于配置文件的一些问题:
配置中心的思路是:
当加入了服务配置中心之后,我们的系统架构图会变成下面这样:
在业界常见的服务配置中心,有下面这些:
使用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 在微服务service-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}
spring.application.name
的值,也可以通过配置项 spring.cloud.nacos.config.prefix
来配置
spring.profiles.active
为空时,对应的连接符 -
也将不存在,dataId 的拼接格式变
spring.cloud.nacos.config.file-extension
来配置。目前只支持 properties
和 yaml
类型。
配置完成之后,请启动微服务shop-product并查看控制台日志信息:
这个时候可以很明显发现启动项目之后,已经开始从nacos配置中心拉去相应配置信息了,只是现在还没有到nacos配置中心去配置而已。 4 在nacos中添加配置 点击配置列表,点击右边+号,新建配置。在新建配置过程中,要注意下面的细节:
1、Data ID不能随便写,要跟配置文件中的对应,对应关系如图所示 2、配置文件格式要跟配置文件的格式对应,且目前仅仅支持YAML和Properties 3、配置内容按照上面选定的格式书写
5 注释本地的application.yaml中的内容, 启动程序进行测试 如果依旧可以成功访问程序,说明我们nacos的配置中心功能已经实现
在入门案例中,我们实现了配置的远程存放,但是此时如果修改了配置,我们的程序是无法读取到 的,因此,我们需要开启配置的动态刷新功能。 在nacos中的service-product-dev.yaml配置项中添加下面配置:
方式一: 硬编码方式
@RestController
public class NacosConfigController {
@Autowired
private ConfigurableApplicationContext applicationContext;
//1 硬编码方式
@GetMapping("/nacos-config-test1")
public String nacosConfingTest1() {
return applicationContext.getEnvironment().getProperty("config.appName");
}
}
方式二: 注解方式(推荐)
@RestController
@RefreshScope//只需要在需要动态读取配置的类上添加此注解就可以
public class NacosConfigController {
@Value("${config.appName}")
private String appName;
//2 注解方式
@GetMapping("/nacos-config-test2")
public String nacosConfingTest2() {
return appName;
}
}
注入配置文件属性:@Value @ConfigurationProperties应的bean的后置处理器为 ConfigurationPropertiesBindingPostProcessor,它是实现了BeanPostProcessor接口,在bean被实例化后,会调用后置处理,递归的查找属性,通过反射注入值,属性需提供其setter和getter方法。
当配置越来越多的时候,我们就发现有很多配置是重复的,这时候就考虑可不可以将公共配置文件 提取出来,然后实现共享呢?当然是可以的。接下来我们就来探讨如何实现这一功能。
同一个微服务的不同环境之间共享配置
如果想在同一个微服务的不同环境之间实现配置共享,其实很简单。 只需要提取一个以spring.application.name 命名的配置文件,然后将其所有环境的公共配置放在里 面即可。 1 新建一个名为service-product.yml配置存放商品微服务的公共配置 2 添加测试方法
@RestController
@RefreshScope//动态刷新的注解
public class NacosConfigController {
//3 读取shop-product所有环境共享配置
@Value("${config.os}")
private String os;
@RequestMapping("/nacos-config-test3")
public String nacosConfingTest3() {
return os;
}
}
5 访问测试
6 接下来,修改bootstrap.yml中的配置,将active设置成test,再次访问,观察结果。不管如何切换微服务的环境都能成功获取nacos配置中心的shop-product.yml文件配置内容,从而实现不同环境下的共享配置。
spring:
profiles:
active: test # 环境标识
不同微服务中间共享配置
不同微服务之间实现配置共享的原理类似于文件引入,就是定义一个公共配置,然后在当前配置中引 入。
1、 在nacos中定义一个DataID为all-service.yaml的配置,用于所有微服务共享
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql:///shop?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSL=true
username: root
password: sasa
jpa:
properties:
hibernate:
hbm2ddl:
auto: update
dialect: org.hibernate.dialect.MySQL5InnoDBDialect
cloud:
nacos:
discovery:
server-addr: localhost:8848
2 在nacos的中修改service-product.yaml中为下面内容
server:
port: 8081
spring:
application:
name: service-product
config:
appName: product2
3 修改bootstrap.yaml
spring:
application:
name: service-product
cloud:
nacos:
config:
server-addr: localhost:8848 # nacos的服务端地址
file-extension: yaml # 配置文件格式
shared-dataids: all-service.yaml # 配置要引入的配置
refreshable-dataids: all-service.yaml # 配置要实现动态配置刷新的配置
profiles:
active: test # 环境标识
shared-dataids: all-service.yaml和refreshable-dataids: all-service.yaml已过时 可以使用以下取代 extension-configs[0]: data-id: all-service.yaml group: DEFAULT_GROUP refresh: true shared-configs[0]: data-id: all-service.yaml group: DEFAULT_GROUP refresh: true
extension-configs的优先级高于shared-configs
4 启动商品微服务进行测试
如果没有出现空间ID(示填则自动生成),注意可能需要清空缓存
spring:
application:
name: config-test
cloud:
nacos:
config:
server-addr: localhost:8848 # nacos的服务端地址
file-extension: yaml # 配置文件格式
# shared-dataids: all-service.yaml # 配置要引入的配置
# refreshable-dataids: all-service.yaml # 配置要实现动态配置刷新的配置
namespace: a4776bdc-6683-4d0f-a971-67553404c618
extension-configs[0]:
data-id: all-service.yaml
group: DEFAULT_GROUP
refresh: true
profiles:
active: dev
namespace位置有关系
spring:
application:
name: config-test
cloud:
nacos:
discovery:
server-addr: localhost:8848
# 修改服务注册中的命名空间,默认是注册到public
namespace: a4776bdc-6683-4d0f-a971-67553404c618
# 修改服力注到nacos上分组分称,默认是DEFAULT_GROUP
group: shop_ex
config:
server-addr: localhost:8848 # nacos的服务端地址
file-extension: yaml # 配置文件格式
# shared-dataids: all-service.yaml # 配置要引入的配置
# refreshable-dataids: all-service.yaml # 配置要实现动态配置刷新的配置
namespace: a4776bdc-6683-4d0f-a971-67553404c618
# group: shop_ex
extension-configs[0]:
data-id: all-service.yaml
group: DEFAULT_GROUP
refresh: true
profiles:
active: dev
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里面
nacos-config-dev.yml>nacos-config.yml>extension-configs>share-configs>bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml