Microservices Architecture eBook changelog

eBook - .NET Microservices: Architecture for Containerized .NET Applications

Release 5.0 (2020-01-28)

Reference commits : 53c20f1, 7018099

Contains changes in the following pages :

• toc.yml
• Index
• In module container-docker-introduction
  • Introduction to Containers and Docker
  • Docker terminology
  • Docker containers, images, and registries
• In module net-core-net-framework-containers
  • Choosing Between .NET 5 and .NET Framework for Docker Containers
  • General guidance
  • When to choose .NET 5 for Docker containers
  • Decision table. .NET frameworks to use for Docker
  • What OS to target with .NET containers
  • Official .NET Docker images
• In module architect-microservice-container-applications
  • Index
  • Architecting container and microservice-based applications
  • The API gateway pattern versus the direct client-to-microservice communication
  • Creating, evolving, and versioning microservice APIs and contracts
  • Microservices addressability and the service registry
  • Creating composite UI based on microservices
  • Resiliency and high availability in microservices
  • Orchestrate microservices and multi-container applications for high scalability and availability
• In module docker-application-development-process
  • Index
  • docker-app-development-workflow
• In module multi-container-microservice-net-applications
  • Designing a microservice-oriented application
  • Creating a simple data-driven CRUD microservice
  • Defining your multi-container application with docker-compose.yml
  • Use a database server running as a container
  • Implementing event-based communication between microservices (integration events)
  • Implementing an event bus with RabbitMQ for the development or test environment
  • Subscribing to events
  • Testing ASP.NET Core services and web apps
  • Implement background tasks in microservices with IHostedService and the BackgroundService class
• In module microservice-ddd-cqrs-patterns
  • apply-simplified-microservice-cqrs-ddd-patterns
  • Applying CQRS and CQS approaches in a DDD microservice in eShopOnContainers
  • Implementing reads/queries in a CQRS microservice
  • Designing a DDD-oriented microservice
• In module implement-resilient-applications
  • Implement HTTP call retries with exponential backoff with Polly
  • Health monitoring
  • Use IHttpClientFactory to implement resilient HTTP requests
• In module secure-net-microservices-web-applications
  • Securing .NET Microservices and Web Applications
  • .NET Microservices. Architecture for Containerized .NET Applications

Release 3.1.3 (2020-11-10)

Reference commits : 182fe95, a3789be, 153df0e, a7dfe75, 9eb4479, 1d89b18, 5f89393, b77b615, 7fb1d2a, 500c1d9, c81b647, 6d4ae6b, 26ac253, cc64143, 74844f0, 47c1701, d686801

• Fixes typo in the following pages :

  • Containerizing monolithic applications
  • Development workflow for Docker apps
  • Implementing event-based communication between microservices (integration events)
  • Implementing reads/queries in a CQRS microservice
  • Implementing API Gateways with Ocelot
  • Creating a simple data-driven CRUD microservice
  • Implementing a microservice domain model with .NET Core
  • Domain events. design and implementation
  • Using NoSQL databases as a persistence infrastructure
  • Handling partial failure
  • Testing ASP.NET Core services and web apps
  • Securing .NET Microservices and Web Applications

• Fixes the code block annotation in the following pages :

  • Development workflow for Docker apps
  • Use a database server running as a container
  • Defining your multi-container application with docker-compose.yml
  • Implementing API Gateways with Ocelot
  • Defining your multi-container application with docker-compose.yml

• Fixes broken link in the following pages :

  • Asynchronous message-based communication
  • Development workflow for Docker apps
  • Using Azure Key Vault to protect secrets at production time
  • Use IHttpClientFactory to implement resilient HTTP requests
  • Testing ASP.NET Core services and web apps

• Changes docs prefix (https://docs.microsoft.com) in the following pages :

  • Asynchronous message-based communication
  • Communication in a microservice architecture
  • The API gateway pattern versus the direct client-to-microservice communication
  • Challenges and solutions for distributed data management
  • State and data in Docker applications
  • Resiliency and high availability in microservices
  • Orchestrate microservices and multi-container applications for high scalability and availability
  • Development workflow for Docker apps
  • Use IHttpClientFactory to implement resilient HTTP requests
  • Domain events. design and implementation
  • Implementing value objects
  • Implementing the infrastructure persistence layer with Entity Framework Core
  • Designing the microservice application layer and Web API
  • Implementing a microservice domain model with .NET Core
  • Using NoSQL databases as a persistence infrastructure
  • Creating a simple data-driven CRUD microservice
  • Implementing event-based communication between microservices (integration events)
  • Designing a microservice-oriented application

Contributions :

We’d like to acknowledge and thank the following community members for their valuable contributions !

@zakaria-c, @nschonni , @DCtheGeek, @Youssef1313

Release 3.1.2 (2020-09-02)

Reference commits : 6317237, add8374, 05f6d3f, 540ff78, 0e1e2bb, b0f28cb, ce794ce, 09db01f

• Updates MediatR related content. Page : Implement the microservice application layer using the Web API
• Adds the right DbContext object and rephrases sentences to make it more meaningful. Page: Creating a simple data-driven CRUD microservice
• Refactors ValueObject's Equals() method. Page : Implement value objects
• Rephrases few sentences for a better understanding of the context. Page : Use IHttpClientFactory to implement resilient HTTP requests
• Inclusion of Ocelot v16.0.0 related breaking change note in the important section. Page : Implement API Gateways with Ocelot
• Updates Ocelot API Gatway image. Page : Implement API Gateways with Ocelot
• Fixes the following issues :
  • Typo in the configuration code snippet. Page: Make secure .NET Microservices and Web Applications
  • Additional closing curly brace in the code snippet. Page: Health monitoring
  • Additional resource links. Page : Testing ASP.NET Core services and web apps
  • Broken additional resource links. Page : Testing ASP.NET Core services and web apps
  • Repetitive definition of IHostedService interface. Page: Creating a simple data-driven CRUD microservice
  • Obsolete SQL server image name in docker-compose.yml. Page: Development workflow for Docker apps