# aspnetrun/run-aspnetcore-microservices

Microservices on .NET platforms used ASP.NET Web API, Docker, RabbitMQ, MassTransit, Grpc, Yarp API Gateway, PostgreSQL, Redis, SQLite, SqlServer, Marten, Entity Framework Core, CQRS, MediatR, DDD, Vertical and Clean Architecture implementation with using latest features of .NET 8 and C# 12

Repository: https://github.com/aspnetrun/run-aspnetcore-microservices
Canonical: https://ross.abutalabs.com/products/run-aspnetcore-microservices
Homepage: https://www.udemy.com/course/microservices-architecture-and-implementation-on-dotnet/?couponCode=MARC26
Language: C#
License: MIT
License Family: permissive
Topics: aspnet-core, docker, ocelot-gateway, micorservices, aspnetcore-microservices, rabbitmq, mongodb, redis, sql-server, cqrs-pattern, clean-architecture, event-sourcing, eventbus, event-driven, microservices-architecture, aspnet-web-api, swagger, rest-api, api-gateway, mediator-pattern
Last push: 2026-03-09T14:56:46+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 71, release rhythm 35, longevity 100
- inputs: {"age_days": 2698, "days_push": 177, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3258, forks 1738 (observed 2026-08-28T04:07:52.452386+00:00)

## What it is
A reference implementation of an e-commerce microservices system built on .NET 8 with ASP.NET Core Web APIs, gRPC, RabbitMQ/MassTransit event-driven communication, and a Yarp API Gateway. It demonstrates DDD, CQRS with MediatR, and Vertical/Clean Architecture patterns across Catalog, Basket, Discount, and Ordering services, and is accompanied by a Udemy course.

## Use cases
- learn microservices architecture with .net
- example of cqrs and mediatr in aspnet core
- how to do grpc communication between microservices
- rabbitmq event-driven microservices example
- clean architecture and vertical slice architecture sample
- yarp api gateway setup example
- reference project for building e-commerce backend services

## When to choose
- you want a real-world, well-documented reference for .NET microservices patterns
- you are learning DDD, CQRS, or Vertical Slice Architecture in ASP.NET Core
- you need examples of gRPC, RabbitMQ, MassTransit, or Yarp integration in .NET

## When to avoid
- you need a production-ready e-commerce platform to deploy as-is
- you are not working in the .NET/C# ecosystem
- you want a minimal starter template rather than an educational sample

## Facets
- artifact type: learning-resource
- maturity: active
- function: microservices, api-framework, rpc, message-queue, caching, api-gateway, orm, web-framework, developer-tools
- domain: microservices, backend, web-development, e-commerce, developer-tools, tutorials
- platform: dotnet, cross-platform
- tags: clean-architecture, cqrs, vertical-slice-architecture, ddd, event-driven-architecture, grpc, masstransit, yarp, marten, mediatr, dotnet-8, sample-project, e-commerce, docker, web-server

## Member repositories
- aspnetrun/run-aspnetcore-microservices (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:52.452386+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:43:52.756334+00:00, confidence not recorded.
  - readme: https://github.com/aspnetrun/run-aspnetcore-microservices (fetched 2026-08-28T04:07:52.452386+00:00, sha b1e02df3bef4)
- Data as of 2026-08-30T08:39:29.467469+00:00.