Asp.net 6 使用Nacos 培训文稿

什么是Nacos

Nacos 是阿里巴巴开源的一款动态服务发现、配置管理和服务管理平台。它主要用于帮助构建云原生应用。以下是 Nacos 的一些主要功能：

1. 服务发现与服务健康监测：Nacos 提供了动态服务发现的功能，服务可以在 Nacos 上注册和发现，通过 Nacos 注册中心，服务实例可以动态注册和注销，客户端也可以实时感知到服务实例的变化。同时，Nacos 提供了健康检查机制，确保服务的可用性。
2. 服务配置管理：Nacos 提供了一个集中化的配置管理平台，支持动态配置更新。开发者可以在 Nacos 上管理应用的配置，通过 Nacos 提供的 API，可以动态地获取和更新配置，确保配置的实时性和一致性。
3. 动态 DNS 服务：Nacos 提供了动态 DNS 功能，支持通过 DNS 协议查询服务地址。这样，客户端可以通过简单的 DNS 查询获取服务实例的 IP 地址。
4. 服务管理：Nacos 提供了服务的管理功能，包括服务的权重调整、路由规则、流量控制等，帮助开发者更加灵活地管理和调度服务流量。

Nacos 支持的主要功能和特性：
• 多种服务注册与发现协议：支持 HTTP、DNS、gRPC 等多种协议的服务注册与发现。
• 灵活的配置管理：支持命名空间、配置分组、配置历史版本管理等高级配置管理功能。
• 易用的管理界面：提供了友好的 Web 管理界面，方便用户对服务和配置进行管理和监控。
• 高可用和高扩展性：支持集群部署，提供高可用性和高扩展性，能够满足大规模分布式系统的需求。

Nacos 通常被用于微服务架构中，帮助解决服务间通信、配置管理和服务治理等问题，是云原生应用开发的重要工具之一。

集成 Nacos

在项目中安装Nacos Nuget 包：

dotnet add package nacos-sdk-csharp

1. nacos 的AspNetCore 扩展包

dotnet add package nacos-sdk-csharp.AspNetCore 

2. nacos 的配置扩展包，不需要统一配置管理可以不安装

dotnet add package nacos-sdk-csharp.Extensions.Configuration 

3. 解析yaml文件用的，不需要可以不安装

dotnet add package nacos-sdk-csharp.YamlParser 

4. 解析ini文件用的，不需要可以不安装

dotnet add package nacos-sdk-csharp.IniParser

Tip：nacos-sdk-csharp 1.0版本及其以上版本支持nacos1.x和nacos2.x 服务，nacos-sdk-csharp1.0以下版本只支持nacos 1.x

实现服务注册与发现

1. 首先，在项目里配置nacos 注册中心

  "Nacos": {
    //nacos服务地址
    "ServerAddresses": [ "http://127.0.0.1:8848/" ],
    //命名空间GUID,public默认没有
    "Namespace": "",
    "UserName": "nacos",
    "Password": "nacos",
    //服务发现
    //当前应用注册的服务名称
    "ServiceName": "net-service",
    //当前应用注册到的组
    "GroupName": "NET"
  },

2. 接着，在Program.cs中注入nacos服务注册

builder.Services.AddNacosAspNet(builder.Configuration, section: "Nacos");

配置管理

1. 首先，在项目里配置nacos 配置参数

    // 配置中心
    "Listeners": [
      {
        //配置组
        "Group": "DEFAULT_GROUP",
        //配置id
        "DataId": "1",
        //是否为可选配置
        "Optional": false
      }
    ],

3. 接着，在Program.cs中注入nacos配置管理

  builder.Configuration.AddNacosV2Configuration(builder.Configuration.GetSection("Nacos"));