Index live · v1.3.0 · JUN 8 2026

Azure Container Apps

A-rank
byMicrosoft

Run containerized services and microservices on Azure Container Apps: KEDA scaling, Dapr, revisions, and ingress. Requires the mcp_microsoftdocs MCP for live docs.

Claude CodeCodexCursorGemini CliGithub CopilotMulti Platform
596stars
Updated 7 days ago
1contributor

Install This Skill

npx skills add MicrosoftDocs/Agent-Skills

SKILL.md

Azure Container Apps Skill

This skill provides expert guidance for Azure Container Apps. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L51Diagnosing and fixing Container Apps issues: image pulls, startup/exit failures, health probes, ports, storage mounts, runtime/OCI errors, debug console use, and Java log-level troubleshooting.
Best PracticesL52-L58Deployment, cold-start, and runtime tuning guidance: blue-green rollouts, reducing scale-out latency, and optimizing Java memory usage in Azure Container Apps.
Decision MakingL59-L79Guidance on choosing Container Apps hosting/compute options, cost models, GPUs, and workload profiles, plus migration paths from Functions, Heroku, Java/Spring/Tomcat, and other Azure container services
Architecture & Design PatternsL80-L86Architectures and patterns for Java microservices on Azure Container Apps, including Eureka HA clusters, AI-enabled PetClinic, and end-to-end microservice design best practices.
Limits & QuotasL87-L94Limits, quotas, and default behaviors for Container Apps (including express preview), plus how to review current limits and request quota increases.
SecurityL95-L133Securing Container Apps: auth (Entra, social, OIDC, mTLS, certs), secrets/managed identity, private endpoints, firewalls/WAF, DNS/ingress controls, and security best practices.
ConfigurationL134-L176Configuring Container Apps runtime: networking/ingress, scaling, revisions/traffic, Dapr, Functions, Java, logging/monitoring, storage mounts, workload profiles, and maintenance.
Integrations & Coding PatternsL177-L199Patterns for connecting Container Apps to each other and to services (Dapr, Spring, Front Door, Service Connector) plus dynamic/shell/code-interpreter sessions and event-driven jobs.
DeploymentL200-L208Deploying and automating Container Apps: CI/CD with GitHub Actions/Azure Pipelines, Docker Compose migration, self-hosted runners, and Arc-enabled Kubernetes integration.

Troubleshooting

TopicURL
Use Container Apps debug console for in-place troubleshootinghttps://learn.microsoft.com/en-us/azure/container-apps/container-debug-console
Use dynamic log levels to troubleshoot Java apps on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-dynamic-log-level
Troubleshoot MCP server issues on Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/mcp-troubleshooting
Diagnose container exit failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-container-create-failures
Troubleshoot container start failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-container-start-failures
Troubleshoot health probe failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-health-probe-failures
Fix container image pull failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-image-pull-failures
Resolve OCI runtime errors in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-open-container-initiative-errors
Fix storage mount failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-storage-mount-failures
Resolve target port misconfiguration in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-target-port-settings
Diagnose and fix Azure Container Apps runtime issueshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshooting

Best Practices

TopicURL
Implement blue-green deployments in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/blue-green-deployment
Apply cold-start reduction best practices in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/cold-start
Optimize Java memory usage in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-memory-fit

Decision Making

TopicURL
Understand billing and cost calculation for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/billing
Choose code-to-cloud deployment options for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/code-to-cloud-options
Select between Azure container hosting optionshttps://learn.microsoft.com/en-us/azure/container-apps/compare-options
Plan and organize Azure Container Apps environmentshttps://learn.microsoft.com/en-us/azure/container-apps/environment
Evaluate legacy Consumption-only Container Apps environmentshttps://learn.microsoft.com/en-us/azure/container-apps/environment-type-consumption-only
Decide when to use serverless GPUs in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/gpu-serverless-overview
Select appropriate GPU type for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/gpu-types
Select Azure hosting service for MCP servershttps://learn.microsoft.com/en-us/azure/container-apps/mcp-choosing-azure-service
Migrate from Functions v1 to v2 on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/migrate-functions
Plan migration from Heroku to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/migrate-heroku-overview
Modernize Java apps to Azure Container Apps with GitHub Copilothttps://learn.microsoft.com/en-us/azure/container-apps/migrate-java-github-copilot-app-modernization
Assess and migrate Spring Boot apps to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/migrate-spring-boot
Plan migration of Spring Cloud apps to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/migrate-spring-cloud
Migrate existing Tomcat applications to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/migrate-tomcat
Compare Azure Container Apps plan typeshttps://learn.microsoft.com/en-us/azure/container-apps/plans
Choose Container Apps compute and billing structureshttps://learn.microsoft.com/en-us/azure/container-apps/structure
Choose appropriate workload profiles for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/workload-profiles-overview

Architecture & Design Patterns

TopicURL
Design a highly available Eureka cluster on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-eureka-server-highly-available
Understand AI-enabled PetClinic architecture on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-petclinic-ai-overview
Design microservices architecture on Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/microservices

Limits & Quotas

TopicURL
Azure Container Apps express preview feature limitshttps://learn.microsoft.com/en-us/azure/container-apps/express-faq
Azure Container Apps platform limits and behaviorshttps://learn.microsoft.com/en-us/azure/container-apps/faq
Request quota increases for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/quota-requests
Review quotas and limits for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/quotas

Security

TopicURL
Use built-in authentication and authorization in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication
Configure Microsoft Entra authentication for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication-entra
Enable Facebook authentication in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication-facebook
Configure GitHub authentication for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication-github
Configure Google authentication for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication-google
Configure custom OpenID Connect auth for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication-openid
Configure X (Twitter) authentication for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/authentication-twitter
Set up client certificate (mTLS) auth for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/client-certificate-authorization
Configure CORS for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/cors
Manage custom domains and TLS certificates in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/custom-domains-certificates
Configure custom domains and managed certificates in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/custom-domains-managed-certificates
Use Dapr APP_API_TOKEN for Container Apps requestshttps://learn.microsoft.com/en-us/azure/container-apps/dapr-authentication-token
Secure Dapr component connections to Azure serviceshttps://learn.microsoft.com/en-us/azure/container-apps/dapr-component-connect-services
Configure custom environment DNS suffix and TLS in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/environment-custom-dns-suffix
Configure NSGs, UDRs, and firewalls for Container Apps VNetshttps://learn.microsoft.com/en-us/azure/container-apps/firewall-integration
Store app-level secrets for Functions on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/functions-secrets-app-level
Configure Functions host key storage on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/functions-secrets-host-keys
Choose and manage secrets for Functions on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/functions-secrets-tutorial
Secure Container Apps with private endpointshttps://learn.microsoft.com/en-us/azure/container-apps/how-to-use-private-endpoint
Configure IP-based ingress restrictions for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/ip-restrictions
Import and manage Container Apps certificates from Key Vaulthttps://learn.microsoft.com/en-us/azure/container-apps/key-vault-certificates-manage
Manage and use secrets in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/manage-secrets
Use managed identities with Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/managed-identity
Configure ACR image pulls via managed identityhttps://learn.microsoft.com/en-us/azure/container-apps/managed-identity-image-pull
Secure MCP servers on Azure Container Apps with Entra IDhttps://learn.microsoft.com/en-us/azure/container-apps/mcp-authentication
Configure mutual TLS for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/mtls
Use built-in Azure Policy definitions for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/policy-reference
Configure private endpoints and DNS for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/private-endpoints-with-dns
Apply security best practices to Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/secure-deployment
Apply security features and practices in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/security
Configure token store-backed auth for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/token-store
Secure PostgreSQL access from Container Apps with managed identityhttps://learn.microsoft.com/en-us/azure/container-apps/tutorial-java-quarkus-connect-managed-identity-postgresql-database
Secure Azure Container Apps egress with Azure Firewallhttps://learn.microsoft.com/en-us/azure/container-apps/use-azure-firewall
Control Container Apps outbound traffic via Azure Firewallhttps://learn.microsoft.com/en-us/azure/container-apps/user-defined-routes
Protect Container Apps with Application Gateway WAFhttps://learn.microsoft.com/en-us/azure/container-apps/waf-app-gateway

Configuration

TopicURL
Set up Azure Monitor alerts for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/alerts
Reference ARM and YAML schema for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/azure-resource-manager-api-spec
Configure custom virtual networks for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/custom-virtual-networks
Configure Dapr component resiliency in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/dapr-component-resiliency
Configure Dapr components in Container Apps environmentshttps://learn.microsoft.com/en-us/azure/container-apps/dapr-components
Scale Dapr apps with KEDA scalers using Bicephttps://learn.microsoft.com/en-us/azure/container-apps/dapr-keda-scaling
Use deployment labels to manage Container Apps revisionshttps://learn.microsoft.com/en-us/azure/container-apps/deployment-labels
Configure Dapr settings on existing Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/enable-dapr
Configure environment variables in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/environment-variables
Map Functions triggers to KEDA scaling in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/functions-keda-mappings
Manage Azure Functions instances in Container Apps via CLIhttps://learn.microsoft.com/en-us/azure/container-apps/functions-manage
Configure startup, liveness, and readiness probes in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/health-probes
Configure environment-level ingress for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/ingress-environment-configuration
Enable and tune app-level ingress in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/ingress-how-to
Configure ingress options for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/ingress-overview
Configure Java APM agent with init containers in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-application-performance-management-config
Configure Java build environment variables in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-build-environment-variables
Access logs for managed Java components in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-component-logs
Enable Java-optimized features in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-feature-switch
Enable and use Java metrics in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-metrics
Monitor Container Apps logs with Log Analytics querieshttps://learn.microsoft.com/en-us/azure/container-apps/log-monitoring
Configure log storage and monitoring options for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/log-options
Configure application logging categories in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/logging
Understand networking model for Container Apps environmentshttps://learn.microsoft.com/en-us/azure/container-apps/networking
Configure OpenTelemetry data agents in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/opentelemetry-agents
Configure planned maintenance windows for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/planned-maintenance
Configure premium ingress for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/premium-ingress
Configure and manage Container Apps revisionshttps://learn.microsoft.com/en-us/azure/container-apps/revisions-manage
Configure rule-based HTTP routing in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/rule-based-routing
Configure custom domains with rule-based routinghttps://learn.microsoft.com/en-us/azure/container-apps/rule-based-routing-custom-domain
Configure autoscaling rules in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/scale-app
Configure service discovery resiliency policieshttps://learn.microsoft.com/en-us/azure/container-apps/service-discovery-resiliency
Enable session affinity (sticky sessions) in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/sticky-sessions
Configure storage mounts for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/storage-mounts
Create Azure Files volume mounts in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/storage-mounts-azure-files
Configure traffic splitting across Container Apps revisionshttps://learn.microsoft.com/en-us/azure/container-apps/traffic-splitting
Configure VNet integration for Azure Container Apps environmentshttps://learn.microsoft.com/en-us/azure/container-apps/vnet-custom
Manage workload profiles via Azure CLIhttps://learn.microsoft.com/en-us/azure/container-apps/workload-profiles-manage-cli
Manage workload profiles in portal for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/workload-profiles-manage-portal

Integrations & Coding Patterns

TopicURL
Implement direct microservice calls in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/communicate-between-microservices
Connect Azure Container Apps using built-in service discoveryhttps://learn.microsoft.com/en-us/azure/container-apps/connect-apps
Create Dapr components for Azure services in portalhttps://learn.microsoft.com/en-us/azure/container-apps/dapr-component-connection
Use Azure Functions Dapr extension in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/dapr-functions-extension
Expose private Azure Container Apps via Front Door Premiumhttps://learn.microsoft.com/en-us/azure/container-apps/front-door-custom-virtual-network-private-link
Integrate Azure Container Apps with Front Door via Private Linkhttps://learn.microsoft.com/en-us/azure/container-apps/how-to-integrate-with-azure-front-door
Connect Container Apps to managed Admin for Springhttps://learn.microsoft.com/en-us/azure/container-apps/java-admin
Integrate Admin for Spring with Eureka on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-admin-eureka-integration
Connect Azure Container Apps to managed Config Server for Springhttps://learn.microsoft.com/en-us/azure/container-apps/java-config-server
Integrate Azure Container Apps with managed Eureka Server for Springhttps://learn.microsoft.com/en-us/azure/container-apps/java-eureka-server
Use managed Gateway for Spring with Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-gateway-for-spring
Connect Container Apps to Azure services with Service Connectorhttps://learn.microsoft.com/en-us/azure/container-apps/service-connector
Integrate AutoGen code interpreter sessions with Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-autogen
Use Azure Container Apps code interpreter sessions with LangChainhttps://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-langchain
Execute JavaScript via Azure Container Apps dynamic sessionshttps://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-nodejs
Use Semantic Kernel code interpreter sessions on Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-semantic-kernel
Run shell commands using Azure Container Apps session poolshttps://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-shell
Use platform-managed MCP with dynamic shell sessions in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-shell-mcp
Run event-driven jobs from Storage queues in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/tutorial-event-driven-jobs

Deployment

TopicURL
Enable Azure Container Apps on Arc-enabled Kubernetes clustershttps://learn.microsoft.com/en-us/azure/container-apps/azure-arc-enable-cluster
Automate Container Apps revisions with Azure Pipelineshttps://learn.microsoft.com/en-us/azure/container-apps/azure-pipelines
Deploy Docker Compose agents to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/compose-agent
Automate Container Apps revisions with GitHub Actionshttps://learn.microsoft.com/en-us/azure/container-apps/github-actions
Generate Container Apps GitHub Actions via Azure CLIhttps://learn.microsoft.com/en-us/azure/container-apps/github-actions-cli
Run self-hosted CI/CD runners with Container Apps jobshttps://learn.microsoft.com/en-us/azure/container-apps/tutorial-ci-cd-runners-jobs
Synced from MicrosoftDocs/Agent-Skills@26944a0fetched May 24, 2026

Quick Stats

Source repo · this path
Stars596
Forks67
Last commit2026-06-02
Contributors1
LicenseCC-BY-4.0
CategoryDevOps
View on GitHub

Author

M

Microsoft

@MicrosoftDocs

Tags

azurecontainerskedadaprmicroservices