Skip to content

Commit d549c56

Browse files
mehmetozkayamehmetozkaya
authored
Update README.md
1 parent d61ee0f commit d549c56

File tree

1 file changed

+81
-48
lines changed

1 file changed

+81
-48
lines changed

‎README.md

Lines changed: 81 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -3,61 +3,80 @@
33

44
**UDEMY COURSE WITH DISCOUNTED - Step by Step Development of this repository -> https://www.udemy.com/course/microservices-architecture-and-implementation-on-dotnet/?couponCode=C624710F8B411FE7A4FB**
55

6-
For those who comes from udemy, the course repository moved here ->
6+
**NOTE :** For those who comes from udemy, I have just updated the repository so udemy course will be updated soon. Since that time the course repository moved here ->
77
https://github.com/mehmetozkaya/MicroservicesApp
88

99
See the overall picture of **implementations on microservices with .net tools** on real-world **e-commerce microservices** project;
1010

1111
![aspnetrun-microservices](https://user-images.githubusercontent.com/1147445/79753821-34b93800-831f-11ea-86fc-617654557084.png)
1212

13-
There is a couple of microservices which implemented **e-commerce** modules over **Product, Basket** and **Ordering** microservices with **NoSQL (MongoDB, Redis)** and **Relational databases (Sql Server)** with communicating over **RabbitMQ Event Driven Communication** and using **Ocelot API Gateway**.
13+
There is a couple of microservices which implemented **e-commerce** modules over **Product, Basket, Discount** and **Ordering** microservices with **NoSQL (MongoDB, Redis)** and **Relational databases (PostgreSQL, Sql Server)** with communicating over **RabbitMQ Event Driven Communication** and using **Ocelot API Gateway**.
1414

1515
## Whats Including In This Repository
1616
We have implemented below **features over the run-aspnetcore-microservices repository**.
1717

1818
#### Catalog microservice which includes;
1919
* ASP.NET Core Web API application
20-
* REST API principles, CRUD operations
21-
* **Mongo DB NoSQL database** connection on docker
22-
* N-Layer implementation with Repository Pattern
23-
* Swagger Open API implementation
24-
* Dockerfile implementation
20+
* REST API principles, CRUD operations
21+
* **MongoDB database** connection and containerization
22+
* Repository Pattern Implementation
23+
* Swagger Open API implementation
2524

2625
#### Basket microservice which includes;
27-
* ASP.NET Core Web API application
28-
* REST API principles, CRUD operations
29-
* **Redis** connection as a Database on docker
30-
* Redis connection implementation
31-
* **RabbitMQ trigger event queue** when checkout cart
32-
* Swagger Open API implementation
33-
* Dockerfile implementation
34-
35-
#### RabbitMQ messaging library which includes;
36-
* Base **EventBus implementation** and add references Microservices
37-
38-
#### Ordering microservice which includes; (over the catalog specs)
39-
* ASP.NET Core Web API application
40-
* **Entity Framework Core on SQL Server** docker
41-
* REST API principles, CRUD operations
42-
* **Consuming RabbitMQ** messages
43-
* **Clean Architecture** implementation with CQRS Design Pattern
44-
* Event Sourcing
45-
* Implementation of MediatR, Autofac, FluentValidator, AutoMapper
46-
* Swagger Open API implementation
47-
* Dockerfile implementation
48-
49-
#### API Gateway Ocelot microservice which includes;
50-
* **Routing** to inside microservices
51-
* Dockerization api-gateway
52-
53-
#### WebUI ShoppingApp microservice which includes;
54-
* Asp.net Core Web Application with Razor template
55-
* Call **Ocelot APIs** with **HttpClientFactory**
56-
* Aspnet core razor tools - View Components, partial Views, Tag Helpers, Model Bindings and Validations, Razor Sections etc..
26+
* ASP.NET Web API application
27+
* REST API principles, CRUD operations
28+
* **Redis database** connection and containerization
29+
* Consume Discount **Grpc Service** for inter-service sync communication to calculate product final price
30+
* Publish BasketCheckout Queue with using **MassTransit and RabbitMQ**
31+
32+
#### Discount microservice which includes;
33+
* ASP.NET **Grpc Server** application
34+
* Build a Highly Performant **inter-service gRPC Communication** with Basket Microservice
35+
* Exposing Grpc Services with creating **Protobuf messages**
36+
* Using **Dapper for micro-orm implementation** to simplify data access and ensure high performance
37+
* **PostgreSQL database** connection and containerization
38+
39+
#### Microservices Communication
40+
* Sync inter-service **gRPC Communication**
41+
* Async Microservices Communication with **RabbitMQ Message-Broker Service**
42+
* Using **RabbitMQ Publish/Subscribe Topic** Exchange Model
43+
* Using **MassTransit** for abstraction over RabbitMQ Message-Broker system
44+
* Publishing BasketCheckout event queue from Basket microservices and Subscribing this event from Ordering microservices
45+
* Create **RabbitMQ EventBus.Messages library** and add references Microservices
46+
47+
#### Ordering Microservice
48+
* Implementing **DDD, CQRS, and Clean Architecture** with using Best Practices
49+
* Developing **CQRS with using MediatR, FluentValidation and AutoMapper packages**
50+
* Consuming **RabbitMQ** BasketCheckout event queue with using **MassTransit-RabbitMQ** Configuration
51+
* **SqlServer database** connection and containerization
52+
* Using **Entity Framework Core ORM** and auto migrate to SqlServer when application startup
53+
54+
#### API Gateway Ocelot Microservice
55+
* Implement **API Gateways with Ocelot**
56+
* Sample microservices/containers to reroute through the API Gateways
57+
* Run multiple different **API Gateway/BFF** container types
58+
* The Gateway aggregation pattern in Shopping.Aggregator
59+
60+
#### WebUI ShoppingApp Microservice
61+
* ASP.NET Core Web Application with Bootstrap 4 and Razor template
62+
* Call **Ocelot APIs with HttpClientFactory** and **Polly**
63+
64+
#### Microservices Cross-Cutting Implementations
65+
* Implementing **Centralized Distributed Logging with Elastic Stack (ELK); Elasticsearch, Logstash, Kibana and SeriLog** for Microservices
66+
* Use the **HealthChecks** feature in back-end ASP.NET microservices
67+
* Using **Watchdog** in separate service that can watch health and load across services, and report health about the microservices by querying with the HealthChecks
68+
69+
#### Microservices Resilience Implementations
70+
* Making Microservices more **resilient Use IHttpClientFactory** to implement resilient HTTP requests
71+
* Implement **Retry and Circuit Breaker patterns** with exponential backoff with IHttpClientFactory and **Polly policies**
72+
73+
#### Ancillary Containers
74+
* Use **Portainer** for Container lightweight management UI which allows you to easily manage your different Docker environments
75+
* **pgAdmin PostgreSQL Tools** feature rich Open Source administration and development platform for PostgreSQL
5776

5877
#### Docker Compose establishment with all microservices on docker;
59-
* Dockerization of microservices
60-
* **Dockerization** of database
78+
* Containerization of microservices
79+
* Containerization of databases
6180
* Override Environment variables
6281

6382
**Quick DEMO on Youtube -> https://www.youtube.com/watch?v=p6lVqDNUYaY**
@@ -68,30 +87,44 @@ We have implemented below **features over the run-aspnetcore-microservices repos
6887
You will need the following tools:
6988

7089
* [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/)
71-
* [.Net Core 3.1 or later](https://dotnet.microsoft.com/download/dotnet-core/3.1)
90+
* [.Net Core 5 or later](https://dotnet.microsoft.com/download/dotnet-core/5)
7291
* [Docker Desktop](https://www.docker.com/products/docker-desktop)
7392

7493
### Installing
7594
Follow these steps to get your development environment set up: (Before Run Start the Docker Desktop)
7695
1. Clone the repository
77-
2. At the root directory which include **docker-compose.yml** files, run below command:
96+
2. Once Docker for Windows is installed, go to the **Settings > Advanced option**, from the Docker icon in the system tray, to configure the minimum amount of memory and CPU like so:
97+
* **Memory: 4 GB**
98+
* CPU: 2
99+
3. At the root directory which include **docker-compose.yml** files, run below command:
78100
```csharp
79101
docker-compose -f docker-compose.yml -f docker-compose.override.yml up –d
80102
```
81103
3. Wait for docker compose all microservices. That’s it! (some microservices need extra time to work so please wait if not worked in first shut)
82104

83105
4. You can **launch microservices** as below urls:
84-
* **RabbitMQ -> http://localhost:15672/**
85-
* **Catalog API -> http://localhost:8000/swagger/index.html**
86-
* **Basket API -> http://localhost:8001/swagger/index.html**
87-
* **Order API -> http://localhost:8002/swagger/index.html**
88-
* **API Gateway -> http://localhost:7000/Order?username=swn**
89-
* **Web UI -> http://localhost:8003/**
90106

91-
5. Launch http://localhost:8003/ in your browser to view the Web UI. You can use Web project in order to **call microservices over API Gateway**. When you **checkout the basket** you can follow **queue record on RabbitMQ dashboard**.
107+
* **Catalog API -> http://host.docker.internal:8000/swagger/index.html**
108+
* **Basket API -> http://host.docker.internal:8001/swagger/index.html**
109+
* **Discount API -> http://host.docker.internal:8002/swagger/index.html**
110+
* **Ordering API -> http://host.docker.internal:8004/swagger/index.html**
111+
* **Shopping.Aggregator -> http://host.docker.internal:8005/swagger/index.html**
112+
* **API Gateway -> http://host.docker.internal:8010/Catalog**
113+
* **Rabbit Management Dashboard -> http://host.docker.internal:15672** -- guest/guest
114+
* **Portainer -> http://host.docker.internal:9000** -- admin/admin1234
115+
* **Elasticsearch -> http://host.docker.internal:9200**
116+
* **Kibana -> http://host.docker.internal:5601**
117+
118+
* **Web Status -> http://host.docker.internal:8007**
119+
* **Web UI -> http://host.docker.internal:8006**
120+
121+
5. Launch http://host.docker.internal:8007 in your browser to view the Web Status. Make sure that every microservices are healthy.
122+
6. Launch http://host.docker.internal:8006 in your browser to view the Web UI. You can use Web project in order to **call microservices over API Gateway**. When you **checkout the basket** you can follow **queue record on RabbitMQ dashboard**.
92123

93124
![mainscreen2](https://user-images.githubusercontent.com/1147445/81381837-08226000-9116-11ea-9489-82645b8dbfc4.png)
94125

126+
>Note: If you are running this application in macOS then use `docker.for.mac.localhost` as DNS name in `.env` file and the above URLs instead of `host.docker.internal`.
127+
95128
## The Book - Microservices Architecture and Step by Step Implementation on .NET
96129

97130
You can find **Microservices Architecture and Step by Step Implementation on .NET book** which **step by step developing** this repository with extensive explanations and details. This book is the **best path to leverage your .NET skills** in every aspect from beginner to senior level you can benefit to ramp-up faster on **Enterprise Application Development practices** and easy to **Onboarding to Full Stack .Net Core Developer jobs**.

0 commit comments

Comments
 (0)