Edition 0 Updated to asp. Net core 0

Designing and Developing Multi-Container and Microservice-Based .NET Applications
 ................................................................................................................................................. 93
 
Design a microservice-oriented application .............................................................................................................. 93
 
Application specifications ............................................................................................................................................. 93
 
Development team context ......................................................................................................................................... 94
 
Choosing an architecture .............................................................................................................................................. 94
 
Benefits of a microservice-based solution ............................................................................................................. 97
 
Downsides of a microservice-based solution ....................................................................................................... 98
 
External versus internal architecture and design patterns............................................................................... 99
 
The new world: multiple architectural patterns and polyglot microservices .......................................... 100
 
Creating a simple data-driven CRUD microservice ............................................................................................... 102
 
Designing a simple CRUD microservice ................................................................................................................ 102
 
Implementing a simple CRUD microservice with ASP.NET Core ................................................................. 103
 
The DB connection string and environment variables used by Docker containers ............................. 109
 
Generating Swagger description metadata from your ASP.NET Core Web API ................................... 111
 
Defining your multi-container application with docker-compose.yml ......................................................... 116
 
Use a database server running as a container ........................................................................................................ 127
 
SQL Server running as a container with a microservice-related database .............................................. 128
 
Seeding with test data on Web application startup ......................................................................................... 129
 
EF Core InMemory database versus SQL Server running as a container ................................................. 132
 
Using a Redis cache service running in a container ......................................................................................... 132
 
Implementing event-based communication between microservices (integration events) ................... 133
 
Using message brokers and services buses for production systems ........................................................ 134
 
Integration events .......................................................................................................................................................... 135
 
The event bus .................................................................................................................................................................. 136
 
Additional resources ..................................................................................................................................................... 138
 
Implementing an event bus with RabbitMQ for the development or test environment ....................... 138
 
Implementing a simple publish method with RabbitMQ ............................................................................... 139
 
Implementing the subscription code with the RabbitMQ API ..................................................................... 140
 
Additional resources ..................................................................................................................................................... 141
 

---

v 
Contents
Subscribing to events ........................................................................................................................................................ 141
 
Publishing events through the event bus............................................................................................................. 142
 
Idempotency in update message events .............................................................................................................. 149
 
Deduplicating integration event messages ......................................................................................................... 150
 
Testing ASP.NET Core services and web apps ........................................................................................................ 152
 
Testing in eShopOnContainers ................................................................................................................................. 155
 
Implement background tasks in microservices with IHostedService and the BackgroundService class
 .................................................................................................................................................................................................... 157
 
Registering hosted services in your WebHost or Host ................................................................................... 159
 
The IHostedService interface ..................................................................................................................................... 159
 
Implementing IHostedService with a custom hosted service class deriving from the 
BackgroundService base class................................................................................................................................... 160
 
Additional resources ..................................................................................................................................................... 163
 
Implement API Gateways with Ocelot ........................................................................................................................ 163
 
Architect and design your API Gateways .............................................................................................................. 163
 
Implementing your API Gateways with Ocelot .................................................................................................. 168
 
Using Kubernetes Ingress plus Ocelot API Gateways ...................................................................................... 180
 
Additional cross-cutting features in an Ocelot API Gateway ....................................................................... 181