azure-container-apps
Expert knowledge for Azure Container Apps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Dapr, KEDA scaling, Java microservices, GPUs, or
By microsoftdocs · 978 installs
npx skills add microsoftdocs/agent-skills --skill azure-container-apps
Source repository · Upstream listing
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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)
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
Category Lines Description
Troubleshooting L37 L52 Diagnosing and fixing common Container Apps issues: deploy/start/exit failures, health probes, image pulls, storage mounts, ports, OCI runtime errors, and using debug console/log tuning.
Best Practices L53 L59 Deployment, cold start, and runtime tuning guidance: blue green rollouts, reducing scale out latency, and optimizing Java memory usage in Azure Container Apps.
Decision Making L60 L81 Guides for choosing Container Apps hosting, compute, GPUs, and billing models, plus migration and modernization paths from Functions, Heroku, Java/Spring/Tomcat, and organizing environments.
Architecture & Design Patterns L82 L87 Architectures 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 & Quotas L88 L94 Quotas, limits, and scaling caps for Container Apps, plus how they behave at those limits and how to request quota increases from Azure support.
Security L95 L134 Securing Container Apps: auth (Entra, social, OIDC, mTLS), identities & secrets, certs/domains, network controls (VNet, NSG, firewall, WAF), Dapr security, sandbox/RBAC, and best practices.
Configuration L135 L171 Configuring Container Apps environments, networking, ingress, revisions, scaling (KEDA/Dapr/Functions), workload profiles, storage mounts, Java features, and ARM/YAML schemas.
Integrations & Coding Patterns L172 L196 Patterns for connecting Container Apps to each other and Azure services, integrating Dapr/Spring/OpenTelemetry, and using code interpreter and dynamic session features.
Deployment L197 L206 Deploying and automating Container Apps: CI/CD with GitHub Actions/Azure Pipelines, Docker Compose deployments, Arc enabled Kubernetes, logging migration, and self hosted runners/jobs.
Troubleshooting
Topic URL
Use Container Apps debug console for in place troubleshooting https://learn.microsoft.com/en us/azure/container apps/container debug console
Use dynamic log levels to troubleshoot Java apps on Container Apps https://learn.microsoft.com/en us/azure/container apps/java dynamic log level
Troubleshoot MCP server issues on Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/mcp troubleshooting
Diagnose container exit failures in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot container create failures
Troubleshoot container start failures in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot container start failures
Troubleshoot Azure Container Apps deployment failures https://learn.microsoft.com/en us/azure/container apps/troubleshoot deployment errors
Troubleshoot health probe failures in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot health probe failures
Diagnose and fix image pull failures in Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot image pull failures
Resolve OCI runtime errors in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot open container initiative errors
Fix storage mount failures in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot storage mount failures
Resolve target port misconfiguration in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot target port settings
Diagnose and fix issues in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshooting
Best Practices
Topic URL
Implement blue green deployments in Container Apps https://learn.microsoft.com/en us/azure/container apps/blue green deployment
Apply cold start reduction best practices in Container Apps https://learn.microsoft.com/en us/azure/container apps/cold start
Optimize Java memory usage in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/java memory fit
Decision Making
Topic URL
Understand billing and cost calculation for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/billing
Select code to cloud deployment options for Container Apps https://learn.microsoft.com/en us/azure/container apps/code to cloud options
Select between Azure container hosting options https://learn.microsoft.com/en us/azure/container apps/compare options
Plan and organize Azure Container Apps environments https://learn.microsoft.com/en us/azure/container apps/environment
Evaluate legacy Consumption only Container Apps environments https://learn.microsoft.com/en us/azure/container apps/environment type consumption only
Decide when to use serverless GPUs in Container Apps https://learn.microsoft.com/en us/azure/container apps/gpu serverless overview
Select appropriate GPU type for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/gpu types
Select Azure hosting service for MCP servers https://learn.microsoft.com/en us/azure/container apps/mcp choosing azure service
Migrate from Functions v1 to v2 on Container Apps https://learn.microsoft.com/en us/azure/container apps/migrate functions
Plan migration from Heroku to Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/migrate heroku overview
Modernize Java apps to Azure Container Apps with GitHub Copilot https://learn.microsoft.com/en us/azure/container apps/migrate java github copilot app modernization
Assess and migrate Spring Boot apps to Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/migrate spring boot
Plan migration of Spring Cloud apps to Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/migrate spring cloud
Migrate existing Tomcat applications to Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/migrate tomcat
Compare Azure Container Apps plan types https://learn.microsoft.com/en us/azure/container apps/plans
Choose autosuspend vs snapshots for sandbox state https://learn.microsoft.com/en us/azure/container apps/sandboxes snapshots state management
Choose Container Apps compute and billing structures https://learn.microsoft.com/en us/azure/container apps/structure
Choose and configure Azure Container Apps workload profiles https://learn.microsoft.com/en us/azure/container apps/workload profiles overview
Architecture & Design Patterns
Topic URL
Design a highly available Eureka cluster on Container Apps https://learn.microsoft.com/en us/azure/container apps/java eureka server highly available
Design microservices architecture on Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/microservices
Limits & Quotas
Topic URL
Azure Container Apps limits and behavioral FAQs https://learn.microsoft.com/en us/azure/container apps/faq
Request quota increases for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/quota requests
Review quotas and limits for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/quotas
Security
Topic URL
Use built in authentication and authorization in Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication
Configure Microsoft Entra authentication for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication entra
Enable Facebook authentication in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication facebook
Configure GitHub authentication for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication github
Configure Google authentication for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication google
Configure custom OpenID Connect auth for Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication openid
Configure X (Twitter) authentication for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/authentication twitter
Set up client certificate (mTLS) auth for Container Apps https://learn.microsoft.com/en us/azure/container apps/client certificate authorization
Configure CORS for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/cors
Manage custom domains and TLS certificates in Container Apps https://learn.microsoft.com/en us/azure/container apps/custom domains certificates
Configure custom domains and managed certificates in Container Apps https://learn.microsoft.com/en us/azure/container apps/custom domains managed certificates
Use Dapr APP API TOKEN for Container Apps requests https://learn.microsoft.com/en us/azure/container apps/dapr authentication token
Secure Dapr component connections to Azure services https://learn.microsoft.com/en us/azure/container apps/dapr component connect services
Configure custom environment DNS suffix and TLS in Container Apps https://learn.microsoft.com/en us/azure/container apps/environment custom dns suffix
Harden Container Apps VNets with NSG and UDR rules https://learn.microsoft.com/en us/azure/container apps/firewall integration
Store app level secrets for Functions on Container Apps https://learn.microsoft.com/en us/azure/container apps/functions secrets app level
Configure Functions host key storage on Container Apps https://learn.microsoft.com/en us/azure/container apps/functions secrets host keys
Manage app and access secrets for Functions on Container Apps https://learn.microsoft.com/en us/azure/container apps/functions secrets tutorial
Secure Container Apps with private endpoints https://learn.microsoft.com/en us/azure/container apps/how to use private endpoint
Configure IP ingress restrictions for Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/ip restrictions
Import and manage Container Apps certificates from Key Vault https://learn.microsoft.com/en us/azure/container apps/key vault certificates manage
Manage and use secrets in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/manage secrets
Use managed identities with Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/managed identity