SpringCloud Alibaba-Nacos

1：作为注册中心

Nacos 是阿里巴巴开源的一个更易于构建云原生应用的动态服务发现、配置管理和服务管理

平台。他是使用 java 编写。需要依赖 java 环境

Nacos 文档地址： https://nacos.io/zh-cn/docs/quick-start.html

1 ）、下载 nacos-server

https://github.com/alibaba/nacos/releases

2 ）、启动 nacos-server

双击 bin 中的 startup.cmd 文件

访问 http://localhost:8848/nacos/

使用默认的 nacos/nacos 进行登录

3 ）、将微服务注册到 nacos 中

1 、首先，修改 pom.xml 文件，引入 Nacos Discovery Starter 。

<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2 、在应用的 /src/main/resources/application.properties 配置文

件中配置 Nacos Server 地址

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

3 、使用 @EnableDiscoveryClient 开启服务注册发现功能

@SpringBootApplication
@EnableDiscoveryClient
public class ProviderApplication {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}

4 、启动应用，观察 nacos 服务列表是否已经注册上服务

注意：每一个应用都应该有名字，这样才能注册上去。修改 application.properties 文件

spring.application.name=service-provider

server.port=8000

5 、注册更多的服务上去，测试使用 feign 远程调用

Nacos 使用三步
1、导包 nacos-discovery
2、写配置，指定 nacos 地址，指定应用的名字
3、开启服务注册发现功能@EnableDiscoveryClient
Feign 使用三步
1、导包 openfeign
2、开启@EnableFeignClients 功能
3、编写接口，进行远程调用
@FeignClient("stores")
public interface StoreClient {
@RequestMapping(method = RequestMethod.GET, value = "/stores")
List<Store> getStores();
@RequestMapping(method = RequestMethod.POST, value = "/stores/{storeId}", consumes = "application/json")
Store update(@PathVariable("storeId") Long storeId, Store store);
}

2：作为配置中心

1 、 pom.xml 引入 Nacos Config Starter 。

<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency

2 、在应用的 /src/main/resources/bootstrap.properties 配 置文件中配置 Nacos Config 元数据

spring.application.name=nacos-config-example
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
主要配置应用名和配置中心地址

3、在 nacos 中添加配置

在 nacos 中创建一个 应用名 .properties 配置文件并编写配置

Nacos Config 数据结构
Nacos Config 主要通过 dataId 和 group 来唯一确定一条配置。
Nacos Client 从 Nacos Server 端获取数据时，调用的是此接口 ConfigService.getConfig(String
dataId, String group, long timeoutMs)。
Spring Cloud 应用获取数据
dataID：
在 Nacos Config Starter 中，dataId 的拼接格式如下
 ${prefix} - ${spring.profiles.active} . ${file-extension} prefix 默认为 spring.application.name
的值，也可以通过配置项 spring.cloud.nacos.config.prefix 来配置。
 spring.profiles.active 即为当前环境对应的 profile
注意，当 activeprofile 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成
${prefix}.${file-extension}
file-extension 为配置内容的数据格式，可以通过配置项
spring.cloud.nacos.config.file-extension 来配置。 目前只支持 properties 类型。
Group：
Group 默认为 DEFAULT_GROUP，可以通过 spring.cloud.nacos.config.group 配置。

4 、在应用中使用 @Value 和 @RefreshScope

完成上述两步后，应用会从 Nacos Config 中获取相应的配置，并添加在 Spring Environment
的 PropertySources 中 。 这 里 我 们 使 用 @Value 注 解 来 将 对 应 的 配 置 注 入 到
SampleController 的 userName 和 age 字段，并添加 @RefreshScope 打开动态刷新功能
@RefreshScope
class SampleController {
@Value("${user.name}")
String userName;
@Value("${user.age}")
int age;
}

3：进阶

1 、核心概念

命名空间：

用于进行租户粒度的配置隔离。不同的命名空间下，可以存在相同的 Group 或 Data ID 的

配置。 Namespace 的常用场景之一是不同环境的配置的区分隔离，例如开发测试环境和生

产环境的资源（如配置、服务）隔离等。

配置集： 一组相关或者不相关的配置项的集合称为配置集。在系统中，一个配置文件通常就是一个配

置集，包含了系统各个方面的配置。例如，一个配置集可能包含了数据源、线程池、日志级

别等配置项。

配置集 ID ：

Nacos 中的某个配置集的 ID 。配置集 ID 是组织划分配置的维度之一。 Data ID 通常用于组

织划分系统的配置集。一个系统或者应用可以包含多个配置集，每个配置集都可以被一个有

意义的名称标识。 Data ID 通常采用类 Java 包（如 com.taobao.tc.refund.log.level ）的命名

规则保证全局唯一性。此命名规则非强制。

配置分组：

Nacos 中的一组配置集，是组织配置的维度之一。通过一个有意义的字符串（如 Buy 或

Trade ）对配置集进行分组，从而区分 Data ID 相同的配置集。当您在 Nacos 上创建一个

配置时，如果未填写配置分组的名称，则配置分组的名称默认采用 DEFAULT_GROUP 。配置

分组的常见场景：不同的应用或组件使用了相同的配置类型，如 database_url 配置和

MQ_topic 配置。

2 、原理

自动注入：

NacosConfigStarter 实现了 org.springframework.cloud.bootstrap.config.PropertySourceLocator

接口，并将优先级设置成了最高。

在 Spring Cloud 应用启动阶段，会主动从 Nacos Server 端获取对应的数据，并将获取到的

数据转换成 PropertySource 且注入到 Environment 的 PropertySources 属性中，所以使用

@Value 注解也能直接获取 Nacos Server 端配置的内容。

动态刷新：

Nacos Config Starter 默认为所有获取数据成功的 Nacos 的配置项添加了监听功能，在监听

到服务端配置发生变化时会实时触发

org.springframework.cloud.context.refresh.ContextRefresher 的 refresh 方法 。

如果需要对 Bean 进行动态刷新，请参照 Spring 和 Spring Cloud 规范。 推荐给类添加

@RefreshScope 或 @ConfigurationProperties 注解，

3 、加载多配置文件

spring.cloud.nacos.config.server-addr = 127.0.0.1:8848

spring.cloud.nacos.config.namespace = 31098de9-fa28-41c9-b0bd-c754ce319ed4

spring.cloud.nacos.config.ext-config[ 0 ].data-id = gulimall-datasource.yml

spring.cloud.nacos.config.ext-config[ 0 ].refresh = false

spring.cloud.nacos.config.ext-config[ 0 ].group = dev

4 、 namespace 与 group 最佳实践

每个微服务创建自己的 namespace 进行隔离， group 来区分 dev ， beta ， prod 等环境