SpringCloudAlibaba随笔目录
一、SpringCloudAlibaba项目之父工程搭建
二、SpringCloudAlibaba项目之Nacos搭建及服务注册
三、SpringCloudAlibaba项目之生产者与消费者
四、SpringCloudAlibaba项目之Ribbon负载均衡
五、SpringCloudAlibaba项目之OpenFeign远程呼叫
六、SpringCloudAlibaba项目之Nacos-config配置中心
七、SpringCloudAlibaba项目之Sentinel流量控制
八、SpringCloudAlibaba项目之Seata分布式事务
九、SpringCloudAlibaba项目之GateWay网关
十、SpringCloudAlibaba项目之SkyWalking链路跟踪
SpringCloudAlibaba项目之Nacos-config配置中心
1、服务配置中心介绍
首先我们来看一下,微服务架构下关于组态档的一些问题:
1、组态档相对分散,在一个微服务架构下,组态档会随着微服务的增多变的越来越多,而且分散在各个微服务中,不好统一配置和管理,
2、组态档无法区分环境,微服务项目可能会有多个环境,例如:测验环境、预发布环境、生产环境,每一个环境所使用的配置理论上都是不同的,一旦需要修改,就需要我们去各个微服务下手动维护,这比较困难,
3、组态档无法实时更新,我们修改了组态档之后,必须重新启动微服务才能使配置生效,这对一个正在运行的项目来说是非常不友好的,
基于上面这些问题,我们就需要配置中心的加入来解决这些问题,配置中心的思路是:
- 首先把项目中各种配置全部都放到一个集中的地方进行统一管理,并提供一套标准的界面,
- 当各个服务需要获取配置的时候,就来配置中心的界面拉取自己的配置,
- 当配置中心中的各种自变量有更新的时候,也能通知到各个服务实时的过来同步最新的信息,使之动态更新,
在业界常见的服务配置中心,有下面这些:
Apollo
Apollo是由携程开源的分布式配置中心,特点有很多,比如:配置更新之后可以实时生效,支持灰度发布功能,并且能对所有的配置进行版本管理、操作审计等功能,提供开放平台API,并且资料也写的很详细,
Disconf
Disconf是由百度开源的分布式配置中心,它是基于Zookeeper来实作配置变更后实时通知和生效的,
SpringCloud Config
这是Spring Cloud中带的配置中心组件,它和Spring是无缝集成,使用起来非常方便,并且它的配置存盘支持Git,不过它没有可视化的操作界面,配置的生效也不是实时的,需要重启或去重绘,
Nacos
这是SpingCloud alibaba技术堆栈中的一个组件,前面我们已经使用它做过服务注册中心,其实它也集成了服务配置的功能,我们可以直接使用它作为服务配置中心,
2、Nacos-config简介
Nacos 是阿里巴巴开源的一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台,
Nacos Config就是一个类似于SpringCloud Config的配置中心,
使用nacos作为配置中心,其实就是将nacos当做一个服务端,将各个微服务看成是客户端,我们将各个微服务的组态档统一存放在nacos上,然后各个微服务从nacos上拉取配置即可,
官方档案:https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-config
Nacos 提供用于存盘配置和其他元资料的 key/value 存盘,为分布式系统中的外部化配置提供服务器端和客户端支持,使用 Spring Cloud Alibaba Nacos Config,您可以在 Nacos Server 集中管理你 Spring Cloud 应用的外部属性配置,
3、Client读取配置
Nacos 服务端初始化
1、启动Nacos Server,启动方式可见 Nacos 官网
2、启动好Nacos之后,在Nacos添加如下的配置:
Data ID: service-nacosconfig.properties
Group : DEFAULT_GROUP
配置格式: Properties
配置内容: user.name=service-nacosconfig-properties
user.age=90
注意:注意dataid是以 properties(默认的档案扩展名方式)为扩展名,
客户端使用方式
pom.xml档案添加依赖
<!-- nacos-config 配置中心依赖 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId> </dependency>
创建一个标准的 Spring Boot 应用
@SpringBootApplication @EnableDiscoveryClient//可加可不加,依版本而定,从Spring Cloud Edgware开始,@EnableDiscoveryClient可省略,只需加上相关依赖,并进行相应配置,即可将微服务注册到服务发现组件上, public class ServiceNacosconfigApplication { public static void main(String[] args) { //SpringApplication.run(ServiceNacosconfigApplication.class, args); ConfigurableApplicationContext applicationContext = SpringApplication.run(ServiceNacosconfigApplication.class, args); String userName = applicationContext.getEnvironment().getProperty("user.name"); String userAge = applicationContext.getEnvironment().getProperty("user.age"); System.err.println("user name :"+userName+"; age: "+userAge); } }
在运行此 Example 之前, 必须使用 bootstrap.properties 组态档来配置Nacos Server 地址,例如:
bootstrap.properties
# Nacos帮助档案: https://nacos.io/zh-cn/docs/concepts.html
# Nacos认证信息,如果不加可能读取到的是计算机系统的用户名和密码
spring.cloud.nacos.config.username=nacos
spring.cloud.nacos.config.password=nacos
spring.cloud.nacos.config.contextPath=/nacos
# 设定配置中心服务端地址,必须使用 bootstrap.properties 组态档来配置Nacos Server 地址
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
# Nacos 配置中心的namespace,需要注意,如果使用 public 的 namcespace ,请不要填写这个值,直接留空即可
# spring.cloud.nacos.config.namespace=
注意:注意当你使用域名的方式来访问 Nacos 时,spring.cloud.nacos.config.server-addr
配置的方式为 域名:port
, 例如 Nacos 的域名为abc.com.nacos,监听的埠为 80,则 spring.cloud.nacos.config.server-addr=abc.com.nacos:80
, 注意 80 埠不能省略,
application.properties
# 应用名称
#会自动根据服务名拉取dataid对应的组态档,如果服务名和dataid不一致,就需要手动指定dataid
spring.application.name=service-nacosconfig
# 应用服务 WEB 访问埠
server.port=8070
# Nacos帮助档案: https://nacos.io/zh-cn/docs/concepts.html
# Nacos认证信息
spring.cloud.nacos.discovery.username=nacos
spring.cloud.nacos.discovery.password=nacos
# Nacos 服务发现与注册配置,其中子属性 server-addr 指定 Nacos 服务器主机和埠
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
# 注册到 nacos 的指定 namespace,默认为 public
spring.cloud.nacos.discovery.namespace=public
注意:bootstrap.properties组态档要比application.properties档案先加载,但是两种档案是可以共同存在的,只是加载的优先级不同而已,
一般客户端读取的组态档根据对应的服务名称来的,
启动这个 Example,可以看到如下输出结果:
4、其他扩展配置
基于 dataid 为 yaml 的档案扩展名配置方式
spring-cloud-starter-alibaba-nacos-config 对于 yaml 格式也是完美支持的,这个时候只需要完成以下两步:
1、在应用的 bootstrap.properties 组态档中显示的宣告 dataid 档案扩展名,如下所示
bootstrap.properties# Nacos客户端,默认是properties的档案扩展名,显示的宣告 dataid 档案扩展名
# 一旦修改成非properties格式,则必须通过file-extension进行设定
spring.cloud.nacos.config.file-extension=yaml
2、在 Nacos 的控制台新增一个dataid为yaml为扩展名的配置,如下所示:
Data ID: service-nacosconfig.yaml
Group : DEFAULT_GROUP
配置格式: YAML
配置内容: user.name: service-nacosconfig-yaml
user.age: 68
这两步完成后,重启测验程序,可以看到如下输出结果:
支持配置的动态更新
spring-cloud-starter-alibaba-nacos-config 也支持配置的动态更新,启动 Spring Boot 应用测验的代码如下:
@SpringBootApplication @EnableDiscoveryClient//可加可不加,依版本而定,从Spring Cloud Edgware开始,@EnableDiscoveryClient可省略,只需加上相关依赖,并进行相应配置,即可将微服务注册到服务发现组件上, public class ServiceNacosconfigApplication { public static void main(String[] args) throws InterruptedException { //SpringApplication.run(ServiceNacosconfigApplication.class, args); ConfigurableApplicationContext applicationContext = SpringApplication.run(ServiceNacosconfigApplication.class, args); while(true) { //当动态配置重绘时,会更新到 Enviroment中,因此这里每隔一秒中从Enviroment中获取配置 String userName = applicationContext.getEnvironment().getProperty("user.name"); String userAge = applicationContext.getEnvironment().getProperty("user.age"); System.err.println("user name :" + userName + "; age: " + userAge); TimeUnit.SECONDS.sleep(1); } } }
如下所示,当变更user.name和user.age时,应用程序中能够获取到最新的值:
提示:你可以通过配置 spring.cloud.nacos.config.refresh.enabled=false 来关闭动态重绘
支持自定义扩展的 Data Id 配置
Spring Cloud Alibaba Nacos Config 从 0.2.1 版本后,可支持自定义 Data Id 的配置,关于这部分详细的设计可参考 这里, 一个完整的配置案例如下所示:
# 配置外部配置
# 1、Data Id 在默认的组 DEFAULT_GROUP,不支持配置的动态重绘
spring.cloud.nacos.config.extension-configs[0].data-id=service-config-common01.properties
# 2、Data Id 不在默认的组,不支持动态重绘
spring.cloud.nacos.config.extension-configs[1].data-id=service-config-common02.properties
spring.cloud.nacos.config.extension-configs[1].group=GLOBALE_GROUP
# 3、Data Id 既不在默认的组,也支持动态重绘
spring.cloud.nacos.config.extension-configs[2].data-id=service-config-common03.properties
spring.cloud.nacos.config.extension-configs[2].group=REFRESH_GROUP
#动态重绘
spring.cloud.nacos.config.extension-configs[2].refresh=true
可以看到:
-
通过
spring.cloud.nacos.config.extension-configs[n].data-id
的配置方式来支持多个 Data Id 的配置, -
通过
spring.cloud.nacos.config.extension-configs[n].group
的配置方式自定义 Data Id 所在的组,不明确配置的话,默认是 DEFAULT_GROUP, -
通过
spring.cloud.nacos.config.extension-configs[n].refresh
的配置方式来控制该 Data Id 在配置变更时,是否支持应用中可动态重绘, 感知到最新的配置值,默认是不支持的,
提示:
多个 Data Id 同时配置时,他的优先级关系是 spring.cloud.nacos.config.extension-configs[n].data-id
其中 n 的值越大,优先级越高,
spring.cloud.nacos.config.extension-configs[n].data-id
的值必须带档案扩展名,档案扩展名既可支持 properties,又可以支持 yaml/yml, 此时 spring.cloud.nacos.config.file-extension
的配置对自定义扩展配置的 Data Id 档案扩展名没有影响,
通过自定义扩展的 Data Id 配置,既可以解决多个应用间配置共享的问题,又可以支持一个应用有多个组态档,
为了更加清晰的在多个应用间配置共享的 Data Id ,你可以通过以下的方式来配置:
# 配置支持共享的 Data Id
spring.cloud.nacos.config.shared-configs[0].data-id=common.yaml
# 配置 Data Id 所在分组,预设默认 DEFAULT_GROUP
spring.cloud.nacos.config.shared-configs[0].group=GROUP_APP1
# 配置Data Id 在配置变更时,是否动态重绘,预设默认 false
spring.cloud.nacos.config.shared-configs[0].refresh=true
可以看到:
-
通过
spring.cloud.nacos.config.shared-configs[n].data-id
来支持多个共享 Data Id 的配置, -
通过
spring.cloud.nacos.config.shared-configs[n].group
来配置自定义 Data Id 所在的组,不明确配置的话,默认是 DEFAULT_GROUP, -
通过
spring.cloud.nacos.config.shared-configs[n].refresh
来控制该Data Id在配置变更时,是否支持应用中动态重绘,默认false,
配置的优先级
Spring Cloud Alibaba Nacos Config 目前提供了三种配置能力从 Nacos 拉取相关的配置,
-
A: 通过
spring.cloud.nacos.config.shared-configs[n].data-id
支持多个共享 Data Id 的配置 -
B: 通过
spring.cloud.nacos.config.extension-configs[n].data-id
的方式支持多个扩展 Data Id 的配置 -
C: 通过内部相关规则(应用名、应用名+ Profile )自动生成相关的 Data Id 配置
当三种方式共同使用时,他们的一个优先级关系是:A < B < C
完全关闭Nacos-config配置
通过设定 spring.cloud.nacos.config.enabled = false 来完全关闭 Spring Cloud Nacos Config
5、@RefreshScope注解
在 Spring Cloud 体系的项目中,配置中心主要用于提供分布式的配置管理,其中有一个重要的注解:@RefreshScope,如果代码中需要动态重绘配置,在需要的类上加上该注解就行,
/** * 订单服务 */ @RestController @RequestMapping("/order") @RefreshScope //配置此类界面动态重绘 public class OrderController { @Resource private StockOpenFeignService stockOpenFeignService; @Value("${user.name}") public String username; /** * 新增订单 * @return */ @RequestMapping("/addOrder") public String addOrder(){ System.out.println("订单新增成功"); String id = "123456"; //呼叫库存扣减 String result = stockOpenFeignService.subStock(id); return "订单服务-订单新增成功:" + result + " --username:" + username; } }
访问地址:http://localhost:8070/order/addOrder
0 评论