Ocelot\Consul\.NetCore的微服务应用案例

已于 2025-05-01 21:29:35 修改
阅读量1.1k 收藏 12
点赞数 19
文章标签： consul .netcore
于 2025-05-01 21:23:45 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ly1h1/article/details/147655369
版权

案例资料链接：https://download.csdn.net/download/ly1h1/90733765

1.效果

实现两个微服务ServerAPI1和ServerAPI2的负载均衡以及高可用。具体原理，看以下示意图。

2.部署条件

 1、腾讯云的轻量化服务器

 2、WindowServer2016 

 3、.NETCore7.0

 4、Negut 包：Consul1.7.14.7、Ocelot16.0.1、Ocelot.Provider.Conusl16.0.1

 5、.NET捆绑托管 dotnet-hosting-9.0.4-win.exe

3.开放端口

 2.1 云服务安全组端口开放

  端口：5000，是服务1

  端口：5001，是服务2

  端口：5010，是Ocelot网关

  端口：8050/8030/8031/8032,是Consul的端口

  • 8500 是核心 API 端口，必知；

  • 8030/31/32 需结合具体配置，可能是用户自定义的服务或工具端口。

2.2 服务器配置入栈站规则

3.Consul配置（部署可参考链接Consul安装部署（Windows环境）-CSDN博客）

{
  "datacenter": "dc1",
  "data_dir": "C:\\consul\\data",
  "node_name": "node-10-4-0-7",
  "bind_addr": "0.0.0.0",
  "advertise_addr": "10.0.4.7",（云服务内网的IP）
  "client_addr": "0.0.0.0",
  "ports": {
    "http": 8500,
    "dns": 8600,
    "grpc": -1
  },
  "ui_config": {
    "enabled": true
  },
  "server": true,
  "bootstrap": true,
  "log_level": "ERROR",
  "disable_update_check": true,
  "performance": {
    "raft_multiplier": 3,
    "leave_drain_time": "5s"
  }
}

4.Ocelot代码

4.1 Progrm.CS

using Ocelot.DependencyInjection;
using Ocelot.Middleware;
using Ocelot.Provider.Consul; // 引入 Consul 支持

var builder = WebApplication.CreateBuilder(args);

// 1. 配置 Kestrel 只监听 5010 端口（不绑定特定 IP）
builder.WebHost.UseUrls("http://*:5010"); // 监听所有网络接口
// 或者用 ConfigureKestrel（更灵活）：
// builder.WebHost.ConfigureKestrel(serverOptions => serverOptions.ListenAnyIP(5010));

// 2. 加载 Ocelot 配置
builder.Configuration.AddJsonFile("ocelot.json", optional: false, reloadOnChange: true);

// 3. 添加 Ocelot 和 Consul 支持
builder.Services
    .AddOcelot(builder.Configuration)
    .AddConsul(); // 关键：注入 Consul 提供程序

var app = builder.Build();

// 4. 使用 Ocelot 中间件
await app.UseOcelot();
app.Run();

4.2 Ocelot.JSON

{
  "Routes": [
    {
      "DownstreamPathTemplate": "/api/values/{action}",
      "UpstreamPathTemplate": "/api/values/{action}",
      "ServiceName": "ServerAPI",
      "LoadBalancerOptions": {
        "Type": "RoundRobin"
      },
      "ServiceDiscoveryProvider": {
        "Type": "Consul",
        "Host": "43.162.118.209",
        "Port": 8500,
        "PollingInterval": 2000, // 每2秒从Consul拉取最新健康实例
        "SkipItemsWithUnhealthyStatus": true
      }
    }
  ]
}

5.服务1代码

5.1 Program.CS

using Consul;
using Microsoft.OpenApi.Models;

var builder = WebApplication.CreateBuilder(args);

// 添加控制器和Swagger
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "ServerAPI1", Version = "v1" });
});

// 注册Consul客户端
builder.Services.AddSingleton<IConsulClient>(new ConsulClient(c =>
{
    c.Address = new Uri("http://192.168.0.102:8500");
}));

// 配置Kestrel（可选，根据实际需求）
builder.WebHost.UseUrls("http://*:5000");

var app = builder.Build();



// 健康检查端点
//app.MapGet("/health", () => Results.Ok("Healthy"));

// 健康检查端点（模拟5000端口故障）
//app.MapGet("/health", (HttpContext context) =>
//{
//    var port = context.Request.Host.Port;
//    return port == 5000 ? Results.StatusCode(503) : Results.Ok("Healthy (Port: " + port + ")");
//});
//app.MapGet("/health", () => Results.Ok("Healthy (Port: 5000)"));
app.MapGet("/health", () =>
{
    // 基础存活检查（不依赖任何业务逻辑）
    return Results.Ok("Alive");
});

// 注册到Consul
var consulClient = app.Services.GetRequiredService<IConsulClient>();
var registration = new AgentServiceRegistration
{
    ID = "ServerAPI-5000",
    Name = "ServerAPI",
    Address = "192.168.0.102",
    Port = 5000,
    Check = new AgentServiceCheck
    {
        HTTP = "http://192.168.0.102:5000/health",
        Interval = TimeSpan.FromSeconds(3),  // 每3秒检查一次
        Timeout = TimeSpan.FromSeconds(1),  // 1秒无响应视为失败
        DeregisterCriticalServiceAfter = TimeSpan.FromSeconds(10) // 10秒后自动移除
    }
};
consulClient.Agent.ServiceRegister(registration).Wait();

// 其他中间件
app.UseRouting();
app.MapControllers();

// 配置Swagger（开发环境）
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "ServerAPI1 v1"));
}




// 路由和控制器
app.UseRouting();
app.MapControllers();

// 应用停止时注销服务
app.Lifetime.ApplicationStopping.Register(() =>
{
    consulClient.Agent.ServiceDeregister(registration.ID).Wait();
});

app.Run();

5.2 接口

    using Microsoft.AspNetCore.Mvc;
    using ServerAPI1.Models;

    namespace ServerAPI1.Controllers
    {
        [ApiController]
        [Route("api/[controller]")]
        [Produces("application/json")]
        public class ValuesController : ControllerBase
        {
            /// <summary>
            /// 获取服务基本信息
            /// </summary>
            [HttpGet("info")]
            [ProducesResponseType(200)]
            public IActionResult GetInfo()
            {
                return Ok(new { Service = "ServerAPI1", Port = 5000 });
            }

            /// <summary>
            /// 计算服务 (A+B)
            /// </summary>
            /// <param name="model">输入参数</param>
            [HttpPost("calculate")]
            [ProducesResponseType(200)]
            [ProducesResponseType(400)]
            public IActionResult Calculate([FromBody] TestModel model)
            {
                if (!ModelState.IsValid) return BadRequest(ModelState);
                return Ok(new { Result = 123 + 321, Input = model });
            }

            [HttpGet("getail")] // 实现 /api/values/getail
            public IActionResult Get()
            {
                return Ok("This is /api/values/getail from ServerAPI1");
            }

            [HttpGet("setail")]
            public IActionResult Gett()
            {
                return Ok("This is /api/values/setail from " + GetType().Assembly.GetName().Name);
            }
    }
    }

5.3 数据模型

using System.ComponentModel.DataAnnotations;

namespace ServerAPI1.Models
{
    public class TestModel
    {
        [Required]
        [StringLength(100)]
        public string AAA { get; set; }

        [StringLength(200)]
        public string BBB { get; set; }
    }
}

6.服务2代码

6.1 Program.CS

using Consul;
using Microsoft.OpenApi.Models;

var builder = WebApplication.CreateBuilder(args);

// 添加控制器和Swagger
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "ServerAPI2", Version = "v1" });
});

// 注册Consul客户端
builder.Services.AddSingleton<IConsulClient>(new ConsulClient(c =>
{
    c.Address = new Uri("http://192.168.0.102:8500");
}));

// 配置Kestrel（可选，根据实际需求）
builder.WebHost.UseUrls("http://*:5001");

var app = builder.Build();



// 健康检查端点
//app.MapGet("/health", () => Results.Ok("Healthy"));

// 健康检查端点（模拟5000端口故障）
//app.MapGet("/health", (HttpContext context) =>
//{
//    var port = context.Request.Host.Port;
//    return port == 5000 ? Results.StatusCode(503) : Results.Ok("Healthy (Port: " + port + ")");
//});
//app.MapGet("/health", () => Results.Ok("Healthy (Port: 5001)"));
app.MapGet("/health", () =>
{
    // 基础存活检查（不依赖任何业务逻辑）
    return Results.Ok("Alive");
});


// 注册到Consul
var consulClient = app.Services.GetRequiredService<IConsulClient>();
var registration = new AgentServiceRegistration
{
    ID = "ServerAPI-5001",
    Name = "ServerAPI",
    Address = "192.168.0.102",
    Port = 5001,
    Check = new AgentServiceCheck
    {
        HTTP = "http://192.168.0.102:5001/health",
        Interval = TimeSpan.FromSeconds(3),  // 每3秒检查一次
        Timeout = TimeSpan.FromSeconds(1),  // 1秒无响应视为失败
        DeregisterCriticalServiceAfter = TimeSpan.FromSeconds(10) // 10秒后自动移除
    }
};
consulClient.Agent.ServiceRegister(registration).Wait();
// 其他中间件
app.UseRouting();
app.MapControllers();


// 配置Swagger（开发环境）
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "ServerAPI2 v1"));
}

 健康检查端点
//app.MapGet("/health", () => Results.Ok("Healthy"));

// 路由和控制器
app.UseRouting();
app.MapControllers();

// 应用停止时注销服务
app.Lifetime.ApplicationStopping.Register(() =>
{
    consulClient.Agent.ServiceDeregister(registration.ID).Wait();
});

app.Run();

6.2 接口

using Microsoft.AspNetCore.Mvc;
using ServerAPI2.Models;

namespace ServerAPI2.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    [Produces("application/json")]
    public class ValuesController : ControllerBase
    {
        /// <summary>
        /// 获取服务元数据
        /// </summary>
        [HttpGet("info")]
        [ProducesResponseType(200)]
        public IActionResult GetInfo()
        {
            return Ok(new { Service = "ServerAPI2", Port = 8016 });
        }

        /// <summary>
        /// 字符串转换服务
        /// </summary>
        /// <param name="model">输入参数</param>
        [HttpPost("calculate")]
        [ProducesResponseType(200)]
        [ProducesResponseType(400)]
        public IActionResult Transform([FromBody] TestModel model)
        {
            if (!ModelState.IsValid) return BadRequest(ModelState);
            return Ok(new { Result = $"{model.AAA}-{model.BBB}".ToUpper() });
        }


        [HttpGet("getail")] // 实现 /api/values/getail
        public IActionResult Get()
        {
            return Ok("This is /api/values/getail from ServerAPI2");
        }
        [HttpGet("setail")]
        public IActionResult Gett()
        {
            return Ok("This is /api/values/setail from " + GetType().Assembly.GetName().Name);
        }
    }
}

6.3 数据模型

    using System.ComponentModel.DataAnnotations;

    namespace ServerAPI2.Models
    {
        public class TestModel
        {
            [Required]
            [StringLength(100)]
            public string AAA { get; set; }

            [StringLength(200)]
            public string BBB { get; set; }
        }
    }

7.发布形成Publish文件包

7.发布文件效果

8.运行Consul

8.1 显示双击文件夹内的Consul.exe

8.2 cmd进入Consul文件夹，运行指令：consul agent --config-file=C:\consul\config.json

9.运行服务

8.Publish文件夹内的Server1.exe\Server2.exe\OcelotDemo.exe，运行2个业务服务和网关服务

10.效果

观无
关注
使用Ocelot构建.NET Core微服务架构：集成Consul
UtoBug的博客
09-19 214
在.NET Core中，Ocelot是一个强大的开源库，用于构建和管理微服务架构。通过Ocelot，我们可以轻松地管理微服务的路由和负载均衡，并通过Consul实现服务发现和注册。在这个示例中，我们将创建两个简单的微服务，一个用于身份验证（Authentication Service），另一个用于订单管理（Order Service）。接下来，我们将创建一个网关服务，使用Ocelot来管理微服务的路由和负载均衡。现在，我们需要配置Ocelot以定义微服务的路由和使用Consul进行服务发现。
Asp .Net Core 实现微服务：集成 Ocelot+Consul+Swagger+Cors实现网关、服务注册、服务发现
主宰
01-16 1444
Ocelot是一个开源的ASP.NET Core微服务网关，它提供了API网关所需的所有功能，如路由、认证、限流、监控等。Ocelot是一个简单、灵活且功能强大的API网关，它可以与现有的服务集成，并帮助您保护、监控和扩展您的微服务。路由管理：Ocelot允许您定义路由规则，将请求路由到正确的微服务。认证和授权：Ocelot支持多种认证机制，如JWT、OAuth等，并允许您定义访问控制策略，确保只有授权的用户才能访问特定的API。
什么是微服务架构，.netCore微服务选型
qq_34550459的博客
10-28 2013
什么是微服务？ 单体结构： 缺点： 1）只能采用同一种技术，很难用不同的语言或者语言不同版本开发不同模块； 2）系统耦合性强，一旦其中一个模块有问题，整个系统就瘫痪了；一旦升级其中一个模块，整个系统就停机了； 3）要上线必须一起上线，互相等待，无法快速响应需求； 4）集群只能是复制整个系统，即使只是其中一个模块压力大； 微服务： 不同模块放到不同的进程/服务器上，模块之间通过网络通讯进行协作。 适用于：模块比较多，访问量比较大的互联网类系统，并不是所有项目都适合微服务 优点： 1）可以用不同的语言或者语言不
.NET Core微服务之基于Consul实现服务治理
战族狼魂的博客
07-23 1356
在.NET Core微服务架构中，服务治理是一个关键组成部分，它涉及服务的注册、发现、配置管理、健康检查等。Consul 是一个流行的服务发现和配置管理工具，它提供了服务注册与发现、健康检查、键值存储等功能，非常适合用于微服务架构中的服务治理。
.NET微服务、API 网关Ocelot 与 Consul 服务发现完整实例
qq_16005627的博客
12-07 772
.NET Core 微服务 网关Ocelot 与 Consul 服务发现完整实例
基于Docker+Consul+Ocelot+Nginx搭建微服务架构
sx1368084801的博客
04-21 2860
目标 环境说明 所有环境均为本地虚拟机部署，大家在搭建时，对应的Linux服务器、IP地址及端口号请根据自身情况更改 1 Consul注册中心集群搭建(Linux1) 1.1 拉取镜像 docker pull consul 1.2 配置第一个Consul docker run -d --name consul1 --restart=always \ -e 'CONSUL_LOCAL_CONFIG={"skip_leave_on_interrupt":true}' \ -p 8500:8500 -p 83
Consul+Gateway（Ocelot）详解（asp.netcore 微服务架构）
CrtLife的博客
05-22 6778
Consul 简介 Consul是一个基于CP的轻量级分布式高可用的系统，提供服务发现、健康检查、K-V存储、多数据中心等功能，不需要再依赖其他组件(Zk、Eureka、Etcd等)。 服务发现：Consul可以提供一个服务，比如api或者MySQL之类的，其他客户端可以使用Consul发现一个指定的服务提供者，并通过DNS和HTTP应用程序可以很容易的找到所依赖的服务。 健康检查：Consul客户端提供相应的健康检查接口，Consul服务端通过调用健康检查接口检测客户端是否正常 K-V存储：客户端可以使
.netcore3.1 Ocelot与Consul结合使用
世界既不黑也不白，而是一道精致的灰。
10-28 394
.netcore3.1 Ocelot与Consul结合使用 一、在网关项目中添加配置信息 1.1 添加以下两个配置 //webapi服务的配置 { "downstreampathtemplate": "/api/employmanagement", "downstreamscheme": "http", "UseServiceDiscovery": true, //服务的名称 "ServiceName": "Servicetwo",
基于netcore的微服务——consul（1）
世界既不黑也不白，而是一道精致的灰。
05-17 1001
consul一、创建实例项目二、部署consul三、配置项目1.MsgService配置四、启动项目首先启动consul 一、创建实例项目 1.一个控制台项目 consultest1 2.一个webapi项目 MsgService 二、部署consul 1.下载window版64位 2.安装 3.测试启动，执行命令 //在生产环境下使用 consul agent -dev 4.进入consul界面 http://localhost:8500 三、配置项目 1.MsgService配置 1.在API
Consul+Ocelot+.NetCore Api+IdentityServer 4
12-28
在构建分布式系统时，服务发现和路由是两个关键组件，Consul、Ocelot和IdentityServer 4分别在这两个领域发挥着重要作用。本项目结合了这些技术，为.NET Core API应用提供了一套全面的服务治理解决方案。 Consul是...
【C#】一个基于IdentityServer4和Ocelot的统一验证与授权ASP.NETCore微服务示例程序项目.zip
02-07
【C#】一个基于IdentityServer4和Ocelot的统一验证与授权ASP.NETCore微服务示例程序项目，就是这样一个旨在展示如何使用现代技术栈实现微服务安全的示例。 IdentityServer4是ASP.NET Core的一个开源库，它实现了...
基于腾讯云服务、Ocelot、Consul、.NetCore7.0，实现负载均衡和高可用
最新发布
05-01
基于腾讯云服务、Ocelot、Consul、.NetCore7.0，实现负载均衡和高可用
Consul系列:什么是Consul?
quanzhan_King的博客
05-18 2256
与其他分布式服务注册与发现的方案， consul 的方案更“一站式”，内置了服务注册 与发现框架、分布一致性协议实现、健康检查、Key/Value 存储、多数据中心方案，不再需要依赖其他工具(比如 ZooKeeper 等。这使得一个新的数据中心可以很容易的加入现存的 WAN gossip。当一个 server 收到来自另一个数据中心的请求时，它随即转发给正确数据中心的一个 server。这使得数据中心之间只有一个很低的合，但是由于故障检测，连接缓存和复用，跨数据中心的请求都是相对快速和可靠的。
Consule系列:Consul实现详解
quanzhan_King的博客
05-18 3300
Consul的实现 Consul使用Consensus协议提供一致性(Consistency)——CAP定义的一致性。Consensus协议是基于“Raft:InsearchofanUnderstandableConsensusAlgorithm”实现的。 Raft是基于Paxos的一致性算法。与Paxos相比，Raft被设计为具有更少的状态和更简单，更容易理解的算法。 Raft算法是一种基于日志复制实现数据
Spring Cloud开发实践(五): Consul - 服务注册的另一个选择
IOsetting的专栏
05-17 886
Consul 是微服务网络解决方案之一, 用于管理跨网络和多云环境服务之间的安全网络连接, 提供服务发现, 服务网格, 流量管理和自动更新. 可以单独部署, 也可以分布式部署. Consul 内建安全通信选项, 使用 Go 语言编写, 启动资源消耗小, 脚本化配置, 对容器部署方式更友好
ASP.NET Core 8.0 JWT安全实践：从认证到授权的全链路实现
静心编程，禅意生活。
04-28 753
ASP.NET Core 8.0 现代化身份验证：JWT认证与角色授权步步详解
Redis缓存穿透、缓存击穿与缓存雪崩：如何在.NET Core中解决
net core ，前端 ，python 全栈开发
04-30 1165
缓存穿透是指查询一个在缓存中和数据库中都不存在的数据。由于该数据既不在缓存中，也不在数据库中，因此每次请求都会直接查询数据库，造成不必要的数据库压力。例如，用户请求一个无效的商品ID，但该ID既没有缓存数据也没有数据库记录。每次请求都会访问数据库，导致大量无效的数据库访问。缓存击穿是指某些热门数据缓存失效后，短时间内有大量并发请求访问该数据，导致这些请求直接访问数据库，从而加大数据库的负载。常见的场景是在高并发的环境中，某些热点数据的缓存失效，造成大量请求直接冲击数据库。
C#/.NET/.NET Core技术前沿周刊 | 第 36 期（2025年4.21-4.27）
专注于C#/.NET/.NET Core学习、工作、面试干货和实战教程分享。这里聚焦了大量的C#/.NET/.NET Core优质文章、开源项目、实用工具和学习、工作、面试心得。
04-28 1195
C#/.NET/.NET Core技术前沿周刊，你的每周技术指南针！记录、追踪C#/.NET/.NET Core领域、生态的每周最新、最实用、最有价值的技术文章、社区动态、优质项目和学习资源等。让你时刻站在技术前沿，助力技术成长与视野拓宽。欢迎投稿、推荐或自荐优质文章、项目、学习资源等。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值