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 L54 Diagnosing and fixing Container Apps runtime issues: start/exit failures, image pulls, health probes, storage mounts, ports, capacity, Arc/MCP problems, and using logs/debug console.
Best Practices L55 L61 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 L62 L82 Guidance for planning and cost optimizing Azure Container Apps: capacity, plans, workload profiles, GPUs, hosting options, and migrations from Heroku, Functions, Java/Spring/Tomcat, and MCP servers.
Architecture & Design Patterns L83 L88 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 L89 L95 Limits, quotas, and capacity rules for Container Apps, plus how to view current limits, request quota increases, and understand scaling/behavioral constraints.
Security L96 L135 Auth, identity, and network security for Container Apps: Entra and social logins, mTLS, certs/CORS/domains, secrets and managed identity, RBAC/policy, private endpoints, firewalls, and WAF.
Configuration L136 L172 Configuring Container Apps environments, networking, ingress, revisions, scaling (KEDA/Dapr/Functions), workload profiles, Java features, storage, and maintenance via ARM, YAML, CLI, and Bicep.
Integrations & Coding Patterns L173 L196 Patterns for connecting Container Apps to each other and external services (Dapr, Spring, Front Door, Private Link) plus OpenTelemetry exports and code interpreter/dynamic session integrations.
Deployment L197 L204 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
Troubleshoot Azure Arc Container Apps dependencies and runtime https://learn.microsoft.com/en us/azure/container apps/azure arc troubleshoot
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
Fix common deployment failures in Azure Container Apps https://learn.microsoft.com/en us/azure/container apps/troubleshoot deployment errors
Resolve Azure Container Apps environment capacity errors https://learn.microsoft.com/en us/azure/container apps/troubleshoot environment capacity
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 resolve 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
Plan Azure Arc Container Apps cluster capacity and design https://learn.microsoft.com/en us/azure/container apps/azure arc plan
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
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 Azure Container Apps Functions v1 to v2 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 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 and adjust Azure Container Apps quotas https://learn.microsoft.com/en us/azure/container apps/quota requests
Review Azure Container Apps quotas and limits 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 for Azure 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 secrets securely in Azure Co