Spring Cloud 整合 Nacos 实现服务配置中心
在之前的文章 《Nacos 本地单机版部署步骤和使用》 中,大家应该了解了 Nacos 是什么?其中 Nacos 提供了动态配置服务功能
一、Nacos 动态配置服务是什么?
官方是这么说的:
Nacos 动态配置服务是什么?
动态配置服务可以以中心化、外部化和动态化的方式管理所有环境的应用配置和服务配置。
动态配置消除了配置变更时重新部署应用和服务的需要,让配置管理变得更加高效和敏捷。
配置中心化管理让实现无状态服务变得更简单,让服务按需弹性扩展变得更容易。
Nacos 控制台的功能
Nacos 提供了一个简洁易用的 UI (控制台样例 Demo) 用来管理所有的服务和应用的配置。Nacos 还提供包括配置版本跟踪、金丝雀发布、一键回滚配置以及客户端配置更新状态跟踪在内的一系列开箱即用的配置管理特性,更安全地在生产环境中管理配置变更和降低配置变更带来的风险。
二、实战:Nacos 实现服务配置中心
下面通过两个大模块实现:
在 Nacos 中新建或修改配置
在 Spring Cloud 应用中加载 Nacos 配置
2.1 在 Nacos 新建配置
根据上篇文章,部署运行 Nacos ,然后打开配置管理 - 配置列表页面。地址: http://localhost:8848/nacos/index.html#/configurationManagement
点击右上角创建按钮,进入新建配置页面,新建配置如图所示:
配置详解:
Data ID
:配置为config-service.yml
。Data ID 是指定配置且保证全局唯一性。Group
:默认配置为DEFAULT_GROUP
,不需要修改。配置格式
: 选择 YAML 配置文件格式配置内容
: 具体配置的内容。这里简单配置了个键值对,其实实际应用场景,会配置包括存储配置、端口配置和各种中间件配置等
Nacos Data ID
标准格式如下:
其中:
prefix
:默认为spring.application.name
的值spring.profiles.active
:该案例为空,一般指定 dev test 等环境配置file-extension
:配置内容格式
2.2 创建 Spring Cloud 应用
1、创建应用
新建工程,工程名为:springcloud-nacos-config-sample
工程项目地址在:
Github:https://github.com/JeffLi1993/springcloud-learning-example/tree/master/springcloud-nacos-config-sample
Gitee:https://gitee.com/jeff1993/springcloud-learning-example/tree/master/springcloud-nacos-config-sample
2、配置 pom 依赖
pom.xml 代码如下:
其中依赖了:
Spring Cloud Alibaba Nacos Config 依赖
Spring Cloud Hoxton.SR12 版本依赖
3、创建配置文件
在应用工程的 resources
目录下,创建 application.yml
文件,填入如下信息:
其中:
server.port
指定了服务端口 8083spring.application.name
指定了服务名称config-service
,要跟 Nacos 后台新建配置的Data ID
值保持一致。
为啥呢?因为看一下 Nacos Config 源码 org.springframework.cloud.alibaba.nacos.client.NacosPropertySourceLocator#locate 。源码如下:
如果 Data ID
没有配置,则读取 spring.application.name
服务名称配置。
继续创建 bootstrap.yml
文件,填入以下信息:
其中:
nacos.config.server-addr
指定了 Nacos 地址和端口nacos.config.file-extension
指定了配置文件格式为 yml
4、创建测试类和启动类
新建 Spring Cloud 应用启动类 ConfigApplication,代码如下:
然后新建测试控制类 ConfigController,代码如下:
代码详解如下:
@Value
注解 :@Value 对 Bean 的字段或者方法参数进行标注,职责是基于表达式给字段或方法参数设置默认属性值。通常格式是注解 + SpEL 表达式,如 @Value("SpEL 表达式")。@RefreshScope
注解 :允许在运行时动态刷新 Bean 的 Scope 实现。如果 Bean 被刷新,则在下次访问 Bean 即执行方法时,会创建一个新实例。这说明在应用运行时,在 Nacos 控制台修改了对应配置的值后,会同时修改和生效该 Bean 这个值,达到动态配置的效果。
5、运行测试
启动上面的应用,会在控制台看到如下信息:
这里可以看出,已经加载了 Nacos 配置信息 dataId: 'config-service.yml'
和 group: 'DEFAULT_GROUP'
。
最后在浏览器打开地址 http://localhost:8083/get
,响应如图所示:
动态配置测试
然后去 Nacos 控制台,配置列表点击修改 config-service.yml
配置。将 www.bysocekt.com
改成 bysocket.com
,然后确认发布。如图所示:
可以从控制台看到如下日志:
重新访问下浏览器该地址 http://localhost:8083/get
,响应如图所示:
说明动态刷新配置成功。
三、Nacos 实现分布式配置小结
本文详细介绍了 Spring Cloud 整合 Nacos 实现服务分布配置。关键两点:
如何在 Nacos 设置对应的配置
如何在工程中通过依赖和注解关联上对应的外化配置
参考资料
官方案例:https://github.com/nacos-group/nacos-examples/tree/master/nacos-spring-cloud-example
官方文档:https://nacos.io/zh-cn/docs/quick-start-spring-cloud.html
https://blog.didispace.com/spring-cloud-alibaba-nacos-config-2/
代码示例地址
本文案例,可以查看开源项目 springcloud-learning-example 中的 springcloud-nacos-config-sample 模块:
Github:https://github.com/JeffLi1993/springcloud-learning-example
Gitee:https://gitee.com/jeff1993/springcloud-learning-example
以下系列教程推荐
版权声明: 本文为 InfoQ 作者【程序员泥瓦匠】的原创文章。
原文链接:【http://xie.infoq.cn/article/75516d6225e43b4e734e1fba1】。文章转载请联系作者。
评论