Deploy microservices with Azure Container Apps

Azure Container Apps
Azure Cosmos DB
Service Bus

This example scenario demonstrates how to deploy microservice containers without needing to manage complex infrastructure and container orchestration.

You can find a code sample in the Container Apps Example Scenario repository.


Diagram showing microservices deployed with Azure Container Apps.

Download a Visio file of this architecture.

In this scenario, the container images are sourced from Azure Container Registry and deployed to a Container Apps environment.

The services sharing the same environment benefit from:

  • Internal ingress and service discovery
  • A single Log Analytics workspace for runtime logging
  • Secure management of secrets and certificates

The workflow service container app is running in single revision mode. A container app running in single revision mode will have a single revision that is backed by zero-many replicas. A replica is composed of the application container and any required sidecar containers. This example isn't making use of sidecar containers, therefore each container app replica represents a single container. Since this example doesn't employ scaling, there will be only one replica running for each container app.

The workflow uses a hybrid approach to managing secrets. Managed identities are used in the services where such implementation required no code changes. The Drone Scheduler and Delivery services use user-assigned managed identities to authenticate with Azure Key Vault to access the secrets stored there. The remaining services store secrets via Container Apps service at the application level.

Diagram showing the runtime architecture for the solution.

This diagram illustrates the runtime architecture for the solution.

Download a Visio file of this architecture.


  1. Ingestion service: Receives client requests, buffers them and sends them via Azure Service Bus to the workflow service.
  2. Workflow service: Consumes messages from Azure Service Bus and dispatches them to underlying services.
  3. Package service: Manages packages.
  4. Drone scheduler service: Schedules drones and monitors drones in flight.
  5. Delivery service: Manages deliveries that are scheduled or in-transit.


The drone delivery service uses a series of Azure services in concert with one another.

Azure Container Apps

Azure Container Apps is the primary component.

Many of the complexities of the previous AKS architecture are replaced by these features:

  • Built-in service discovery
  • Fully managed HTTP and HTTP/2 endpoints
  • Integrated load balancing
  • Logging and monitoring
  • Autoscaling based on HTTP traffic or events powered by KEDA
  • Application upgrades and versioning

External storage and other components

Azure Key Vault service for securely storing and accessing secrets, such as API keys, passwords, and certificates.

Azure Container Registry stores private container images. You can also use other container registries like Docker Hub.

Azure Cosmos DB stores data using the open-source Azure Cosmos DB for MongoDB. Microservices are typically stateless and write their state to external data stores. Azure Cosmos DB is a NoSQL database with open-source APIs for MongoDB and Cassandra.

Azure Service Bus offers reliable cloud messaging as a service and simple hybrid integration. Service Bus supports asynchronous messaging patterns that are common with microservices applications.

Azure Cache for Redis adds a caching layer to the application architecture to improve speed and performance for heavy traffic loads.

Azure Monitor collects and stores metrics and logs at the application level. Use this data to monitor the application, set up alerts and dashboards, and do root cause analysis of failures. This scenario uses a Log Analytics workspace for comprehensive monitoring of the application.

Application Insights provides extensible application performance management (APM) and monitoring for the services. Each service is instrumented with the Application Insights SDK to monitor the app and direct the data to Azure Monitor.

Azure Resource Manager (ARM) Templates to configure and deploy the applications.


An alternative scenario of this example is the Fabrikam Drone Delivery application using Kubernetes, which is available on GitHub in the Azure Kubernetes Service (AKS) Fabrikam Drone Delivery repository.

Scenario details

Your business can simplify the deployment and management of microservice containers by using Azure Container Apps. Container Apps provides a fully managed serverless environment for building and deploying modern applications.

Fabrikam, Inc. (a fictional company) has implemented a drone delivery service where users can request a drone to pick up goods for delivery. When a customer schedules a pickup, a backend system assigns a drone and notifies the user with an estimated delivery time. When a customer schedules a pickup, a backend system assigns a drone and notifies the user with an estimated delivery time. The application is composed of containerized microservices and was originally deployed to Azure Kubernetes Service.

This solution is ideal for the aircraft and aerospace industries.

With Azure Container Apps, Fabrikam can run their containerized applications on a flexible, serverless platform purpose-built to support microservices. Azure Container Apps runs on Azure Kubernetes Service, and includes several open-source projects: Kubernetes Event Driven Autoscaling (KEDA), Distributed Application Runtime (Dapr), and Envoy. This open-source foundation enables teams to build and run portable applications powered by Kubernetes and open standards. With these built-in platform capabilities, teams can avoid the management complexity of working with the Kubernetes platform and APIs directly.

Because the Fabrikam team wasn't making use of many of advanced AKS configuration settings, they were able to migrate their application to Azure Container Apps without much overhead. By porting their solution to Azure Container Apps, Fabrikam took advantage of:

  • Migrating the application as-is: No code changes were required when moving their application from AKS to Azure Container Apps.
  • Deploying with Bicep templates: No Kubernetes YAML manifests were needed to deploy their application containers.
  • Exposing apps through managed ingress: Built-in support for external, https-based ingress to expose the Ingestion Service removed the need for configuring their own ingress.
  • Pulling container images from ACR: Azure Container Apps doesn't require a specific base image or registry.
  • Managing application lifecycle: The revision feature supports running multiple revisions of a particular container app and traffic-splitting across them for A/B testing or Blue/Green deployment scenarios.
  • Using managed identity: The Fabrikam team was able to use a managed identity to authenticate with Azure Key Vault.

You can find a code sample in the Container Apps Example Scenario repository.

Potential use cases

This drone delivery solution applies to the aerospace, aircraft, and robotics industries. In this example solution, the use cases are:

  • Deploy a brownfield microservice-based application into a platform as a service (PaaS) offering to avoid the operational complexity of managing a container orchestrator.
  • Optimize operations and management by migrating containerized services to a platform that supports native scale-to-zero.
    • Execute a long-running background process, such as the workflow service in single revision mode.

Other common uses of Container Apps include:

  • Running containerized workloads on a serverless, consumption-based platform.
  • Autoscaling applications based on HTTP/HTTPS traffic and/or Event-driven triggers supported by KEDA
  • Minimizing maintenance overhead for containerized applications
  • Deploying API endpoints
  • Hosting background processing applications
  • Handling event-driven processing


These considerations implement the pillars of the Azure Well-Architected Framework, which is a set of guiding tenets that can be used to improve the quality of a workload. For more information, see Microsoft Azure Well-Architected Framework.


Container Apps allows you to more easily deploy, manage, maintain and monitor the applications. Availability can be ensured by these key features:

  • Revisions help you deploy application updates with zero downtime. You can use revisions to manage the deployment of application updates and split traffic between the revisions to support blue/green deployments and A/B testing (not currently used in this example workload).
  • With Container Apps end-to-end observability features, you have a holistic view of your running applications. Container Apps is integrated with Azure Monitor and Log Analytics, which allows you to track container app execution, and set alerts based on metrics and events.
  • When an app unexpectedly terminates, the Container Apps service automatically restarts it.
  • You can enable autoscaling rules to meet demand as traffic and workloads increase.
  • Performance is optimized by the dynamic load balancing features of Container Apps (not currently used in this example workload).

Operational excellence

Operational excellence covers the operations processes that deploy an application and keep it running in production. For more information, see Overview of the operational excellence pillar.

To achieve operational excellence, the Container Apps service offers these features:

  • GitHub Actions integration for setting up automated CI/CD deployments.
  • Multi-revision mode with traffic splitting for testing changes to your application code and scale rules.
  • Integration with Azure Monitor and Log Analytics to provide insight into your containerized application.

Performance efficiency

Performance efficiency is the ability of your workload to scale to meet the demands placed on it by users in an efficient manner. For more information, see Performance efficiency pillar overview.

Performance considerations in this solution:

  • The workload is distributed among multiple microservice applications.
  • Each microservice is independent, sharing nothing with the other microservices, so that they can independently scale.
  • Autoscaling can be enabled as the workload increases.
  • Requests are dynamically load balanced.
  • Metrics, including CPU and memory utilization, bandwidth information and storage utilization, are available through Azure Monitor.
  • Log analytics provides log aggregation to gather information across each Container Apps environment.


Reliability ensures your application can meet the commitments you make to your customers. For more information, see Overview of the reliability pillar.

Container Apps will attempt to restart failing containers and abstracts away hardware from users. Transient failures and high-availability of backing compute resources are handled by Microsoft.

Performance monitoring through Log Analytics and Azure Monitor allows you to evaluate the application under load. Metrics and logging information give you the data needed to recognize trends to prevent failures and perform root-cause analysis of failures when they occur.


Security provides assurances against deliberate attacks and the abuse of your valuable data and systems. For more information, see Overview of the security pillar.

  • Secrets: Your Container Apps can store and retrieve sensitive values as secrets. Once a secret is defined for a Container App, it's available for use by the application and any associated scale rules. If you're running in multi-revision mode, all revisions will share the same secrets. Because secrets are considered an application-scope change, if you change the value of a secret, no new revision is created. However, for any running revisions to load the new secret value, you'll need to restart them. In this scenario, application and environment variable values are used.

  • Environment variables: sensitive values can be securely stored at the application level. When environment variables are changed, the container app will spawn a new revision.

  • Network security: Backend services in the drone delivery app aren't exposed via external ingress. All requests are passed from the Ingestion service through the Azure Service Bus.

  • Container Apps supports Azure Active Directory (AD) managed identities allowing your app to easily authenticate other Azure AD-protected resources such as Azure Key Vault, without managing credentials in your container app. For services that don't support AD authentication, you can store secrets in Azure Key Vault and use a managed identity to access Key Vault to access the secrets.

Cost optimization

  • Azure Container Apps has consumption based pricing model.
  • Azure Container Apps supports scale to zero. When a container app is scaled to zero, there's no charge.
  • In this scenario, the Azure Cosmos DB and Azure Cache for Redis services generate most of the costs.
  • To avoid accruing charges, don't leave this example running.

Deploy this scenario

Follow the steps in the in the sample repository to deploy this scenario.


This article is maintained by Microsoft. It was originally written by the following contributors.

Principal author:

Next steps