最实用接地气的 .NET 微服务框架

2024-08-26 18:52
文章标签 服务 框架 实用 net 接地

本文主要是介绍最实用接地气的 .NET 微服务框架,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

前言

项目介绍

快速入门

1、服务注册

2、启动UI

3、服务发现与调用

4、启动服务网关

项目地址

最后

前言

微服务架构已经成为搭建高效、可扩展系统的关键技术之一,然而,现有许多微服务框架往往过于复杂,使得我们普通开发者难以快速上手并体验到微服务带了的便利。为了解决这一问题,于是作者精心打造了一款最接地气的 .NET 微服务框架,帮助我们轻松构建和管理微服务应用。

本框架不仅支持 Consul 服务注册与发现,还自带了一系列高级特性,包括配置中心、链路跟踪(APM)、服务网关等,极大地简化了微服务的开发和运维过程。

此外框架还实现了 Saga 分布式事务、RabbitMQ 事件总线等功能,确保系统能够高效处理复杂的业务逻辑。更重要的是提供了一个人性化的 Dashboard 管理面板,使得监控和管理微服务集群变得方便。

通过本文的介绍大家可以学习到如何快速上手并充分利用这些特性,从而构建出既高效又稳定的微服务应用。

项目介绍

Wing 致力于打造一个功能强大且易于使用的 .NET 微服务框架,支持 .NET 6+ 运行平台。

该框架具备以下特点:

1、服务注册与发现:支持 Consul 服务注册与发现机制,确保服务间的自动发现和动态管理。

2、服务间通讯:支持 HTTP 和 gRPC 两种调用方式,内置负载均衡器,实现高效的服务间通信。

3、服务策略与异常处理:提供服务策略配置,支持服务异常降级处理,确保系统的稳定性和可靠性。

4、Saga 分布式事务:支持三种恢复策略(向前恢复、向后恢复、先前再后),确保事务的一致性和完整性。

5、配置中心:内置配置中心,实现服务配置的在线集中统一管理。

6、链路追踪与性能监控:支持 HTTP/gRPC/SQL 的链路追踪(APM)及耗时分析统计,帮助开发者快速定位性能瓶颈。

7、服务网关:内置服务网关,支持全局服务策略和个性化服务策略配置,简化服务入口管理。

8、事件总线:支持 RabbitMQ 事件总线,实现服务间的异步通信和事件传递。

9、管理界面:提供人性化的 Dashboard 管理界面,便于监控和管理整个微服务集群。

Wing 框架为开发者提供一个强大而直观的开发平台,帮助快速构建和管理高效、可扩展的微服务应用。

快速入门

1、服务注册

什么是服务注册?

服务注册是指服务启动后将该服务的IP、端口等信息注册到Consul

创建一个Web API 项目

提前准备:安装并启动Consul

打开 Visual Studio 2022 并创建Web API项目

安装依赖包

dotnet add package Wing.Consul

Program代码

builder.Services.AddWing();

添加配置

{// 是否启用配置中心,默认启用"ConfigCenterEnabled": false,"Consul": {"Url": "http://localhost:8500","Service": {//Http  Grpc"Option": "Http","HealthCheck": {"Url": "http://localhost:1210/health",//单位:秒"Timeout": 10,//单位:秒"Interval": 10},"Name": "Wing.Demo_1.2.1","Host": "localhost","Port": 1210,"Tag": "","LoadBalancer": {//RoundRobin  WeightRoundRobin LeastConnection"Option": "WeightRoundRobin",//权重"Weight": 60},"Scheme": "http","Developer": "linguicheng"},//定时同步数据时间间隔,单位:秒 小于等于0表示立即响应"Interval": 10,//数据中心"DataCenter": "dc1",//等待时间,单位:分钟"WaitTime": 3}
}

查看运行效果

程序运行后,打开consul UI管理界面,可以看到注册服务Wing.Demo_1.2,具体如下图所示:

2、启动UI

Wing.UIWing微服务框架中的一个可视化操作管理系统,主要功能有服务治理、配置中心、APM管理、Saga分布式事务查询。

安装依赖包

安装服务注册nuget包Wing.Consul,UI可视化界面管理nuget包Wing.UI,选择对应的数据库驱动(参考FreeSql官网),以SqlServer为例,安装FreeSql.Provider.SqlServer

dotnet add package Wing.UI 
dotnet add package FreeSql.Provider.SqlServer

Program代码

using Wing;
var builder = WebApplication.CreateBuilder(args);
builder.Host.AddWing(builder => builder.AddConsul());
builder.Services.AddWing().AddWingUI(FreeSql.DataType.SqlServer);

查看运行效果

程序运行后,浏览器访问 ,运行效果如下图:

可以看到示例 1.2 注入的服务`Wing.Demo_1.2

3、服务发现与调用

什么是服务发现?

服务发现是指服务启动后将服务注册信息定时同步刷新到本地或实时获取Consul的服务信息。

安装依赖

dotnet add package Wing.Consul

Grpc健康检查

protobuf文件

syntax = "proto3";
package grpc.health.v1;
message HealthCheckRequest {string service = 1;
}
message HealthCheckResponse {enum ServingStatus {UNKNOWN = 0;SERVING = 1;NOT_SERVING = 2;}ServingStatus status = 1;
}
service Health {rpc Check(HealthCheckRequest) returns (HealthCheckResponse);rpc Watch(HealthCheckRequest) returns (stream HealthCheckResponse);
}

HealthCheck代码

public class HealthCheck : Health.HealthBase
{public override Task<HealthCheckResponse> Check(HealthCheckRequest request, ServerCallContext context){return Task.FromResult(new HealthCheckResponse() { Status = HealthCheckResponse.Types.ServingStatus.Serving });}public override async Task Watch(HealthCheckRequest request, IServerStreamWriter<HealthCheckResponse> responseStream, ServerCallContext context){await responseStream.WriteAsync(new HealthCheckResponse(){ Status = HealthCheckResponse.Types.ServingStatus.Serving });}
}

Program代

运行效果

运行当前程序并启动示例 1.3,浏览器访问 ,可以看到注入的Grpc服务Wing.Demo_1.4,运行效果如下图:

在示例 1.2 中调用当前Grpc服务中SayHello方法,代码如下:

[HttpGet("hello")]
public Task<string> SayHello()
{return _serviceFactory.InvokeAsync("Wing.Demo_1.4", async serviceAddr =>{var channel = GrpcChannel.ForAddress(serviceAddr.ToString());var greeterClient = new Greeter.GreeterClient(channel);var result = await greeterClient.SayHelloAsync(new HelloRequest { Name = "Wing" });return result.Message;});
}

运行示例 1.2,浏览器访问 http://localhost:1210/weatherforecast/hello ,运行效果如下图:

4、启动服务网关

服务网关是系统对外的唯一入口,它封装了系统内部架构,为每个客户端提供了定制的API,所有的客户端和消费端都通过统一的网关接入微服务,在网关层处理所有非业务功能。

安装依赖包

安装服务注册nuget包Wing.Consul,服务网关nuget包Wing.Gateway,选择对应的数据库驱动(参考FreeSql官网open in new window),以SqlServer为例,安装FreeSql.Provider.SqlServer,请求日志支持本地消息队列和分布式消息队列进行异步持久化,基本上不影响网关性能。如果不想记录请求日志,可以不安装该包。

如果想启用EventBus记录请求日志,需要安装RabbitMQ nuget包Wing.RabbitMQ

dotnet add package Wing.Consul
dotnet add package Wing.Gateway
dotnet add package Wing.RabbitMQ
dotnet add package FreeSql.Provider.SqlServer

Program代码

using Wing;var builder = WebApplication.CreateBuilder(args);builder.Host.AddWing(builder => builder.AddConsul());// Add services to the container.builder.Services.AddControllers();builder.Services.AddWing().AddPersistence(FreeSql.DataType.SqlServer).AddGateWay().AddEventBus();// 如果不想使用EventBus记录请求日志,可以删除此行代码var app = builder.Build();// Configure the HTTP request pipeline.app.UseHttpsRedirection();app.UseAuthorization();app.MapControllers();app.Run();

添加配置

{// 是否启用配置中心,默认启用"ConfigCenterEnabled": false,"Consul": {"Url": "http://localhost:8500","Service": {//Http  Grpc"Option": "Http","HealthCheck": {"Url": "http://localhost:1510/health",//单位:秒"Timeout": 10,//单位:秒"Interval": 10},"Name": "Wing.Demo_1.5","Host": "localhost","Port": 1510,"LoadBalancer": {//RoundRobin  WeightRoundRobin LeastConnection"Option": "WeightRoundRobin",//权重"Weight": 50},"Scheme": "http","Developer": "linguicheng"},//定时同步数据时间间隔,单位:秒 小于等于0表示立即响应"Interval": 10,//数据中心"DataCenter": "dc1",//等待时间,单位:分钟"WaitTime": 3},"ConnectionStrings": {"Wing": "Data Source=192.168.56.96;User Id=sa;Password=wing123.;Initial Catalog=Wing;TrustServerCertificate=true;Pooling=true;Min Pool Size=1"},//自动同步实体结构到数据库"UseAutoSyncStructure": true,// 如果不启用EventBus,可以删除RabbitMQ配置"RabbitMQ": {"HostName": "192.168.56.99","UserName": "admin","Password": "admin","VirtualHost": "/","Port": 5672,//消息过期时间,单位:毫秒,过期会自动路由到死信队列,小于或等于0则永久有效"MessageTTL": 0,"ExchangeName": "Sample.GateWay",//每次投递消息数量"PrefetchCount": 1},"Gateway": {// 请求日志"Log": {// 是否启用网关日志记录"IsEnabled": true,// 是否启用事件总线(RabbitMQ)存储日志,生产环境推荐启用,可以提升程序的性能"UseEventBus": false}}
}

查看运行效果

运行示例 1.2 并启动当前示例程序,浏览器访问,运行效果如下图:

运行示例 1.3,浏览器访问,可以看到网关请求日志,运行效果如下图:

服务地址组成

请求服务地址默认是{网关IP或域名}/{服务名}/{服务路由},

例如:http://localhost:1510/Wing.Demo_1.2/weatherforecast

注意 更多具体内容可以访问Wing 官方文档,具体内容如下所示

项目地址

Github:项目主页 | Wing 官方文档

Gitee:Wing: 最接地气的.NET微服务框架,支持Consul服务注册与发现,自带配置中心、链路跟踪(APM)、服务网关,支持Saga分布式事务、RabbitMQ事件总线,自带人性化的Dashboard管理面板。

文档地址:项目主页 | Wing 官方文档

示例地址:Wing.Demo: Wing微服务框架示例

开源协议:基于MIT协议永久开源免费使用

最后

如果你觉得这篇文章对你有帮助,不妨点个赞支持一下!你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助,欢迎随时留言。也可以加入微信公众号**[DotNet技术匠]** 社区,与其他热爱技术的同行一起交流心得,共同成长!

这篇关于最实用接地气的 .NET 微服务框架的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1109395

相关文章

TP-Link PDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务

《TP-LinkPDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务》近期,路由器制造巨头普联(TP-Link)在用户群体中引发了一系列重要变动,上个月,公司发出了一则通知,明确要求所... 路由器厂商普联(TP-Link)上个月发布公告要求所有用户必须完成实名认证后才能继续使用普联提供的 D

修改若依框架Token的过期时间问题

《修改若依框架Token的过期时间问题》本文介绍了如何修改若依框架中Token的过期时间,通过修改`application.yml`文件中的配置来实现,默认单位为分钟,希望此经验对大家有所帮助,也欢迎... 目录修改若依框架Token的过期时间修改Token的过期时间关闭Token的过期时js间总结修改若依

微服务架构之使用RabbitMQ进行异步处理方式

《微服务架构之使用RabbitMQ进行异步处理方式》本文介绍了RabbitMQ的基本概念、异步调用处理逻辑、RabbitMQ的基本使用方法以及在SpringBoot项目中使用RabbitMQ解决高并发... 目录一.什么是RabbitMQ?二.异步调用处理逻辑:三.RabbitMQ的基本使用1.安装2.架构

Java中使用Java Mail实现邮件服务功能示例

《Java中使用JavaMail实现邮件服务功能示例》:本文主要介绍Java中使用JavaMail实现邮件服务功能的相关资料,文章还提供了一个发送邮件的示例代码,包括创建参数类、邮件类和执行结... 目录前言一、历史背景二编程、pom依赖三、API说明(一)Session (会话)(二)Message编程客

windos server2022的配置故障转移服务的图文教程

《windosserver2022的配置故障转移服务的图文教程》本文主要介绍了windosserver2022的配置故障转移服务的图文教程,以确保服务和应用程序的连续性和可用性,文中通过图文介绍的非... 目录准备环境:步骤故障转移群集是 Windows Server 2022 中提供的一种功能,用于在多个

解决systemctl reload nginx重启Nginx服务报错:Job for nginx.service invalid问题

《解决systemctlreloadnginx重启Nginx服务报错:Jobfornginx.serviceinvalid问题》文章描述了通过`systemctlstatusnginx.se... 目录systemctl reload nginx重启Nginx服务报错:Job for nginx.javas

Debian如何查看系统版本? 7种轻松查看Debian版本信息的实用方法

《Debian如何查看系统版本?7种轻松查看Debian版本信息的实用方法》Debian是一个广泛使用的Linux发行版,用户有时需要查看其版本信息以进行系统管理、故障排除或兼容性检查,在Debia... 作为最受欢迎的 linux 发行版之一,Debian 的版本信息在日常使用和系统维护中起着至关重要的作

MyBatis框架实现一个简单的数据查询操作

《MyBatis框架实现一个简单的数据查询操作》本文介绍了MyBatis框架下进行数据查询操作的详细步骤,括创建实体类、编写SQL标签、配置Mapper、开启驼峰命名映射以及执行SQL语句等,感兴趣的... 基于在前面几章我们已经学习了对MyBATis进行环境配置,并利用SqlSessionFactory核

.NET利用C#字节流动态操作Excel文件

《.NET利用C#字节流动态操作Excel文件》在.NET开发中,通过字节流动态操作Excel文件提供了一种高效且灵活的方式处理数据,本文将演示如何在.NET平台使用C#通过字节流创建,读取,编辑及保... 目录用C#创建并保存Excel工作簿为字节流用C#通过字节流直接读取Excel文件数据用C#通过字节

poj 1258 Agri-Net(最小生成树模板代码)

感觉用这题来当模板更适合。 题意就是给你邻接矩阵求最小生成树啦。~ prim代码:效率很高。172k...0ms。 #include<stdio.h>#include<algorithm>using namespace std;const int MaxN = 101;const int INF = 0x3f3f3f3f;int g[MaxN][MaxN];int n