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 接口提供配置状态监控