编程技术分享平台

网站首页 > 技术教程 正文

阿里P8大佬总结的Nacos入门笔记,从安装到进阶小白也能轻松学会

xnh888 2025-07-03 20:33:22 技术教程 6 ℃ 0 评论

前言

Nacos /nɑ:ks/ 是 Dynamic Naming and Configuration Service的首字母简称,一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。

Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。

Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。

在这个介绍中,可以看出Nacos至少有三个核心功能:

1. 动态服务发现

2. 配置管理

3. 服务管理

后续会分别来介绍这三个功能是怎么回事

下载和解压

教程制作时,Nacos的最新发行版为2.1.1 (Aug 8th, 2022)(本教程就是基于这个版本),官方当前推荐的稳定版本为2.0.3。

查看最新Nacos发行版:https://github.com/alibaba/nacos/releases

并且可以在此网上下载安装包:

下载完了之后进行解压,解压之后的目录为:

1. bin目录下是启动和停止的脚本

2. conf目录下是Nacos的配置文件

3. target目录下是Nacos的jar包(启动脚本中其实就是运行的这个jar包,停止脚步中是直接kill到进程)

启动

解压完之后就可以启动Nacos了,Nacos支持单机和集群,默认是以集群模式启动,通过添加-mstandalone就会以单机模式启动。

Linux/Unix/Mac

启动命令(standalone代表着单机模式运行,非集群模式):

sh startup.sh -m standalone

如果您使用的是ubuntu系统,或者运行脚本报错提示[[符号找不到,可尝试如下运行:

bash startup.sh -m standalone

Windows

启动命令(standalone代表着单机模式运行,非集群模式):

startup.cmd -m standalone

可以发现,默认情况下Nacos占用了8848端口。

我们可以访问http://localhost:8848/nacos,来访问Nacos:

默认的用户名和密码为:nacos/nacos

这个网相当于nacos的管理台,有:

1. 配置管理

2. 服务管理

3. 权限控制

4. 命名空间

5. 集群管理

配置管理

配置,其实就是一个key:value,比如

并且我们通常会把这些配置写在application.properties或application.yml文件中,当时通过这种方式一定配置发生了改变就需要重启应用,并且通过这种方式配置的配置项仅限于当前应用,而不能做到多个应用共享。

那么nacos的配置管理功能就是来解决这些问题的,我们可以直接通过nacos管理台来新增配置,并且这些配置能够被多个应用给使用到。

新建配置

新建配置时可以指定:

1. Data ID:相当于一个配置文件,比如相当于application.properties,或者
application-dev.properties,不过要注意的是,我们在某个项目中使用application.properties文件中,那个application表示的就是当前应用,那我们在nacos进行配置时,就要尽可能的取一些有含义的DataID,比如user.properties(表示用户应用的配置),order.properties(表示订单应用的配置),common.properties(表示多个应用共享的配置)。

2. Group:在nacos中,一个Data ID,也就是一个或多个配置文件可以归类到同一个Group中,Group的作用就是用来区分Data ID相同的情况,不同的应用或中间件使用了相同的Data ID时就可以通过Group来进行区分,默认为DEFAULT_GROUP

3. 配置内容:写具体的配置项,可以用properties的格式,也可以用yaml的格式

比如:

拉取配置

在nacos中新建完配置后,那作为一个SpringBoot应用我们如何来获取配置呢?

Java SDK

首先,我们可以直接使用Nacos提供的Java SDK来获取配置。

首先在项目中,添加如下依赖:

<dependency>
<groupId>com.alibaba.nacos</groupId>
<artifactId>nacos-client</artifactId>
<version>2.1.1</version>
</dependency>

然后可以使用如下代码来获取nacos中的配置:

try {
String serverAddr = "localhost:8848";
String dataId = "user.properties";
String group = "DEFAULT_GROUP";
Properties properties = new Properties();
properties.put("serverAddr", serverAddr);
ConfigService configService = NacosFactory.createConfigService(propert
ies);
String content = configService.getConfig(dataId, group, 5000);
System.out.println(content); } catch (NacosException e) {
// TODO Auto-generated catch block
e.printStackTrace(); }

1. serverAddr:nacos的地址

2. dataId:想要获取的配置文件的名字

3. group:分组

在Java SDK中,除开有获取配置的API,同时也提供了新增、删除、监听配置的API。

我们可以通过如下代码来监听配置的变化:

try {
String serverAddr = "localhost:8848";
String dataId = "user.properties";
String group = "DEFAULT_GROUP";
Properties properties = new Properties();
properties.put("serverAddr", serverAddr);
ConfigService configService = NacosFactory.createConfigService(propert
ies);
String content = configService.getConfig(dataId, group, 5000);
System.out.println(content);
configService.addListener(dataId, group, new Listener() {
public void receiveConfigInfo(String configInfo) {
System.out.println("recieve1:" + configInfo); }
public Executor getExecutor() {
return null; } });
// 测试让主线程不退出,因为订阅配置是守护线程,主线程退出守护线程就会退出。 正式代 码中无需下面代码
while (true) {
try {
Thread.sleep(1000); } catch (InterruptedException e) { e.printStackTrace(); } } } catch (NacosException e) {
// TODO Auto-generated catch block
e.printStackTrace(); }

剩余API,大家可以直接参考官网:
https://nacos.io/zh-cn/docs/sdk.html

Spring在真正开发时,我们不太会通过Java SDK的方式来拉取nacos中的配置,那Nacos有没有针对Spring提供一些比较好用的注解或API呢?

当然是有的

增加一下依赖(不再需要nacos-client依赖了)

<dependency>
 <groupId>com.alibaba.nacos</groupId>
 <artifactId>nacos-spring-context</artifactId>
 <version>1.1.1</version> </dependency>

我们可以按以下方式来配置Spring容器:

@Configuration
@EnableNacosConfig(globalProperties = @NacosProperties(serverAddr = "127.0.
0.1:8848")) @NacosPropertySource(dataId = "user.properties", autoRefreshed = true) @ComponentScan("com.zhouyu")
public class AppConfig { }

很明显,通过@EnableNacosConfig注解定义了nacos的地址,通过@NacosPropertySource表示想要拉取的dataId,并且设置自动刷新(也就是配置发生了改变则会自动生效)。

那如何使用某一个具体的配置项呢:

@Component
public class UserService {
 @NacosValue("${spring.datasource.username}")
 private String username;
 public void test(){
 System.out.println(username);
 } }

可以通过@NacosValue来使用某一具体的配置项,那@Value行不行呢?也是可以的。

之所以可以,原因是@EnableNacosConfig注解会负责把指定的dataId的配置项拉取到应用,并封装为PropertySource对象添加到Environment对象中,所以@Value也能读取到相应的配置项。

SpringBoot

如果我们使用SpringBoot,那则可以比Spring更加简单。

首先引入依赖:

<dependency>
 <groupId>com.alibaba.boot</groupId>
 <artifactId>nacos-config-spring-boot-starter</artifactId>
 <version>0.2.12</version> </dependency>

然后在application.properties中配置nacos的地址:

nacos.config.server-addr=127.0.0.1:8848

然后:

@SpringBootApplication
@NacosPropertySource(dataId = "user.properties", autoRefreshed = true)
public class UserApplication {
 public static void main(String[] args) {
 ConfigurableApplicationContext applicationContext = SpringApplicat
ion.run(UserApplication.class, args);
 UserService userService = applicationContext.getBean(UserService.c
lass);
 userService.test();
 } }

依旧使用@NacosPropertySource来指定要拉取的配置dataId即可,就可以使用@Value或@NacosValue来获取某个具体的配置项了。

那有同学可能会想到,我们可不可以直接在application.properties文件中来配置dataid呢?确实可以:

nacos.config.server-addr=127.0.0.1:8848
nacos.config.data-id=user.properties
nacos.config.bootstrap.enable=true

不过要注意,一定得把
nacos.config.bootstrap.enable设置为true,不然是不行的。

SpringCloud

如果我们是用SpringCloud,那将比SpringBoot更加简单。

总结

本期分享到这就先告一段落了,有对Spring Cloud的用法感兴趣的可以关注我+转发 私信 【292】获取今天这份Nacos的入门学习笔记哦,希望可以对大家的知识认识度有所提升和帮助!

本文暂时没有评论,来添加一个吧(●'◡'●)

欢迎 发表评论:

最近发表
标签列表