Galosys.Foundation.NacosNaming 26.5.20.1

Galosys.Foundation.NacosNaming

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

基于 Nacos 的服务注册与发现模块，提供服务注册、发现及相关扩展功能。

功能概述

• 服务注册: 将应用服务自动注册到 Nacos 服务端
• 服务发现: 支持从 Nacos 获取健康服务实例
• 服务健康检查: 支持健康实例筛选
• 元数据管理: 支持自定义服务元数据

依赖项

• Nacos.SDK
• Microsoft.Extensions.Options
• Microsoft.Extensions.ServiceDiscovery

配置说明

在 appsettings.json 中配置 Nacos 相关参数:

{
 "Nacos": {
 "ServerAddr": ["http://localhost:8848"],
 "UserName": "nacos",
 "Password": "nacos",
 "ClusterName": "DEFAULT",
 "GroupName": "DEFAULT_GROUP",
 "RegisterEnabled": true,
 "AccessKey": "",
 "SecretKey": "",
 "Endpoint": ""
 }
}

配置项说明

使用方法

1. 服务注册

模块会自动将服务注册到 Nacos，无需手动配置:

// 自动从环境变量获取服务地址和端口进行注册
// 服务名称自动从环境变量或配置中获取

2. 服务发现

通过 HTTP 端点调用其他已注册服务:

// 使用 HttpClient 直接请求 Nacos 注册的服务
// 格式: http://{服务名}

3. 扩展方法

获取健康服务实例地址:

var instance = await nacosNamingService.SelectOneHealthyInstance(
 serviceName,
 groupName,
 clusterList,
 healthyOnly
);

instance.TryGetHealthyUrl(out var url);
// url 格式: http://ip:port

注意事项

• 确保 Nacos 服务端正常运行
• 服务端口需与 Nacos 配置一致
• 生产环境请妥善保管用户名密码
• 可通过 RegisterEnabled 禁用注册功能，适用于网关等场景