Nacos学习文档

原创 已于 2025-04-08 23:12:18 修改 · 1.4k 阅读 · 30 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Nacos

于 2024-11-25 22:21:15 首次发布

目录

1、Nacos是什么

Nacos是一个动态的服务发现、配置管理、服务管理的平台。
其中服务发现包括服务自动注册和发现。
配置管理包括配置的增删改查、在线编辑、历史版本查询以及恢复等
服务管理包括服务元数据管理、优雅上下线。

在这里插入图片描述

2、Nacos名词介绍

  • 命名空间（namespace）：用于进行租户粒度的配置隔离。
    在这里插入图片描述

  • 配置分组（group）：Nacos 中的一组配置集，是组织配置的维度之一。
    在这里插入图片描述

  • 配置集 ID（data id）：Data ID 通常用于组织划分系统的配置集。
    在这里插入图片描述

  • 综上所述：Nacos 数据模型 Key 由三元组唯一确定, Namespace默认是空串，公共命名空间（public），分组默认是 DEFAULT_GROUP。

在这里插入图片描述

3、Nacos中的data id是如何组装的？

在 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 类型。

4、Nacos 融合 Spring Cloud，成为注册配置中心

4.1、Maven依赖作用

  • 集成 spring-cloud-starter-alibaba-nacos-config 依赖实现配置的动态变更。
  • 集成 spring-cloud-starter-alibaba-nacos-discovery 实现服务的注册与发现。

4.2、启动配置管理

4.2.1、添加依赖

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

注意： 版本 2.1.x.RELEASE 对应的是 Spring Boot 2.1.x 版本。版本 2.0.x.RELEASE 对应的是 Spring Boot 2.0.x 版本，版本 1.5.x.RELEASE 对应的是 Spring Boot 1.5.x 版本。

更多版本对应关系参考：版本说明 Wiki

4.2.2、在 bootstrap.yml（也支持properties格式） 中添加 配置中心地址、命名空间、组名、应用名称、环境配置、文件格式

4.2.2.1、名词解释
  • 配置中心地址：必须填写
  • 命名空间（namespace）：默认是public，可以省略；如果不是该值，必须填写
  • 组名（group）：默认是DEFAULT_GROUP，可以省略；如果不是该值，必须填写
  • 配置集ID（data id）
    • 应用名称：必须填写
    • 环境配置：非必须填写
    • 文件格式：必须填写，支持 properties 和 yaml 类型，也包括yml类型
4.2.2.2、bootstrap.yml 示例
# Spring
spring: 
  application:
    # 应用名称
    name: ruoyi-system
  profiles:
    # 环境配置
    active: dev
  cloud:
    nacos:
      config:
        # 配置中心地址
        server-addr: 127.0.0.1:8848
        # 命名空间
        namespace: test_namespace
        # 组名
        group: test_group
        # 配置文件格式
        file-extension: yaml
4.2.2.3、Nacos配置说明

直接看Nacos中的配置信息：
在这里插入图片描述

将bootstrap.yml（左侧）和Nacos（右侧）中的配置信息进行对照：

在这里插入图片描述

4.3、启动服务发现

4.3.1、添加依赖

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

注意： 版本 2.1.x.RELEASE 对应的是 Spring Boot 2.1.x 版本。版本 2.0.x.RELEASE 对应的是 Spring Boot 2.0.x 版本，版本 1.5.x.RELEASE 对应的是 Spring Boot 1.5.x 版本。

更多版本对应关系参考：版本说明 Wiki

4.3.2、在 bootstrap.yml（也支持properties格式） 中添加 注册中心地址、命名空间、组名、应用名称、应用端口

4.3.2.1、名词解释
  • 注册中心地址：必须填写
  • 命名空间（namespace）：默认是public，可以省略；如果不是该值，必须填写
  • 组名（group）：默认是DEFAULT_GROUP，可以省略；如果不是该值，必须填写
  • 应用名称：必须填写
  • 应用端口：必须填写
4.3.2.2、bootstrap.yml 示例
# 端口
server:
  port: 9201

# Spring
spring: 
  application:
    # 应用名称
    name: ruoyi-system
  cloud:
    nacos:
      discovery:
        # 注册中心地址
        server-addr: 127.0.0.1:8848
        # 命名空间
        namespace: test_namespace
        # 组名
        group: test_group
4.3.2.3、Nacos注册结果说明

在这里插入图片描述

其中配置管理和服务管理没啥关系

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

@SpringBootApplication
@EnableDiscoveryClient
public class NacosProviderApplication {

  public static void main(String[] args) {
    SpringApplication.run(NacosProviderApplication.class, args);
  }

  @RestController
  class EchoController {
    @RequestMapping(value = "/echo/{string}", method = RequestMethod.GET)
    public String echo(@PathVariable String string) {
      return "Hello Nacos Discovery " + string;
    }
  }
}

4.4、配置用户名和密码

对于配置中心和注册中心，支持统一设置，也支持分别设置

下面是统一设置的效果，然后分别设置时将用户名和密码放在discovery和config下面一级即可

spring: 
  cloud:
    nacos:
     # 用户名
      username: nacos
     # 密码
      password: nacos
      # 服务注册
      discovery:
        ……
      # 服务配置
      config:
        ……

4.5、共享配置

4.5.1、作用

将公共配置从单个服务中抽取出来，然后共享这些配置，做到一处修改，处处生效。从而降低配置错误的风险

4.5.2、在 bootstrap.yml（也支持properties格式） 中添加 组名、配置集ID、自动刷新策略

4.5.2.1、名词解释
  • 组名（group）：默认是DEFAULT_GROUP，可以省略；如果不是该值，必须填写
  • 配置集ID（data id）：必须填写，即 全名称
  • 自动刷新策略：默认是false，该策略开启后和 @RefreshScope 注解配合后，修改配置内容后立即生效
4.5.2.2、bootstrap.yml 示例
spring: 
  cloud:
    nacos:
      # 服务配置
      config:
        # 配置中心地址
        server-addr: 127.0.0.1:8848
        # 命名空间
        namespace: test_namespace
        # 组名
        group: test_group
        # 配置文件格式
        file-extension: yaml
        # 共享配置
        shared-configs:
            # 组名
          - group: test_group
            # 配置集ID
            data-id: application-dev.yaml
            # 自动刷新策略
            refresh: true
4.5.2.3、Nacos配置说明

在这里插入图片描述

4.6、扩展配置

4.6.1、作用

使用extension-configs，作用和共享配置类似，但是优先级比共享配置高

4.6.2、示例

在这里插入图片描述

4.7、配置自动更新

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

（1）配置@Value注解使用

@RestController
@RequestMapping("/config")
@RefreshScope
public class ConfigController {

    @Value("${useLocalCache:false}")
    private boolean useLocalCache;

    @RequestMapping("/get")
    public boolean get() {
        return useLocalCache;
    }
}

（2）配置@ConfigurationProperties注解使用

/**
 * 放行白名单配置
 * 来自RuoYi-Cloud项目
 * 
 * @author ruoyi
 */
@Configuration
@RefreshScope
@ConfigurationProperties(prefix = "security.ignore")
public class IgnoreWhiteProperties
{
    /**
     * 放行白名单配置，网关不校验此处的白名单
     */
    private List<String> whites = new ArrayList<>();

    public List<String> getWhites()
    {
        return whites;
    }

    public void setWhites(List<String> whites)
    {
        this.whites = whites;
    }
}

4.8、配置优先级

  1. Nacos中具体的服务配置
  2. 扩展配置（多个扩展配置，越靠后优先级越高）
  3. 共享配置（多个共享配置，越靠后优先级越高）
  4. jar包启动的本地配置

4.9、汇总配置文件 bootstrap.yml 示例

# 应用端口
server:
  port: 9201

# Spring
spring: 
  application:
    # 应用名称
    name: ruoyi-system
  profiles:
    # 环境配置
    active: dev
  cloud:
    nacos:
     # 用户名
      username: nacos
     # 密码
      password: nacos
      # 服务注册
      discovery:
        # 注册中心地址
        server-addr: 127.0.0.1:8848
        # 命名空间
        namespace: test_namespace
        # 组名
        group: test_group
      # 服务配置
      config:
        # 配置中心地址
        server-addr: 127.0.0.1:8848
        # 命名空间
        namespace: test_namespace
        # 组名
        group: test_group
        # 配置文件格式
        file-extension: yaml
        # 共享配置
        shared-configs:
            # 组名
          - group: test_group
            # 配置集ID
            data-id: application-shared.yaml
            # 自动刷新策略
            refresh: true
        # 扩展配置
        extension-configs:
            # 组名
          - group: test_group
            # 配置集ID
            data-id: application-extension.yaml
            # 自动刷新策略
            refresh: true

5、其他知识点

5.1、默认轮询方式

根据Nacos官方可知：

Nacos实现负载均衡主要是通过客户端侧的策略来完成的,默认采用的是随机轮询的方式。

支持随机、轮询、加权轮询、一致性hash、最少活跃调用数的轮询方式

Nacos全攻略：从入门到精通，一文吃透
邓邓子的博客
07-15 3435
本文是一篇 Nacos 全攻略指南，从基础到进阶全面解析 Nacos。先介绍 Nacos 作为阿里巴巴开源的动态服务发现、配置管理和服务管理平台的定位及重要性。接着讲解服务、实例等核心概念，阐述服务发现等主要功能，还涵盖环境搭建、作为服务注册中心和配置中心的用法，以及高级特性、与其他组件集成、使用案例和常见问题解决，助力读者从入门到精通 Nacos。
SpringCloud Nacos 完整学习指南
weixin_51040479的博客
08-01 1087
Nacos作为阿里巴巴开源的服务注册与配置中心，提供了动态服务发现、配置管理和DNS服务三大核心功能。本文详细介绍了Nacos的架构原理、安装部署、服务发现、配置管理等核心功能，并重点讲解了与SpringCloud的集成方法。在实战案例部分，展示了微服务项目搭建和服务间调用的实现，同时深入探讨了多环境管理、灰度发布等高级特性。文章还提供了命名规范、配置管理策略等最佳实践建议，以及性能优化和故障排查的实用技巧。通过学习本文，开发者可以全面掌握Nacos在生产环境中的应用，构建高效可靠的微服务架构。
nacos中文文档.pdf
11-08
阿里巴巴研发的注册中心nacos中文文档，阿里巴巴研发的注册中心nacos中文文档。
19.注册中心之Nacos-全网最全文档
weixin_43159673的博客
03-16 2322
微服务注册中心之Nacos, 主要说明 nacos 的下载安装，使用配置。以及集群环境下的使用。
微服务-Nacos 技术详解
最新发布
new_daimond的博客
09-29 1191
Nacos技术摘要 Nacos是阿里巴巴开源的服务发现与配置管理平台，支持动态服务注册发现、配置管理和服务治理。核心特性包括多协议服务注册、健康检查、元数据管理、动态配置更新和多环境支持。其架构分为Server端(包含注册、配置和核心模块)和Client SDK(包含服务发现、配置管理和负载均衡)。
nacos学习带md.zip
10-02
标题中的“nacos学习带md.zip”表明这是一个关于Nacos学习资源的压缩包，其中包含Markdown格式的学习笔记。描述提到这是在千X达摩院学习Spring Cloud Alibaba时使用的代码工程和相关的md（Markdown）文件，暗示了...
Nacos学习及详细解释配置与注册
热门推荐
Java后端技术栈
02-17 2万+
Nacos详细解释配置与注册_L_Sueno的博客-CSDN博客_nacos配置文件详解
nacos安装和启动文档
05-21
### Nacos 1.4.0 的安装与启动详解 #### 一、Nacos简介 ...通过本文的学习，可以帮助用户更好地理解和掌握 Nacos 的基本使用方法，从而更高效地利用 Nacos 进行服务发现、配置管理和服务管理等工作。
Nacos详细使用操作文档(图文详细)
战丶后风！！的博客
02-17 1万+
总结: 只需要给Nacos中创建一个dataId名称叫做 当前项目名.properties 当前项目名.yaml。使用namespace来区分不同的服务【每个服务都有自己的名称空间】。集中管理配置、配置动态更新、回滚配置…
nacos-api-1.2.0-API文档-中文版.zip
06-06
赠送jar包：nacos-api-1.2.0.jar； 赠送原API文档：nacos-api-1.2.0-javadoc.jar； 赠送源代码：nacos-api-1.2.0-sources.jar； 赠送Maven依赖信息文件：nacos-api-1.2.0.pom； 包含翻译后的API文档：nacos-api-1.2.0-javadoc-API文档-中文(简体)版.zip； Maven坐标：com.alibaba.nacos:nacos-api:1.2.0； 标签：alibaba、nacos、api、中文文档、jar包、java； 使用方法：解压翻译后的API文档，用浏览器打开“index.html”文件，即可纵览文档内容。 人性化翻译，文档中的代码和结构保持不变，注释和说明精准翻译，请放心使用。
nacos1.2.1
07-07
备份，github太慢了。已配置好数据库456445564564564564564564564564564564
nacos 官方以及社区文档
Jsouzg的博客
04-12 9040
转载：https://nacos.io/zh-cn/docs/quick-start-spring.html
nacos入门文档 (一)
weixin_50016065的博客
06-16 770
nacos入门
SpringCloud Alibaba Nacos注册中心官方文档——快速开始
偏执即为魔的博客
02-23 9810
SpringCloud Alibaba Nacos注册中心快速开始——入门
nacos入门文档(二)
weixin_50016065的博客
06-20 476
nacos拉取远程配置文件
Nacos安装文档
大强博客
10-22 462
1、下载Nacos 从Nacos官方Github最新的稳定版本中下载软件包 以发布 .zip为例： 解压缩nacos-server-1.3.2.zip cd nacos/bin 2、创建数据库 创建数据库：nacos 执行SQL脚本：nacos-server-1.3.2\conf\nacos-mysql.sql 3、配置Nacos 修改配置文件：nacos-server-1.3.2\conf\application.properties #*************** Config Module Rela
nacos使用说明文档--fager
fager漫长路
11-01 5721
场景一：单个yaml测试 某应用只导入单个配置文件，设置如下键确定配置文件： #配置文件名 spring.application.name #配置文件扩展名 spring.cloud.nacos.config.file-extension #配置文件所在的组名 spring.cloud.nacos.config.group #此处主要是测试是否能读取yaml格式的配置文件 一、添加依赖 1.Nac...
Nacos API文档中英双语对照版发布
资源摘要信息:"nacos-common-2.0.4.RELEASE-API文档-中英对照版.zip文件是与nacos-common相关的一个资源压缩包，该包不仅包含了nacos-common 2.0.4版本的核心jar文件，还包括了该版本的源代码、Maven依赖信息文件...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值