.NET on Azure Container Apps¶

This guide provides a comprehensive reference implementation for running .NET applications on Azure Container Apps (ACA). We use a production-ready ASP.NET Core application to demonstrate best practices for cloud-native deployment, security, and observability on the Azure platform.

Reference Application¶

The reference .NET application is located in the apps/dotnet-aspnetcore/ directory. It is a production-hardened ASP.NET Core implementation designed to showcase modern cloud-native patterns.

Key features demonstrated in the reference app:

• Health Probes: Implements /health and /info endpoints to enable platform-managed lifecycle and zero-downtime deployments using ASP.NET Core middleware.
• Structured Logging: Native .NET logging configured for seamless integration with Azure Log Analytics and Application Insights.
• OpenTelemetry: Native support for distributed tracing and performance monitoring through the Azure.Monitor.OpenTelemetry.AspNetCore SDK.
• Multi-stage Dockerfile: Optimized build process using Alpine-based images for smaller attack surface and faster deployment.
• KEDA-compatible: Stateless architecture designed for event-driven autoscaling without internal state dependencies.
• Dapr-ready: Prepared for service invocation, state management, and pub/sub patterns using the Dapr sidecar model.

Prerequisites¶

Before you begin the tutorial, ensure you have the following tools and resources available:

• .NET 8.0 SDK or higher: Required for local development, testing, and dependency management.
• Docker Engine: Essential for building, testing, and validating container images locally before cloud deployment.
• Azure CLI 2.57+: The primary tool for provisioning and managing Azure Container Apps and related infrastructure.
• Azure Subscription: An active subscription with sufficient permissions to create Resource Groups and Container Apps environments.

Tutorial Steps¶

Follow these step-by-step guides to master the deployment of .NET applications on Azure Container Apps:

1. Local Development — Learn how to containerize and run your ASP.NET Core app in Docker on your local machine.
2. First Deployment — Push your container image to Azure Container Registry and create your first Container App.
3. Configuration & Secrets — Securely manage environment variables and integrate with Azure Key Vault.
4. Logging & Monitoring — Configure structured logging and visualize metrics in the Azure Portal.
5. Infrastructure as Code — Define and deploy your application environment using Bicep templates.
6. CI/CD with GitHub Actions — Build automated pipelines to test and deploy your code on every commit.
7. Revisions & Traffic — Master advanced deployment strategies like blue-green and canary releases.

.NET Guide Progress Snapshot¶

End-to-End Learning Flow¶

flowchart LR
    A[Local Docker Validation] --> B[Azure First Deployment]
    B --> C[Configuration and Secrets]
    C --> D[Logs, Metrics, Traces]
    D --> E[Bicep-Driven Infrastructure]
    E --> F[GitHub Actions CI/CD]
    F --> G[Revisions and Traffic Splits]
    G --> H[Runtime Tuning and Recipes]

Runtime Guide¶

For detailed technical information on how the .NET runtime is configured and optimized for Azure Container Apps, see the .NET Runtime Reference.

This guide covers: - ASP.NET Core Kestrel configuration and tuning. - System-level and application-specific environment variable overrides. - NuGet package management and Docker layer optimization strategies.

Recipes¶

Accelerate your development process with these common integration patterns and production recipes. See the Recipes Index for the full catalog.

• Azure Cosmos DB — Securely connect to NoSQL databases using Managed Identity.
• Azure SQL — Relational database integration with passwordless authentication.
• Redis Cache — High-performance distributed caching and session state management.
• Blob Storage — Cloud file storage and persistent volume mounts for containers.
• Dapr Integration — Building distributed microservices using the Dapr framework.
• Custom Domains — Mapping your own branded URLs and SSL certificates to your apps.
• Container Registry — Private image hosting and security scanning with ACR.

What You'll Learn¶

By completing this guide, you will gain the following capabilities:

• Building production-grade Docker images optimized for the .NET ecosystem.
• Implementing "Zero-Trust" security by using Managed Identity instead of connection strings.
• Designing for high availability with liveness and readiness probes.
• Troubleshooting distributed systems using platform-native logs and KQL queries.
• Managing the full application lifecycle through infrastructure-as-code and automated CI/CD.

See Also¶

• Platform Architecture — Understand the underlying ACA infrastructure.
• Operations Guide — Production operations.
• Troubleshooting Methodology — Systematic approach to debugging issues.
• CLI Reference — Quick lookup for CLI commands and limits.

Sources¶

• Azure Container Apps documentation (Microsoft Learn)
• .NET on Azure Container Apps overview (Microsoft Learn)