代码改变世界,开源推动社区
Adnc是一个轻量级的.Net 5.0微服务开发框架,同时也适用于单体架构系统的开发。支持经典三层与DDD架构开发模式、集成了一系列主流稳定的微服务配套技术栈。一个前后端分离的框架,前端基于Vue、后端基于.Net 5.0构建。Webapi遵循RESTful设计规范、基于JWT认证授权、基于Maxscale实现了读写分离、部署灵活、代码简洁、开箱即用、容器化微服务的最佳实践。
- 用户中心:系统支撑服务,实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理
- 运维中心:系统支撑服务,实现了登录日志、审计日志、异常日志、字典管理、配置参数管理
- 客户中心:经典三层开发模式demo
- 订单中心:DDD开发模式demo
- 仓储中心:DDD开发模式demo
文档
如何快速跑起来
- 详细介绍如何使用docker安装redis、mysql、rabbitmq、mongodb,以及如何在本地配置ClientApp、ServerApi。
请点击链接,查看详细介绍
如何手动部署到服务器
- 详细介绍如何使用docker安装配置consul集群、Skywalking系列组件、相关项目的dockerfile文件编写与配置以及如何将多个服务部署到服务器。
请点击链接,查看详细介绍
如何实现读写分离
- 详细介绍为什么要通过中间件实现读写分离以及EFCore基于中间件如何写代码。
请点击链接,查看详细介绍
如何使用Cache Redis 分布式锁 布隆过滤器
- 详细介绍如何使用Cache、Redis、分布式锁以及布隆过滤器。如何配置Cache防止雪崩、击穿、穿透以及缓存同步。
请点击链接,查看详细介绍
如何动态分配雪花算法的WorkerId
- 详细介绍Yitter雪花算法的特点、配置以及如何动态获取WorkerId。
请点击链接,查看详细介绍
如何使用EFCore仓储
- 详细介绍EFCore仓储基础功能、工作单元、CodeFirst,提供了丰富的演示代码以及演示代码对应的Sql语句。
请点击链接,查看详细介绍
总体结构设计
Jmeter测试
- ECS服务器配置:2核4G,带宽1M。服务器上装了很多东西,剩余大约40%的CPU资源,40%的内存资源。
- 由于带宽有限,吞吐率约200/s左右。
- 模拟并发线程1200/s
- 读写比率7:3
6个测试用例覆盖了网关、服务发现、配置中心、服务间同步调用、数据库CURD、本地事务、分布式事务、缓存、布隆过滤器、SkyApm链路、Nlog日志记录、操作日志记录。
演示
问题交流
- 780634162(QQ群)
GitHub
- https://github.com/alphayu/adnc
- 开源不易,如果您喜欢这个项目, 请给个星星
⭐️ 。
Roadmap
目录结构
- src
- clientApp 前端项目(
Vue
) - serverApi 后端项目(
.NET 5.0
)
- clientApp 前端项目(
- doc 项目相关文档(sql脚本、docker脚本、docker-compose.yaml文件)
- tools 工具软件
- test 测试工程
ClientApp
- clientApp基于Vue-Element-Admin以及Web-Flash搭建,感谢两位作者。
- 前端主要技术栈 Vue + Vue-Router + Vuex + Axios
- 构建步骤
# Install dependencies npm install --registry=https://registry.npm.taobao.org # Serve with hot reload at localhost:5001 npm run dev # Build for production with minification npm run build:prod
- 界面
ServerApi
- ServerApi基于
.NET 5.0
搭建。 - 后端主要技术栈
名称 | 描述 |
---|---|
Ocelot | 基于 .NET 5.0 编写的开源网关 |
Consul | 配置中心、注册中心组件 |
Refit | 一个声明式自动类型安全的RESTful服务调用组件,用于同步调用其他微服务 |
SkyAPM.Agent.AspNetCore | Skywalking .NET 5.0 探针,性能链路监测组件 |
AspNetCore.HealthChecks | 健康监测组件,搭配consul的健康监测 |
Autofac | IOC容器组件 |
Autofac.Extras.DynamicProxy | Autfac AOP扩展 |
Pomelo.EntityFrameworkCore.MySql | EFCore ORM组件 |
Dapper | 轻量级ORM组件 |
Z.EntityFramework.Plus.EFCore | 第三方高性能的EfCore组件 |
NLog | 日志记录组件 |
AutoMapper | 模型映射组件 |
Swashbuckle.AspNetCore | APIs文档生成工具(swagger) |
StackExchange.Redis | 开源的Redis客户端SDK |
CAP | 实现事件总线及最终一致性(分布式事务)的一个开源的组件 |
RabbitMq | 异步消息队列组件 |
Polly | 一个 .NET 弹性和瞬态故障处理库,允许开发人员以 Fluent 和线程安全的方式来实现重试、断路、超时、隔离和回退策略 |
FluentValidation | 一个 .NET 验证框架,支持链式操作,易于理解,功能完善,组件内提供十几种常用验证器,可扩展性好,支持自定义验证器,支持本地化多语言 |
Maxscale | Mariadb开发的一款成熟、高性能、免费开源的数据库中间件 |
后端解决方案
整体架构图
Infrastructures
基础架构相关工程Services
微服务相关工程Tests
框架测试相关工程
Infrastructures 基础架构相关工程
✅ Adnc.Infra.Core
该工程是Adnc所有工程的最顶层,任何工程都会者直接或间接依赖该层。该工程提供了大量的C#
基础类型的扩展方法以及Configuration、DependencyInjection、ContainerBuilder的扩展方法,还定义了一些异常类。
✅ Adnc.Infra.Caching
该工程集成了StackExchange.Redis,提供缓存的管理、Redis常用类型操作、分布式锁、布隆过滤器功能。
✅ Adnc.Infra.Consul
该工程集成了Consul,提供服务的自动注册、发现以及系统配置读写操作。
✅ Adnc.Infra.EfCore.MySQL
该工程负责Adnc.Infra.Repository仓储接口以及IUintofWork接口的EfCore的实现,提供mysql数据库的CURD操作,同时也集成了Dapper部分接口,用来处理复杂查询。
✅ Adnc.Infra.EventBus
该工程简单封装了CAP,同时集成了RabbitMq,封装了发布者与订阅者等公共类,方便更加便捷的调用Rabbitmq。
✅ Adnc.Infra.Gateway
该工程是一个Web项目,基于Ocelot实现的Api网关,如果项目采用整体结构开发,该项目可以直接删除。ocelot网关包含路由、服务聚合、服务发现、认证、鉴权、限流、熔断、缓存、Header头传递等功能。市面上主流网关还有Kong,Traefik,Ambassador,Tyk等。
✅ Adnc.Infra.HealthCheckUI
该工程是一个Web项目, AspNetCore.HealthChecks组件的Dashboard,直接配置需要监测的服务地址就可以了,没有代码,关键的代码参考webapi层的AddHealthChecks()方法。
✅ Adnc.Infra.Helper
该工程提供一些通用帮助类,如IdGeneraterHelper,HashHelper,SecurityHelper等等。
✅ Adnc.Infra.Mongo
该工程负责Adnc.Infra.Repository仓储接口的Mongodb实现,提供mongodb数据库的CURD操作。
✅ Adnc.Infra.Mapper
该工程定义了IObjectMapper接口,并且提供了AutoMapper的实现。
✅ Adnc.Infra.Repository
该工程定义了Entity对象的基类、UnitOfWork接口、仓储接口。
Services 微服务相关工程
该目录都是具体微服务业务的实现。
✅ Shared
微服务公用工程
Adnc.Shared
该层目前有三个目录Consts存放常量定义文件、Events存放事件定义文件、RPCServices存放RPC服务接口声明文件,任何层都可以依赖该层。Adnc.Application.Shared
该层定义了DTO对象的基类、应用服务类基类、缓存相关服务基类以及操作日志拦截器、UnitOfWork拦截器。所有微服务Application/Application.Contracts层的共享层,并且都需要依赖该层。Adnc.WebApi.Shared
该层实现了认证、鉴权、异常捕获、服务组件注册等公共类和中间件。所有微服务WebApi层的共享层,并且都需要依赖该层。
✅ Adnc.Usr
用户中心微服务,系统支撑服务,实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理。
✅ Adnc.Maint
运维中心微服务,系统支撑服务,实现了登录日志、审计日志、异常日志、字典管理、配置参数管理。
✅ Adnc.Cus
客户中心微服务,经典三层开发模式demo。
✅ Adnc.Ord
订单中心微服务,DDD开发模式demo。
✅ Adnc.Whse
仓储中心微服务,DDD开发模式demo。
每个微服务的Migrations层是Efcore用来做数据迁移的,迁移的日志文件存放在各自Migrations目录中。
代码片段
namespace Adnc.Usr.WebApi
{
public class Startup
{
private readonly IHostEnvironment _environment;
private IServiceCollection _services;
public Startup(IHostEnvironment environment)
{
_environment = environment;
}
public void ConfigureServices(IServiceCollection services)
{
_services = services;
services.AddAdncServices<PermissionHandlerLocal>();
}
public void ConfigureContainer(ContainerBuilder builder)
{
builder.RegisterAdncModules(_services);
}
public void Configure(IApplicationBuilder app)
{
app.UseAdncMiddlewares();
if (_environment.IsProduction() || _environment.IsStaging())
{
app.RegisterToConsul();
}
}
}
}
问题交流
- 企 鹅 群:780634162
- 项目官网:https://aspdotnetcore.net
- 博 客:https://www.cnblogs.com/alphayu
- GitHub :https://github.com/alphayu/adnc
贡献者
License
MIT
Free Software, Hell Yeah!