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

前言

Nacos /nɑ:kəʊs/ 是 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的用法感兴趣的可以点赞支持一下获取今天这份Nacos的入门学习笔记哦，希望可以对大家的知识认识度有所提升和帮助！