您现在的位置是:亿华云 > 域名
6000 字|20 图|Nacos 手摸手教程
亿华云2025-10-04 01:12:46【域名】9人已围观
简介大家好,我是悟空呀。上次我们讲解了 OpenFeign 的架构原理,这次我们要来进入 Nacos 帝国了,Nacos 作为服务注册中心、配置中心,已经非常成熟了,业界的标杆,在讲
大家好,字图我是摸手悟空呀。
上次我们讲解了 OpenFeign 的教程架构原理,这次我们要来进入 Nacos 帝国了,字图Nacos 作为服务注册中心、摸手配置中心,教程已经非常成熟了,字图业界的摸手标杆,在讲解 Nacos 的教程架构原理之前,我先给大家来一篇开胃菜:讲解 Nacos 如何使用。字图
涉及到如下两个话题:
用 Nacos 作为注册中心。摸手用 Nacos 作为配置中心。教程由于本篇是字图针对 Nacos 的使用和配置教程,可能会略显枯燥,摸手建议大家快速浏览一遍,教程然后收藏转发下,以后说不定就会用上了~~
本篇主要内容如下:
老规矩,本篇所有示例代码都是用我的开源 SpringCloud 项目 PassJava 作为示例。
开源地址: https://github.com/Jackson0714/PassJava-Platform
PassJava 架构图如下所示:
Nacos 是阿里巴巴开源的一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
一、Nacos 作为注册中心
1.1 引入 Nacos 服务发现组件
passjava-common模块的pom.xml文件引入Nacos 服务发现组件
spring-cloud-starter-alibaba-nacos-discovery
</dependency>1.2 下载 Nacos Server 工具包并启动
注意:我在 Windows 和 Mac 上都测试过,服务器托管都可以正常使用。
下载Nacos Server 压缩包https://github.com/alibaba/nacos/releases
启动 Server,进入解压后文件夹或编译打包好的文件夹,找到如下相对文件夹 nacos/bin,并对照操作系统实际情况之下如下命令。
Linux/Unix/Mac 操作系统,执行命令 sh startup.sh -m standaloneWindows 操作系统,执行命令 cmd startup.cmdwindows执行startupm.cmd遇到问题:
λ startup.cmd
Please set the JAVA_HOME variable in your environment, We need java(x64)! jdk8 or later is better!解决方案:
修改startup.cmd文件中的 %JAVA_HOME%
%JAVA_HOME% 替换为 C:\Program Files\Java\jdk1.8.0_131启动成功:
1.3 每个微服务都配置 Nacos Server 地址
配置Nacos Server 地址在passjava-question、passjava-channel、passjava-content、passjava-member、passjava-study 应用的 /src/main/resources/application.yml配置文件中配置 Nacos Server 地址
spring:
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:88481.4 添加注解
为每个服务使用 @EnableDiscoveryClient 注解开启服务注册与发现功能
@EnableDiscoveryClient
@MapperScan("com.jackson0714.passjava.question.dao")
@SpringBootApplication
public class PassjavaQuestionApplication {
public static void main(String[] args) {
SpringApplication.run(PassjavaQuestionApplication.class, args);
}
}1.5 配置微服务的名称
spring:
application:
name: passjava-question1.6 访问nacos server后台
登录后台http://localhost:8848/nacos/index.html#/login
用户名:nacos
密码:nacos
查看已注册的服务passjava-channel 渠道微服务
passjava-member 用户微服务
passjava-study 学习微服务
passjava-question 问题微服务
passjava-content 内容微服务二、Nacos 作为配置中心
2.1 传统配置方式
application.properties文件中定义两个配置:member.nickname = "悟空聊架构"
member.age = "18"示例控制器中定义私有变量nickname和age,@value代表从配置中取值@Value("${ member.nickname}")
private String nickname;
@Value("$member.age")
private Integer age;示例控制器中定义方法:获取nick和age的值@RequestMapping("/test-local-config")
public R testLocalConfig() {
return R.ok().put("nickname", nickname).put("age", age);
}测试结果mark
总结:从配置文件中获取配置。
这种方式的缺点是什么呢?如果要修改配置参数,则需要重新启动服务。如果服务很多,则需要重启所有服务,非常不方便。
有没有什么办法不停服务修改配置而且使其生效呢?
答案:有的,用Spring Cloud Alibaba的Nacos 组件就可以完成。
2.2 引入Nacos依赖
PassJava-Common项目的pom.xml文件引入Spring Cloud Alibaba Nacos Config依赖
spring-cloud-starter-alibaba-nacos-config
</dependency>2.3 配置Nacos元数据
passjava-member 添加 /src/main/resources/bootstrap.properties 配置文件(注意:bootstrap.properties 优先级高于其他配置文件)配置 Nacos Config 元数据bootstrap.properties
spring.application.name=passjava-member
spring.cloud.nacos.config.server-addr=127.0.0.1:88482.4 Nacos后台新增配置
Data ID: passjava-member.properties
Group: DEFAULT_GROUP
配置格式:
member.nick="悟空"
member.age=10Nacos后台新增配置
2.5 开启动态刷新配置功能
添加注解@RefreshScope开启动态刷新配置功能
@RefreshScope
@RestController
@RequestMapping("member/sample")
public class SampleController { }可以从控制台看到日志信息:
Refresh keys changed: [member.age]
2020-04-19 23:34:07.154 INFO 8796 --- [-127.0.0.1_8848] c.a.nacos.client.config.impl.CacheData : [fixed-127.0.0.1_8848] [notify-ok] dataId=passjava-member.properties, group=DEFAULT_GROUP, md5=df136e146c83cbf857567e75acb11e2b, listener=com.alibaba.cloud.nacos.refresh.NacosContextRefresher$1@4f49b78b
2020-04-19 23:34:07.154 INFO 8796 --- [-127.0.0.1_8848] c.a.nacos.client.config.impl.CacheData : [fixed-127.0.0.1_8848] [notify-listener] time cost=529ms in ClientWorker, dataId=passjava-member.properties, group=DEFAULT_GROUP, md5=df136e146c83cbf857567e75acb11e2b, listener=com.alibaba.cloud.nacos.refresh.NacosContextRefresher$1@4f49b78bmember.age 更新了,香港云服务器通知了member服务,刷新了配置。对应的配置id为passjava-member.properties,分组为DEFAULT_GROUP。监听器为com.alibaba.cloud.nacos.refresh.NacosContextRefresher
2.6 测试结果
访问:http://localhost:10000/member/sample/test-local-config
结果:nickname和age和Nacos后台配置一致
结论:只用在Nacos后台改配置即可实时修改配置。
注意:Nacos的配置项优先级高于application.propertite里面的配置。
测试结果
2.7 命名空间
我们现在有5个微服务,每个微服务用到的配置可能都不一样,那不同微服务怎么样获取自己微服务的配置呢?
这里可以用到命名空间,我们针对每个微服务,都创建一个命名空间。
创建命名空间创建命名空间
# 创建5个命名空间
passjava-channel
passjava-content
passjava-member
passjava-question
passjava-study命名空间
我们打开配置列表菜单,可以看到有五个命名空间。
命名空间下创建配置
选中passjava-channel命名空间,然后新增配置项,与之前新增配置的步骤一致,也可以通过克隆命名空间来克隆配置。
克隆配置
bootstrap.properties配置命名空间
spring.cloud.nacos.config.namespace=passjava-member测试配置是否生效修改passjava-member.properties的配置内容
passjava-member.properties
重启member服务
访问方法:/member/sample/test-local-config
执行结果:
{
"msg": "success",
"code": 0,
"nickname": "\"悟空member\"",
"age": 30
}说明获取的是passjava-member命名空间的配置
2.8 分组
如果我们有多套环境,比如开发环境,测试环境,生产环境,站群服务器每一套环境的配置参数不一样,那配置中心该如何配置呢?
我们可以使用配置中心的分组功能。每一套环境都是一套分组。
首先创建一套dev环境配置项,然后克隆配置到test和prod环境dev环境
dev、test、prod分组
bootstrap.properties配置当前使用的分组:prod
spring.cloud.nacos.config.group=prod测试获取生产环境配置{
"msg": "success",
"code": 0,
"nickname": "\"悟空-prod\"",
"age": 10
}可以看到获取到的是prod分组的配置
2.9 多配置集
我们可以将application.yml文件中的datasource、mybatis-plus等配置进行拆解,放到配置中心。group可以创建3套,dev/test/prod。
2.9.1 配置中心新建datasource.yml 配置datasource.yml 配置
mybatis.yml配置
more.yml配置
mark
2.9.5 bootstrap.properties增加nacos配置,application.yml注释配置spring.application.name=passjava-member
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
spring.cloud.nacos.config.namespace=passjava-member
spring.cloud.nacos.config.group=prod
spring.cloud.nacos.config.extension-configs[0].data-id=datasource.yml
spring.cloud.nacos.config.extension-configs[0].group=dev
spring.cloud.nacos.config.extension-configs[0].refresh=true
spring.cloud.nacos.config.extension-configs[1].data-id=mybatis.yml
spring.cloud.nacos.config.extension-configs[1].group=dev
spring.cloud.nacos.config.extension-configs[1].refresh=true
spring.cloud.nacos.config.extension-configs[2].data-id=more.yml
spring.cloud.nacos.config.extension-configs[2].group=dev
spring.cloud.nacos.config.extension-configs[2].refresh=true2.9.6 测试配置是否生效测试passjava-member.properties和more.yml配置是否生效
请求url:http://localhost:10000/member/sample/test-local-config
返回配置的nick和age,且端口是10000,且member服务注册到注册中心
{
"msg": "success",
"code": 0,
"nickname": "\"悟空-prod1\"",
"age": 22
}测试datasource.yml和mybatis.yml配置是否生效请求url:http://localhost:10000/member/member/list
返回数据库查询结果
{
"msg": "success",
"code": 0,
"page": {
"totalCount": 0,
"pageSize": 10,
"totalPage": 0,
"currPage": 1,
"list": []j
}
}说明以上配置都生效了。
更多配置项后记
Nacos 的底层原理正在更新中,祝大家新年快乐啊,可不要太卷哦~
很赞哦!(37796)