代码改变世界,开源推动社区
概述
ADNC是什么?
ADNC
是一个基于 .NET
平台的分布式/微服务开源框架,采用现代化的架构设计和最佳实践,同时也适用于单体架构系统的开发。它提供了一系列的工具和库,帮助开发人员快速构建和部署微服务应用程序,包括服务注册/发现、配置中心、链路跟踪、负载均衡、熔断、容错、分布式事务、分布式缓存、消息队列、RPC
调用(http
/grpc
)、认证授权、读写分离、日志记录等,同时也提供了完善的文档和示例代码,方便开发人员使用和学习。如果您正在考虑使用分布式/微服务或单体架构开发应用程序,ADNC
框架是一个值得尝试的开源框架。
微服务是一种分布式架构模式,通过将应用程序拆分成一组小型、松耦合的服务,可以提高应用程序的可伸缩性、可靠性和灵活性。
ADNC有什么优点?
- 灵活性:框架采用现代化的架构设计,支持经典三层和
DDD
架构开发模式。 - 易用性:框架提供了完善的文档和示例代码,同时也集成了一系列主流的微服务技术栈,使用起来比较容易上手。
- 高可靠性:框架采用容器化部署、负载均衡、服务发现等技术,可以提高应用程序的可靠性和可伸缩性。
- 开放性:框架是一个开源项目,采用
MIT
许可证发布,用户可以自由地使用、修改和分享该框架的源代码。 - 生态圈:框架的社区生态圈正在逐渐壮大,有越来越多的开发人员在使用和贡献该框架,用户可以从社区中获取到更多的资源和支持。
架构设计
目录结构
adnc
├── .github
│ └── workflows CICD脚本目录(github-action)
├── doc 技术文档目录
├── src 源代码目录
│ ├── ServerApi 后端代码目录
│ │ ├── Infrastructures 基础架构层代码目录
│ │ ├── ServiceShared 服务通用层代码目录
│ │ ├── Gateways ocelot网关代码目录
│ │ └── Demo 示例代码目录
│ └── ClientApp 前端代码目录
├── test 测试相关目录
├── .gitignore
├── README.MD
└── LICENSE
重要文件
路径 | 描述 |
---|---|
src/ServerApi/Adnc.sln |
该解决方案包含adnc 所有工程 |
src/ServerApi/Infrastructures/Adnc.Infra.sln |
该解决方案仅包含基础架构层相关工程 |
src/ServerApi/ServiceShared/Adnc.Shared.sln |
该解决方案仅包含服务通用层相关工程 |
src/ServerApi/Demo/Adnc.Demo.sln |
该解决方案仅包含demo 相关工程 |
scr/ServerApi/common.props |
工程文件*.csproj 公用配置 |
scr/ServerApi/version_infra.props |
基础架构层版本号 |
scr/ServerApi/version_shared.props |
服务通用层版本号 |
scr/ServerApi/nuget.props |
Nuget 发布信息配置 |
总体架构图
Adnc.Infra.*
NuGet Gallery | Packages matching adnc.infra
Adnc.Shared.*
NuGet Gallery | Packages matching adnc.shared
解决方案截图
技术栈
名称 | 描述 |
---|---|
Ocelot | 基于 `.NET6 编写的开源网关 |
Consul | 配置中心、注册中心组件 |
Refit | 一个声明式自动类型安全的RESTful服务调用组件,用于同步调用其他微服务 |
Grpc.Net.ClientFactory Grpc.Tools |
Grpc通讯框架 |
SkyAPM.Agent.AspNetCore | Skywalking `.NET6探针,性能链路监测组件 |
Castle DynamicProxy | 动态代理,AOP开源实现组件 |
Pomelo.EntityFrameworkCore.MySql | EFCore ORM组件 |
Dapper | 轻量级ORM组件 |
Z.EntityFramework.Plus.EFCore | 第三方高性能的EfCore组件 |
NLog Nlog.Mongdb Nlog.Loki |
日志记录组件 |
AutoMapper | 模型映射组件 |
Swashbuckle.AspNetCore | APIs文档生成工具(swagger) |
StackExchange.Redis | 开源的Redis客户端SDK |
CAP | 实现事件总线及最终一致性(分布式事务)的一个开源的组件 |
RabbitMq | 异步消息队列组件 |
Polly | 一个 .NET 弹性和瞬态故障处理库,允许开发人员以 Fluent 和线程安全的方式来实现重试、断路、超时、隔离和回退策略 |
FluentValidation | 一个 .NET 验证框架,支持链式操作,易于理解,功能完善,组件内提供十几种常用验证器,可扩展性好,支持自定义验证器,支持本地化多语言 |
Maxscale | Mariadb开发的一款成熟、高性能、免费开源的数据库中间件 |
AspNetCore.HealthChecks | 健康监测组件,搭配consul的健康监测 |
文档
如何快速跑起来
- 详细介绍如何使用docker安装redis、mysql、rabbitmq、mongodb,以及如何在本地配置ClientApp、ServerApi。
请点击链接,查看详细介绍
如何手动部署到容器
- 详细介绍如何使用docker安装配置consul集群、Skywalking系列组件、相关项目的dockerfile文件编写与配置以及如何将多个服务部署到服务器。
请点击链接,查看详细介绍
如何使用jenkins+shell脚本自动化部署
- 文档尚未完成
如何部署到K8S
- 文档尚未完成
如何实现读写分离
- 详细介绍为什么要通过中间件实现读写分离以及EFCore基于中间件如何写代码。
请点击链接,查看详细介绍
如何使用Cache Redis 分布式锁 布隆过滤器
- 详细介绍如何使用Cache、Redis、分布式锁以及布隆过滤器。如何配置Cache防止雪崩、击穿、穿透以及缓存同步。
请点击链接,查看详细介绍
如何动态分配雪花算法的WorkerId
- 详细介绍Yitter雪花算法的特点、配置以及如何动态获取WorkerId。
请点击链接,查看详细介绍
如何认证与授权
- 详细介绍为什么要采用JwtBearer+Basic混合认证模式以及它们的实现逻辑,如何灵活配置与应用。
请点击链接,查看详细介绍
如何使用EFCore仓储
- 详细介绍EFCore仓储基础功能、工作单元、CodeFirst,执行原生SQL等提供了丰富的演示代码以及演示代码对应的Sql语句。
如何从零开发业务
- 文档尚未完成
如何调用微服务
- 文档尚未完成
如何配置网关
- 文档尚未完成
如何使用注册/配置中心
- 文档尚未完成
如何配置链路追踪
- 文档尚未完成
如何配置健康检测
- 文档尚未完成
Demo介绍
✅ Shared
Demo公用工程
-
protos
grpc定义文件 -
resources
公用的静态文件与配置文件 -
Adnc.Demo.Shared.Const
常量文件 -
Adnc.Demo.Shared.Rpc.Event
事件文件 -
Adnc.Demo.Shared.Rpc.Grpc
gprc客户端 -
Adnc.Demo.Shared.Rpc.Http
http客户端
✅ Adnc.Demo.Usr
经典三层开发模式,剥离了应用服务协议定义文件到
Adnc.Demo.Usr.Application.Contracts
层
用户中心服务是系统支撑服务,实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理。
✅ Adnc.Demo.Maint
经典三层开发模式,应用服务实现与协议定义都在
Adnc.Demo.Maint.Application
层
运维中心服务是系统支撑服务,实现了登录日志、审计日志、异常日志、字典管理、配置参数管理。
✅ Adnc.Demo.Cus
经典三层开发模式,控制器、应用服务实现与协议定义、仓储都在同一个工程,这种结构适合细粒度服务拆分模式。
客户中心微服务。
✅ Adnc.Demo.Ord
DDD开发模式
订单中心微服务。
✅ Adnc.Demo.Whse
DDD开发模式
仓储中心微服务。
Jmeter测试
6个测试用例覆盖了网关、服务发现、配置中心、服务间同步调用、数据库CURD、本地事务、分布式事务、缓存、布隆过滤器、SkyApm链路、Nlog日志记录、操作日志记录。
- ECS服务器配置:4核8G,带宽8M。服务器上装了很多东西,剩余大约50%的CPU资源,50%的内存资源。
- 因为服务器带宽限制,吞吐率约1000/s左右。
- 模拟并发线程1200/s
- 读写比率7:3
前端
项目地址
界面截图
其他
项目官网
演示地址
问题交流
-
QQ群号:780634162
-
都看到这里了,那就点个
star
吧!
License
MIT
Free Software, Hell Yeah!