一、什么是Nacos?

Nacos官方文档:https://nacos.io/zh-cn/docs/what-is-nacos.html
Nacos 支持基于 DNS 和基于 RPC 的服务发现(可以作为springcloud的注册中心)、动态配置服务(可以做配置中心)、动态 DNS 服务。

二、基本概念

命名空间 namespace

用于进行租户粒度的配置隔离。不同的命名空间下,可以存在相同的 Group 或 Data ID 的配置。Namespace 的常用场景之一是不同环境的配置的区分隔离,例如开发测试环境和生产环境的资源(如配置、服务)隔离等。

配置集

一组相关或者不相关的配置项的集合称为配置集。在系统中,一个配置文件通常就是一个配置集,包含了系统各个方面的配置。例如,一个配置集可能包含了数据源、线程池、日志级别等配置项。

配置集ID Data ID

Nacos 中的某个配置集的 ID。配置集 ID 是组织划分配置的维度之一。Data ID 通常用于组织划分系统的配置集。一个系统或者应用可以包含多个配置集,每个配置集都可以被一个有意义的名称标识。Data ID 通常采用类 Java 包(如 com.taobao.tc.refund.log.level)的命名规则保证全局唯一性。此命名规则非强制。

配置分组 group

Nacos 中的一组配置集,是组织配置的维度之一。通过一个有意义的字符串(如 Buy 或 Trade )对配置集进行分组,从而区分 Data ID 相同的配置集。当您在 Nacos 上创建一个配置时,如果未填写配置分组的名称,则配置分组的名称默认采用 DEFAULT_GROUP 。配置分组的常见场景:不同的应用或组件使用了相同的配置类型,如 database_url 配置和 MQ_topic 配置。

配置快照

Nacos 的客户端 SDK 会在本地生成配置的快照。当客户端无法连接到 Nacos Server 时,可以使用配置快照显示系统的整体容灾能力。配置快照类似于 Git 中的本地 commit,也类似于缓存,会在适当的时机更新,但是并没有缓存过期(expiration)的概念。

三、Nacos Spring Cloud快速开始

启动配置管理

启动Nacos server后,参考以下代码,为Spring Cloud应用启动Nacos配置管理服务。

1. 添加依赖

  1. <dependency>
  2. <groupId>com.alibaba.cloud</groupId>
  3. <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  4. <version>${latest.version}</version>
  5. </dependency>

2. 配置文件中配置Nacos server的地址和应用名

  1. spring.cloud.nacos.config.server-addr=127.0.0.1:8848
  2. spring.application.name=example

在Nacos Spring Cloud中,dataId完整格式如下: ${prefix}-${spring.profiles.active}.${file-extension}

  • prefix 默认为 spring.application.name 的值,也可以通过配置项 spring.cloud.nacos.config.prefix来配置。
  • spring.profiles.active 即为当前环境对应的 profile,详情可以参考 Spring Boot文档注意:当 spring.profiles.active 为空时,对应的连接符 - 也将不存在,dataId 的拼接格式变成 ${prefix}.${file-extension}
  • file-exetension 为配置内容的数据格式,可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

3. 通过Spring cloud原生注解 @RefreshScope 实现配置自动更新

  1. @RestController
  2. @RequestMapping("/config")
  3. @RefreshScope
  4. public class ConfigController {
  5. @Value("${useLocalCache:false}")
  6. private boolean useLocalCache;
  7. @RequestMapping("/get")
  8. public boolean get() {
  9. return useLocalCache;
  10. }
  11. }

启动服务发现

1. 添加依赖

  1. <dependency>
  2. <groupId>com.alibaba.cloud</groupId>
  3. <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
  4. <version>${latest.version}</version>
  5. </dependency>

2. 服务提供者

① 配置文件中配置Nacos sercer的地址

  1. server.port=8070
  2. spring.application.name=service-provider
  3. spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

② 通过Spring Cloud原生注解 @EnableDiscoveryClient 开启服务注册发现功能。

  1. @SpringBootApplication
  2. @EnableDiscoveryClient
  3. public class NacosProviderApplication {
  4. public static void main(String[] args) {
  5. SpringApplication.run(NacosProviderApplication.class, args);
  6. }
  7. @RestController
  8. class EchoController {
  9. @RequestMapping(value = "/echo/{string}", method = RequestMethod.GET)
  10. public String echo(@PathVariable String string) {
  11. return "Hello Nacos Discovery " + string;
  12. }
  13. }
  14. }

3. 服务消费者

① 配置文件中配置Nacos server的地址

  1. server.port=8080
  2. spring.application.name=service-consumer
  3. spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

② 通过Spring Cloud原生注解@EnableDiscoveryClient开启服务注册发现功能。

  1. @SpringBootApplication
  2. @EnableDiscoveryClient
  3. public class NacosConsumerApplication {
  4. @LoadBalanced // 开启RestTemplate与Ribbon的集成
  5. @Bean
  6. public RestTemplate restTemplate() {
  7. return new RestTemplate();
  8. }
  9. public static void main(String[] args) {
  10. SpringApplication.run(NacosConsumerApplication.class, args);
  11. }
  12. @RestController
  13. public class TestController {
  14. private final RestTemplate restTemplate;
  15. @Autowired
  16. public TestController(RestTemplate restTemplate) {this.restTemplate = restTemplate;}
  17. @RequestMapping(value = "/echo/{str}", method = RequestMethod.GET)
  18. public String echo(@PathVariable String str) {
  19. return restTemplate.getForObject("http://service-provider/echo/" + str, String.class);
  20. }
  21. }
  22. }

四、问题

Nacos配置刷新后,加密项无法解密的问题

解决:https://www.yuque.com/qvnuor/aflpni/ko0d24