Microservices Architecture eBook changelog

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

Release 6.0 (2021-12-15)

Reference commits : ad8ac33, cacaa85, 76c6a99, 8983735, a4ffedb, ee647de, a1bf7f9, 6e9af17, d49d0f6, ef7254b, 8accd57, 2976835

Contains changes in the following pages :

• toc.yml
• Index
• In module container-docker-introduction
  • Docker terminology
• In module net-core-net-framework-containers
  • Choosing Between .NET 6 and .NET Framework for Docker Containers
  • General guidance
  • When to choose .NET for Docker containers
  • Developing and deploying cross platform
  • Using containers for new ("green-field") projects
  • Create and deploy microservices on containers
  • Deploying high density in scalable systems
  • Decision table. .NET frameworks to use for Docker
  • What OS to target with .NET containers
  • Migrating existing applications directly to a Windows Server container
  • Official .NET Docker images
• In module architect-microservice-container-applications
  • Publishing a single-container-based application to Azure App Service
  • Microservices addressability and the service registry
  • Software platforms for container clustering, orchestration, and scheduling
• In module docker-application-development-process
  • Index
  • .NET languages and frameworks for Docker containers
  • Development workflow for Docker apps
  • Workflow for developing Docker container-based applications
  • Set up your local environment with Visual Studio
  • Working with docker-compose.yml in Visual Studio 2022
  • Testing and debugging containers with Visual Studio 2022
  • Additional resources
• In module multi-container-microservice-net-applications
  • Defining your multi-container application with docker-compose.yml
  • Building optimized ASP.NET Core Docker images
• In module implement-resilient-applications
  • Reference the .NET 6 packages
  • Use the HealthChecks feature in your back-end ASP.NET microservices
  • HealthChecks implementation in eShopOnContainers

Release 5.0.1 (2020-07-08)

Reference commits : 2005c49,5e40fc1, 1e2cfb2,4c7afea,e55bc52,a2105ae,f96cab7,732a6d3

Contains changes in the following pages :

• Updates Jitter strategy retry policy.
• Updates code snippet of the CardType Enumeration class.
• Fixes broken link.
• Fixes typo.
• Updates eShop WebSPA specific images and url updates.
• Adds new ValueObject reference link.

Contributions :

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

@brokenthorn, @Bindsi, @vkhorikov

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