Language Guides: Step-by-Step Implementation¶

Language Guides provide a tailored experience for developers working with specific runtimes on Azure Container Apps. Each guide is a complete learning path from local development to production operations.

Purpose¶

These guides are designed to help you build applications that are "platform-native." Instead of just showing how to "deploy an app," they explain how to implement patterns that make your application resilient, observable, and easy to manage.

Available Language Guides¶

• Python (Flask): Flask with Gunicorn, health endpoints, structured logging, and integration recipes.
• Node.js (Express): Express with structured logging, health endpoints, and Node.js-specific patterns.
• Java (Spring Boot): Spring Boot with Actuator, Logback JSON logging, and JVM optimization.
• .NET (ASP.NET Core): ASP.NET Core with health checks middleware, JSON logging, and Kestrel configuration.

Language Support Matrix¶

Tutorial Progression Model¶

flowchart LR
    A[01 Local Development] --> B[02 First Deploy]
    B --> C[03 Configuration and Secrets]
    C --> D[04 Logging and Monitoring]
    D --> E[05 Infrastructure as Code]
    E --> F[06 CI/CD]
    F --> G[07 Revisions and Traffic]
    G --> H[Recipes and Runtime Tuning]

What Each Language Guide Includes¶

Every language-specific path is structured the same way:

1. Tutorial Steps: A numbered sequence from 01-local-development to 07-revisions-traffic.
2. Runtime Guide: Details on specific runtime settings (e.g., Gunicorn workers, Node.js heap size, JVM tuning, Kestrel limits).
3. Recipes: "Copy-pasteable" patterns for connecting to Cosmos DB, Redis, Key Vault, and more.

Common Patterns Across All Languages¶

While the implementation details vary, every application in this guide follows these core patterns:

• Health Endpoints: Exposing /health for liveness and readiness probes.
• Structured Logging: Writing logs in JSON format for Azure Log Analytics.
• Managed Identity: Authenticating to Azure services without passwords or connection strings.
• Revision-Safe Behavior: Handling SIGTERM for graceful shutdown.
• Port Binding: Listening on port 8000 (configurable via environment variable).

How to Choose Your Starting Path¶

Reference Applications¶

Each language guide has a corresponding reference application in the apps/ directory:

See Also¶

• Python Guide
• Node.js Guide
• Java Guide
• .NET Guide
• Start Here - Learning Paths
• Platform - Architecture

Sources¶

• Azure Container Apps documentation (Microsoft Learn)
• Python on Azure Container Apps (Microsoft Learn)
• Dapr documentation
• KEDA documentation