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

前言

都说程序员工资高、待遇好， 2022 金九银十到了，你的小目标是 30K、40K，还是 16薪的 20K？作为一名 Java 开发工程师，当能力可以满足公司业务需求时，拿到超预期的 Offer 并不算难。然而，提升 Java 核心能力最快、最有效，短期内升职加薪的方法，到底是什么？

首先，你需要跳出日常工作，接触更有深度、更前沿的顶级项目。一个简单的逻辑：大厂之所以能够给到高于行业水准的薪资，正是因为即使是普通开发人员，也要应对很多复杂的场景。这些复杂场景和项目，就像“墙外的世界”，没有看过，没有接触过，你就无法进行体系化的学习和建立认知，技术壁垒自然就出现了。

所以，如果你期望通过个人努力，实现收入增长和职位晋升，那最好的方式，一定是多学多看多做。

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

并且可以在此⽹⻚上下载安装包：

下载完了之后进⾏解压，解压之后的⽬录为：

1. bin⽬录下是启动和停⽌的脚本

2. conf⽬录下是Nacos的配置⽂件

3. target⽬录下是Nacos的jar包（启动脚本中其实就是运⾏的这个jar包，停⽌脚步中是直接kill到进程）

启动

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

Linux/Unix/Mac

启动命令(standalone代表着单机模式运⾏，⾮集群模式):

sh startup.sh -m standalone
1

如果您使⽤的是ubuntu系统，或者运⾏脚本报错提示[[符号找不到，可尝试如下运⾏：

bash startup.sh -m standalone
1

Windows

启动命令(standalone代表着单机模式运⾏，⾮集群模式):

startup.cmd -m standalone
1

可以发现，默认情况下Nacos占⽤了8848端⼝。

我们可以访问http://localhost:8848/nacos，来访问Nacos：
1

默认的⽤户名和密码为：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来获取配置。

⾸先在项⽬中，添加如下依赖：

com.alibaba.nacos
nacos-client
2.1.1

1
2
3
4
5

然后可以使⽤如下代码来获取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
2
3
4
5
6
7
8
9
10
11
12

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(); }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

剩余API，⼤家可以直接参考官⽹： https://nacos.io/zh-cn/docs/sdk.html

Spring在真正开发时，我们不太会通过Java SDK的⽅式来拉取nacos中的配置，那Nacos有没有针对Spring提供⼀些⽐较好⽤的注解或API呢？

当然是有的

增加⼀下依赖（不再需要nacos-client依赖了）

 com.alibaba.nacos
 nacos-spring-context
 1.1.1 
1
2
3
4

我们可以按以下⽅式来配置Spring容器：

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

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

那如何使⽤某⼀个具体的配置项呢：

@Component
public class UserService {
 @NacosValue("${spring.datasource.username}")
 private String username;
 public void test(){
 System.out.println(username);
 } }
1
2
3
4
5
6
7

可以通过@NacosValue来使⽤某⼀具体的配置项，那@Value⾏不⾏呢？也是可以的。

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

SpringBoot

如果我们使⽤SpringBoot，那则可以⽐Spring更加简单。

首先引入依赖：

 com.alibaba.boot
 nacos-config-spring-boot-starter
 0.2.12 
1
2
3
4

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

nacos.config.server-addr=127.0.0.1:8848
1

然后：

@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();
 } }
1
2
3
4
5
6
7
8
9
10

依旧使⽤@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
1
2
3

不过要注意，⼀定得把
nacos.config.bootstrap.enable设置为true，不然是不⾏的。

SpringCloud

如果我们是⽤SpringCloud，那将⽐SpringBoot更加简单。

总结