Galosys.Foundation.NacosConfig 26.5.20.1

Galosys.Foundation.NacosConfig

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

Galosys.Foundation Nacos 配置中心集成模块，提供 Nacos 配置服务、动态配置监听、健康检查指示器等功能。

功能概览

1. Nacos 配置服务集成

// 自动注册 Nacos 配置服务
services.AddNacosV2Config(opt =>
{
 opt.ConfigUseRpc = false;
 opt.ServerAddresses = serverAddresses;
 opt.Namespace = environment;
 opt.UserName = userName;
 opt.Password = password;
});

2. 动态配置监听

// 配置监听器自动监听 appsettings.json 变更
builder.UseNacosConfig();

3. 健康检查指示器

// Nacos 配置健康检查指示器
public class NacosConfigIndicatorProvider : IIndicatorProvider
{
 public string Name => "nacos.config";

 public async Task<object> ParasAsync()
 {
 // 获取 Nacos 配置状态
 var config = await nacosConfig.GetConfig("appsettings.json", group, 3000);
 return config ?? "未配置";
 }
}

安装

<PackageReference Include="Galosys.Foundation.NacosConfig" Version="x.x.x" />

使用

配置 Nacos 服务

// 在 appsettings.json 中配置
{
 "Nacos": {
 "ServerAddr": [ "http://localhost:60013/" ],
 "UserName": "nacos",
 "Password": "nacos",
 "AccessKey": "",
 "SecretKey": "",
 "Endpoint": ""
 }
}

启用 Nacos 配置

// 在 Program.cs 中
builder.Host.UseNacosConfig();

// 或使用自定义解析器
builder.Host.UseNacosConfig(parser, logAction);

使用配置服务

// 注入 Nacos 配置服务
public class MyService
{
 private readonly INacosConfigService _nacosConfig;

 public MyService(INacosConfigService nacosConfig)
 {
 _nacosConfig = nacosConfig;
 }

 public async Task<string> GetConfigAsync()
 {
 return await _nacosConfig.GetConfig("appsettings.json", "DEFAULT_GROUP", 3000);
 }
}

环境隔离

// 自动根据环境变量设置命名空间
opt.Namespace = Env.GetEnvironment(); // Development, Production 等

// 应用名称作为配置组名
Group = Env.GetApplicationName();

核心类

目录结构

Galosys.Foundation.NacosConfig/
├── Microsoft/
│ └── Extensions/
│ └── Hosting/
│ └── NacosConfigHostBuilderExtensions.cs # 主机扩展方法
├── NacosConfigModule.cs # 模块主类
└── NacosConfigIndicatorProvider.cs # 健康检查指示器

配置选项

依赖

• nacos-sdk-csharp.extensions.configuration
• Galosys.Foundation.Core

注意事项

1. 环境隔离：模块自动根据 ASPNETCORE_ENVIRONMENT 设置 Nacos 命名空间
2. 配置监听：默认监听 appsettings.json 文件变更
3. RPC 配置：默认禁用 RPC，使用 HTTP 协议
4. 安全配置：生产环境应使用 AccessKey/SecretKey 认证
5. 健康检查：通过 IIndicatorProvider 接口提供配置状态监控