Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudnative-netcore/netcorekit
:heartpulse: A crafted toolkit for building cloud-native apps on the .NET platform
https://github.com/cloudnative-netcore/netcorekit
12-factor aspnetcore clean-architecture cloud-native ddd ddd-architecture docker dotnet-core efcore feature-flags generic-repository grpc kubernetes mediatr microservices-architecture open-api
Last synced: 9 days ago
JSON representation
:heartpulse: A crafted toolkit for building cloud-native apps on the .NET platform
- Host: GitHub
- URL: https://github.com/cloudnative-netcore/netcorekit
- Owner: cloudnative-netcore
- License: mit
- Created: 2018-08-11T07:24:00.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T00:59:32.000Z (over 1 year ago)
- Last Synced: 2024-05-29T21:31:54.558Z (5 months ago)
- Topics: 12-factor, aspnetcore, clean-architecture, cloud-native, ddd, ddd-architecture, docker, dotnet-core, efcore, feature-flags, generic-repository, grpc, kubernetes, mediatr, microservices-architecture, open-api
- Language: C#
- Homepage: https://vietnam-devs.github.io/
- Size: 5.11 MB
- Stars: 288
- Watchers: 24
- Forks: 70
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Cloud-native .NET Core Kit
[](https://ci.appveyor.com/api/project/thangchung/netcore-kit)
[](https://github.com/cloudnative-netcore/netcorekit/blob/master/LICENSE)
[](https://www.nuget.org/packages?q=NetCoreKit)
A set of cloud-native tools and utilities for .NET Core.
The goal of this project is implement the most common used cloud-native technologies (cloud-agnostic approach, containerization mechanism, container orchestration and so on) and share with the technical community the best way to develop great applications with .NET Core.
## Give a Star! :star:
If you liked `netcorekit` project or if it helped you, please give a star :star: for this repository. That will not only help strengthen our .NET community but also improve cloud-native apps development skills for .NET developers in around the world. Thank you very much :+1:
Check out my [blog](https://medium.com/@thangchung) or say hi on [Twitter](https://twitter.com/thangchung)!
### Features
- [x] Simple libraries. No frameworks. Little abstraction.
- [x] Opt-in and out of the box [features](https://github.com/cloudnative-netcore/netcorekit/wiki/Host-template-guidance) with [Feature Toggles](https://martinfowler.com/articles/feature-toggles.html) technique.
- [x] Adhere to [twelve-factor app paradigm](https://12factor.net) and more.
- [x] Authentication/Authorization with OAuth 2.0 and OpenID Connect.
- [x] [Domain-driven Design](https://en.wikipedia.org/wiki/Domain-driven_design) in mind.
- [x] Simply [Clean Architecture](http://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html) supports.
- [x] Generic repository for data persistence.
- [x] Mapping between domain entity to DTO and vice versa.
- [x] Clean and demystify error, debug logs.
- [x] Resilience and health check out of the box.
- [x] MessagePack for WebAPI and gRPC for internal services.
- [x] Easy for configuration management.
- [x] API versioning from Docker container to WebAPI.
- [x] Documentation template with OpenAPI documentation.
- [x] Work natively with Kubernetes or even with Service Mesh(Istio).
## Less code to get starting
Small, lightweight, cloud-native out of the box, and much more simple to get starting with miniservices approach. [Why miniservices?](https://thenewstack.io/miniservices-a-realistic-alternative-to-microservices)
### Look how simple we can start as below:
- **Standard template - NetCoreKit.Template.Standard**: without storage, merely calculation and job tasks:
```csharp
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddStandardTemplate();
}
public void Configure(IApplicationBuilder app)
{
app.UseStandardTemplate();
}
}
```
- **EfCore template - NetCoreKit.Template.EfCore**: with Entity Framework Core (SQL Server, MySQL, and SQLite providers) comes along with the generic repository in place:
```csharp
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddEfCoreTemplate(svc => svc.AddEfCoreMySqlDb());
}
public void Configure(IApplicationBuilder app)
{
app.UseEfCoreTemplate();
}
}
```
> EfCore template usage can be found at [TodoApi Sample](https://github.com/cloudnative-netcore/netcorekit/tree/master/samples/TodoApi).
- **MongoDb template - NetCoreKit.Template.MongoDb**: with NoSQL (MongoDb provider) comes along with the generic repository in place:
```csharp
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddMongoTemplate();
}
public void Configure(IApplicationBuilder app)
{
app.UseMongoTemplate();
}
}
```
> MongoDb template usage can be found at [BiMonetaryApi Sample](https://github.com/cloudnative-netcore/netcorekit/tree/master/samples/BiMonetaryApi).
- Read [Get starting](https://github.com/cloudnative-netcore/netcorekit/wiki/Get-Started) section and [Play with Kubernetes](https://github.com/cloudnative-netcore/netcorekit/wiki/Deploy-on-k8s-on-local) section to know more about this cloud-native toolkit.
- More advance usage is at [Coolstore Microservices](https://github.com/vietnam-devs/coolstore-microservices) project.
### Microservice architecture
### Contributing
1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request :p