Skip to content

Reference

Quick lookup documentation for Azure Container Apps operations and diagnostics.

How to use this section

This section is optimized for fast operational lookup during build, deploy, and incident response workflows. Start from the overview table, then jump directly to the command set, variable reference, or quota boundary you need.

Use this as your runbook landing page

Keep this page open during deployment and troubleshooting sessions. The linked reference pages are designed to reduce context switching when you need exact command syntax, variable meaning, or limit checks.

Bookmark for production operations

Save this page and the linked reference pages in your browser. During incidents, a predictable navigation path is more valuable than searching through full tutorial content.

flowchart LR
    A[Reference Index] --> B[CLI Reference]
    A --> C[Environment Variables]
    A --> D[Platform Limits]
    B --> E[Deploy / Update / Observe]
    C --> F[Runtime Configuration Validation]
    D --> G[Capacity and Quota Planning]

Reference coverage map

Reference Area Primary Use Case Typical User Best Time to Use Key Output
CLI Reference Execute repeatable app, revision, ingress, identity, and job operations Platform engineer, SRE, developer Deployment, rollback, diagnostics Correct az containerapp command with long flags
Environment Variables Validate runtime injection and app config behavior Application developer, SRE Startup validation, config debugging Confirmed variable names, defaults, and examples
Platform Limits Check design boundaries and quota-sensitive architecture decisions Architect, platform owner, SRE Load planning, scaling strategy, pre-production review Limit/constraint table for design and operations

Quick navigation by task

If you need to... Go to Why
Create or update an app quickly CLI Reference Includes common lifecycle commands and PII-scrubbed output
Inspect revision and replica health state CLI Reference Dedicated revision/replica command groups
Verify the correct runtime port variable Environment Variables Shows CONTAINER_APP_PORT and related injected variables
Align autoscale assumptions with known boundaries Platform Limits Centralized scale-related constraints and notes
Check networking and ingress constraints Platform Limits Clarifies ingress/port and network boundary expectations
Validate job runtime metadata variables Environment Variables Includes job-specific variable names

Main Content

Documents

Document Description
CLI Reference Common az containerapp commands for app lifecycle, configuration, deployment, and scaling
Environment Variables Platform-injected variables and recommended app/runtime variables
Platform Limits Platform quotas, request/timeout constraints, storage behavior, and scale boundaries
URL Purpose
https://${APP_NAME}.${ENVIRONMENT_DEFAULT_DOMAIN} Application endpoint (external ingress)
${APP_NAME}.internal.${ENVIRONMENT_DEFAULT_DOMAIN} Internal endpoint (internal ingress)
Azure Portal → Container App → Log stream Real-time container logs
Azure Portal → Container App → Console Interactive container shell

Common Variables

Variable Description Example
$RG Resource group name rg-myapp
$APP_NAME Container App name ca-myapp
$ENVIRONMENT_NAME Container Apps Environment name cae-myapp
$ENVIRONMENT_DEFAULT_DOMAIN Environment's default domain suffix <hash>.<region>.azurecontainerapps.io
$ACR_NAME Azure Container Registry name acrmyapp
$LOCATION Azure region koreacentral 
az containerapp env show --name "$ENVIRONMENT_NAME" --resource-group "$RG" --query "properties.defaultDomain" --output tsv

Fast verification checklist

Use this checklist before production deploys or incident handoff:

  1. Confirm command syntax and long flags in CLI Reference.
  2. Validate expected runtime variables in Environment Variables.
  3. Check quota and scaling boundaries in Platform Limits.
  4. Record environment domain and ingress endpoint for test execution.

Advanced Topics

  • Standardize your team runbooks to link to these three reference documents directly.
  • Include reference links in incident templates and deployment pipelines.
  • Re-verify command output formats after Azure CLI extension upgrades.

Language-Specific Details

For runtime-specific guidance, see: - Python Guide

See Also

Sources