nacos 使用文档

傷城~ 2024-04-17 22:37 73阅读 0赞

### 文章目录 ###

*  什么是 Nacos
 *   *  概览
     *  什么是 Nacos？
     *  nacos server 准备
     *  nacos 作为注册中心，在 springboot 使用
     *   *  0 前置条件
         *  1 依赖引入
         *  2 @EnableDiscoveryClient 开启
         *  3 新增配置
         *  4 效果
         *  5 更多关于 nacos 注册中心
     *  nacos 作为配置中心，在 springboot 使用
     *   *  1 依赖引入
         *  2 新增配置
         *  3 在配置中心添加相关配置文件
         *  4 注意事项
         *  5 更多关于 nacos 配置中心
     *  nacos 官方文档

# 什么是 Nacos #

## 概览 ##

欢迎来到 Nacos 的世界！

Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。

Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。

## 什么是 Nacos？ ##

服务（Service）是 Nacos 世界的一等公民。Nacos 支持几乎所有主流类型的“服务”的发现、配置和管理

Nacos 的关键特性包括:

*  服务发现和服务健康监测

Nacos 支持基于 DNS 和基于 RPC 的服务发现。服务提供者使用 原生SDK、OpenAPI、或一个独立的Agent TODO注册 Service 后，服务消费者可以使用DNS TODO 或HTTP&API查找和发现服务。

Nacos 提供对服务的实时的健康检查，阻止向不健康的主机或服务实例发送请求。Nacos 支持传输层 (PING 或 TCP)和应用层 (如 HTTP、MySQL、用户自定义）的健康检查。 对于复杂的云环境和网络拓扑环境中（如 VPC、边缘网络等）服务的健康检查，Nacos 提供了 agent 上报模式和服务端主动检测2种健康检查模式。Nacos 还提供了统一的健康检查仪表盘，帮助您根据健康状态管理服务的可用性及流量。

*  动态配置服务

动态配置服务可以让您以中心化、外部化和动态化的方式管理所有环境的应用配置和服务配置。

动态配置消除了配置变更时重新部署应用和服务的需要，让配置管理变得更加高效和敏捷。

配置中心化管理让实现无状态服务变得更简单，让服务按需弹性扩展变得更容易。

Nacos 提供了一个简洁易用的UI (控制台样例 Demo) 帮助您管理所有的服务和应用的配置。Nacos 还提供包括配置版本跟踪、金丝雀发布、一键回滚配置以及客户端配置更新状态跟踪在内的一系列开箱即用的配置管理特性，帮助您更安全地在生产环境中管理配置变更和降低配置变更带来的风险。

*  动态 DNS 服务

动态 DNS 服务支持权重路由，让您更容易地实现中间层负载均衡、更灵活的路由策略、流量控制以及数据中心内网的简单DNS解析服务。动态DNS服务还能让您更容易地实现以 DNS 协议为基础的服务发现，以帮助您消除耦合到厂商私有服务发现 API 上的风险。

Nacos 提供了一些简单的 DNS APIs TODO 帮助您管理服务的关联域名和可用的 IP:PORT 列表.

*  服务及其元数据管理

Nacos 能让您从微服务平台建设的视角管理数据中心的所有服务及元数据，包括管理服务的描述、生命周期、服务的静态依赖分析、服务的健康状态、服务的流量管理、路由及安全策略、服务的 SLA 以及最首要的 metrics 统计数据。

## nacos server 准备 ##

> https://nacos.io/zh-cn/docs/quick-start.html

## nacos 作为注册中心，在 springboot 使用 ##

### 0 前置条件 ###

> nacos server

### 1 依赖引入 ###

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

*  注意：版本 0.2.x.RELEASE 对应的是 Spring Boot 2.x 版本，版本 0.1.x.RELEASE 对应的是 Spring Boot 1.x 版本。

> 依赖地址 https://mvnrepository.com/artifact/com.alibaba.boot/nacos-config-spring-boot-starter

### 2 @EnableDiscoveryClient 开启 ###

> 使用 @EnableDiscoveryClient 开启注册中心 client 端

### 3 新增配置 ###

# nacos 注册中心（配置集群用多个逗号分隔）
    spring.cloud.nacos.discovery.server-addr=host:8848

### 4 效果 ###

![nacos-client.png][]

### 5 更多关于 nacos 注册中心 ###

> https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-discovery

## nacos 作为配置中心，在 springboot 使用 ##

### 1 依赖引入 ###

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

*  注意：版本 0.2.x.RELEASE 对应的是 Spring Boot 2.x 版本，版本 0.1.x.RELEASE 对应的是 Spring Boot 1.x 版本。

> 依赖地址 https://mvnrepository.com/artifact/com.alibaba.boot/nacos-config-spring-boot-starter

### 2 新增配置 ###

> 应用基本配置

server.port=${port:8088}
    spring.application.name=application-name
    spring.profiles.active=dev

> 配置中心配置 以下配置文件必须放在 bootstrap.properties 中

# nacos 配置中心, 该配置由 BootstrapConfiguration 加载，必须配置到 bootstrap.properties
    spring.cloud.nacos.config.server-addr=host:8848
    # 配置 NAMESPACE
    spring.cloud.nacos.config.namespace=xxx
    # 配置 GROUP
    spring.cloud.nacos.config.group=xxx

### 3 在配置中心添加相关配置文件 ###

> 这里就放一些业务的配置

\[外链图片转存失败(img-VE3pj7jp-1567406902625)(https://i.loli.net/2019/07/29/5d3eb6837627010673.png)\]

### 4 注意事项 ###

*  nacos 层级关系

-- namespace (命名空间) --> 一般用应用名 ， 阿里最佳实践是用来隔离 prod,dev,test 环境
    ---- group (组) --> 一般可以设置成 子级 应用名 
    -------- dataid (配置文件唯一id)

*  dataid 规范

>  s p r i n g . a p p l i c a t i o n . n a m e − \{spring.application.name\}- spring.application.name−\{profile\}.$\{file-extension:properties\}

spring.application.name 配置的应用名

profile 激活的配置 如 dev/test/prod

file-extension 文件扩展名

--------------------

### 5 更多关于 nacos 配置中心 ###

> https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-config

## nacos 官方文档 ##

> https://nacos.io/zh-cn/docs/what-is-nacos.html

[nacos-client.png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pLmxvbGkubmV0LzIwMTkvMDcvMjkvNWQzZWI1NTVkOGQ2YzM1NTUxLnBuZw?x-oss-process=image/format,png