👁 Image
SyZero.Consul 1.1.9

SyZero.Consul

SyZero 框架的 Consul 服务注册与发现模块。

📦 安装

dotnet add package SyZero.Consul

✨ 特性

• 🚀 服务注册 - 自动注册服务到 Consul
• 🔍 服务发现 - 从 Consul 发现可用服务
• 💓 健康检查 - 内置健康检查支持
• ⚙️ 配置中心 - 支持从 Consul KV 读取配置

🚀 快速开始

1. 配置 appsettings.json

{
 "Consul": {
 "ConsulAddress": "http://localhost:8500",
 "Token": "",
 "ServiceName": "my-service",
 "ServiceAddress": "localhost",
 "ServicePort": 5000,
 "HealthCheckUrl": "/health"
 }
}

2. 注册服务

// Program.cs
var builder = WebApplication.CreateBuilder(args);
// 添加SyZero
builder.AddSyZero();

// 注册服务方式1 - 使用配置文件
builder.Services.AddConsul();

// 注册服务方式2 - 使用委托配置
builder.Services.AddConsul(options =>
{
 options.ConsulAddress = "http://localhost:8500";
 options.ServiceName = "my-service";
 options.ServicePort = 5000;
});

// 注册服务方式3 - 指定配置节
builder.Services.AddConsul(builder.Configuration, "Consul");

var app = builder.Build();
// 使用SyZero
app.UseSyZero();
app.Run();

3. 使用示例

public class MyService
{
 private readonly IServiceManagement _serviceManagement;

 public MyService(IServiceManagement serviceManagement)
 {
 _serviceManagement = serviceManagement;
 }

 public async Task<string> GetServiceUrlAsync(string serviceName)
 {
 var service = await _serviceManagement.GetServiceAsync(serviceName);
 return $"{service.Address}:{service.Port}";
 }
}

📖 配置选项

📖 API 说明

IServiceManagement 接口

所有方法都有对应的异步版本（带 Async 后缀）

🔧 高级用法

从 Consul KV 读取配置

builder.Configuration.AddConsulConfiguration(options =>
{
 options.Address = "http://localhost:8500";
 options.Key = "config/my-service";
});

服务健康检查

app.MapHealthChecks("/health");

⚠️ 注意事项

1. 网络连接 - 确保应用能访问 Consul 服务
2. 健康检查 - 必须配置健康检查端点
3. 服务注销 - 应用退出时会自动注销服务

📄 许可证

MIT License - 详见