推荐:Spring Cloud 整合 Nacos 实现服务配置中心
共 6142字,需浏览 13分钟
·
2021-12-14 23:05
不点蓝字关注,我们哪来故事?
![](https://filescdn.proginn.com/189fd3ea8e2de58c71e44c8c3fe4fb82/f0a11e9f8815fd090eac3494e352dca9.webp)
正文如下
在之前的文章 《Nacos 本地单机版部署步骤和使用》 中,大家应该了解了 Nacos 是什么?其中 Nacos 提供了动态配置服务功能
一、Nacos 动态配置服务是什么?
![](https://filescdn.proginn.com/316f0be62b937ebf08d916fa35f63715/db4bb91ae363f86c80cd5250d4687e3e.webp)
官方是这么说的:
Nacos 动态配置服务是什么?
动态配置服务可以以中心化、外部化和动态化的方式管理所有环境的应用配置和服务配置。
动态配置消除了配置变更时重新部署应用和服务的需要,让配置管理变得更加高效和敏捷。
配置中心化管理让实现无状态服务变得更简单,让服务按需弹性扩展变得更容易。
Nacos 控制台的功能
Nacos 提供了一个简洁易用的 UI (控制台样例 Demo) 用来管理所有的服务和应用的配置。Nacos 还提供包括配置版本跟踪、金丝雀发布、一键回滚配置以及客户端配置更新状态跟踪在内的一系列开箱即用的配置管理特性,更安全地在生产环境中管理配置变更和降低配置变更带来的风险。
二、实战:Nacos 实现服务配置中心
下面通过两个大模块实现:
在 Nacos 中新建或修改配置 在 Spring Cloud 应用中加载 Nacos 配置
2.1 在 Nacos 新建配置
根据上篇文章 Nacos 本地单机版部署步骤和使用 ,部署运行 Nacos ,然后打开配置管理 - 配置列表页面。地址:http://localhost:8848/nacos/index.html#/configurationManagement
点击右上角创建按钮,进入新建配置页面,新建配置如图所示:
![](https://filescdn.proginn.com/4b31fbd7b945f70b758c039039b75ef3/e99d2681eb32c898ede8eddb86f73107.webp)
配置详解:
Data ID
:配置为config-service.yml
。Data ID 是指定配置且保证全局唯一性。Group
:默认配置为DEFAULT_GROUP
,不需要修改。配置格式
:选择 YAML 配置文件格式配置内容
:具体配置的内容。这里简单配置了个键值对,其实实际应用场景,会配置包括存储配置、端口配置和各种中间件配置等
Nacos Data ID
标准格式如下:
${prefix}-${spring.profiles.active}.${file-extension}
其中:
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 代码如下:
"1.0" encoding="UTF-8"?>
"http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
springcloud
springcloud-nacos-config-sample
0.0.1-SNAPSHOT
springcloud-nacos-config-sample :: Nacos 服务配置中心案例
org.springframework.boot
spring-boot-starter-parent
2.3.2.RELEASE
org.springframework.cloud
spring-cloud-starter-alibaba-nacos-config
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-test
test
org.projectlombok
lombok
1.18.10
true
org.springframework.cloud
spring-cloud-starter-alibaba-nacos-config
0.2.2.RELEASE
org.springframework.cloud
spring-cloud-dependencies
Hoxton.SR7
pom
import
org.apache.maven.plugins
maven-compiler-plugin
1.8
1.8
其中依赖了:
Spring Cloud Alibaba Nacos Config 依赖 Spring Cloud Hoxton.SR12 版本依赖
3、创建配置文件
在应用工程的 resources
目录下,创建 application.yml
文件,填入如下信息:
server:
port: 8083 # 服务端口
spring:
application:
name: config-service # 服务名称
其中:
server.port
指定了服务端口 8083spring.application.name
指定了服务名称config-service
,要跟 Nacos 后台新建配置的Data ID
值保持一致。
为啥呢?因为看一下 Nacos Config 源码 org.springframework.cloud.alibaba.nacos.client.NacosPropertySourceLocator#locate 。源码如下:
if (StringUtils.isEmpty(dataIdPrefix)) {
dataIdPrefix = env.getProperty("spring.application.name");
}
如果 Data ID
没有配置,则读取 spring.application.name
服务名称配置。
继续创建 bootstrap.yml
文件,填入以下信息:
spring:
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848 # Nacos 配置中心地址
file-extension: yml # 配置文件格式
其中:
nacos.config.server-addr
指定了 Nacos 地址和端口nacos.config.file-extension
指定了配置文件格式为 yml
4、创建测试类和启动类
新建 Spring Cloud 应用启动类 ConfigApplication,代码如下:
/**
* Spring Boot 服务启动类
*
* Created by bysocket.com on 21/12/06.
*/
@SpringBootApplication // Spring Boot 应用标识
public class ProviderApplication {
public static void main(String[] args) {
// 程序启动入口
// 启动嵌入式的 Tomcat 并初始化 Spring 环境及其各 Spring 组件
SpringApplication.run(ProviderApplication.class,args);
}
}
然后新建测试控制类 ConfigController,代码如下:
/**
* Config 案例
*
* Created by bysocket.com on 21/12/07.
*/
@RestController
@Slf4j
@RefreshScope
@Data
public class ConfigController {
@Value("${blog.name}")
private String blogName;
@GetMapping("/get")
public String get() {
return "ConfigController#get blog name = " + getBlogName();
}
}
代码详解如下:
@Value
注解 :@Value 对 Bean 的字段或者方法参数进行标注,职责是基于表达式给字段或方法参数设置默认属性值。通常格式是注解 + SpEL 表达式,如 @Value("SpEL 表达式")。@RefreshScope
注解 :允许在运行时动态刷新 Bean 的 Scope 实现。如果 Bean 被刷新,则在下次访问 Bean 即执行方法时,会创建一个新实例。这说明在应用运行时,在 Nacos 控制台修改了对应配置的值后,会同时修改和生效该 Bean 这个值,达到动态配置的效果。
5、运行测试
启动上面的应用,会在控制台看到如下信息:
2021-12-09 20:11:43.399 INFO 13909 --- [-127.0.0.1_8848] o.s.c.a.n.c.NacosPropertySourceBuilder : Loading nacos data, dataId: 'config-service.yml', group: 'DEFAULT_GROUP'
2021-12-09 20:11:43.400 INFO 13909 --- [-127.0.0.1_8848] b.c.PropertySourceBootstrapConfiguration : Located property source: [BootstrapPropertySource {name='bootstrapProperties-config-service.yml'}]
这里可以看出,已经加载了 Nacos 配置信息 dataId: 'config-service.yml'
和 group: 'DEFAULT_GROUP'
。
最后在浏览器打开地址 http://localhost:8083/get
,响应如图所示:
![](https://filescdn.proginn.com/0fc560f7fb938ce1d5c6054e066bd31a/e46fb17aa50e729081c636bf0c81d4dc.webp)
动态配置测试
然后去 Nacos 控制台,配置列表点击修改 config-service.yml
配置。将 www.bysocekt.com
改成 bysocket.com
,然后确认发布。如图所示:
![](https://filescdn.proginn.com/d4516cb7455abad01179a91bc91f76d8/f7f6163d7502768ef5570f6d92651e99.webp)
可以从控制台看到如下日志:
2021-12-09 20:31:30.747 INFO 13909 --- [-127.0.0.1_8848] o.s.c.e.event.RefreshEventListener : Refresh keys changed: [blog.name]
重新访问下浏览器该地址 http://localhost:8083/get
,响应如图所示:
![](https://filescdn.proginn.com/e9b1dcb4ff6a85452b898ebb02479723/5b28468c2f3b3cfaa62069586e4d0a7f.webp)
说明动态刷新配置成功。
三、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
以下系列教程推荐
《Spring Cloud 系列教程》https://www.bysocket.com/spring-cloud 《Spring Boot 2.x 系列教程》https://www.bysocket.com/springboot 《Elasticsearch 入门系列教程》
往期推荐
↓ 或加泥瓦匠微信,交流更多技术 ↓
![](https://filescdn.proginn.com/c71da3064afb734c4ed63b9111614779/cfa0b09260ec3665e4130ea52daa5766.webp)