Login
microsoftdocs/agent-skills1 file

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 configuring ACA ingress/scale, Dapr or Functions workloads, GitHub Actions CI/CD, private networking, or GPUs, and other Azure Container Apps related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Spring Apps (use azure-spring-apps).

Use this skillView repositoryView on skills.sh
Specification
Skill ID
microsoftdocs/agent-skills/azure-container-apps
Publisher
microsoftdocs
Repository
agent-skills
Installs
0
Files
1
Requires
Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

microsoftdocs/agent-skills/azure-container-appsInstalls these files
  • SKILL.md

What this skill tells the agent

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-L52Diagnosing 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 PracticesL53-L59Deployment, cold-start, and runtime tuning guidance: blue-green rollouts, reducing scale-out latency, and optimizing Java memory usage in Azure Container Apps.
Decision MakingL60-L81Guides 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 PatternsL82-L87Architectures 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 & QuotasL88-L94Quotas, limits, and scaling caps for Container Apps, plus how they behave at those limits and how to request quota increases from Azure support.
SecurityL95-L133Securing Container Apps: auth (Entra, social, OIDC, mTLS), secrets and certs, private networking, egress control, RBAC/Policy, and best practices for protecting apps and Functions.
ConfigurationL134-L170Configuring Container Apps environments, networking, ingress, revisions, scaling (KEDA/Dapr/Functions), workload profiles, storage mounts, Java features, and ARM/YAML schemas.
Integrations & Coding PatternsL171-L194Patterns for connecting Container Apps to each other and Azure services, integrating Dapr/Spring/OpenTelemetry, and using code interpreter and dynamic session features.
DeploymentL195-L203Deploying 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

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 Azure Container Apps deployment failureshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-deployment-errors
Troubleshoot health probe failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-health-probe-failures
Diagnose and fix image pull failures in 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 issues in Azure Container Appshttps://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
Select 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 autosuspend vs snapshots for sandbox statehttps://learn.microsoft.com/en-us/azure/container-apps/sandboxes-snapshots-state-management
Choose Container Apps compute and billing structureshttps://learn.microsoft.com/en-us/azure/container-apps/structure

More from microsoftdocs

microsoftdocs/agent-skills

Azure SQL Database

Expert knowledge for Azure SQL Database development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing tiers (DTU/vCore/serverless), configuring geo-replication/DR, Hyperscale, Data Sync, or elastic pools, and other Azure SQL Database related development tasks. Not for Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines), Azure Cosmos DB (use azure-cosmos-db), Azure Data Factory (use azure-data-factory).

microsoftdocs/agent-skills

Azure Well Architected

Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI, HPC, SaaS, AVD, or mission-critical workloads and optimizing Azure services by WAF pillars, and other Azure Well Architected related development tasks.

microsoftdocs/mcp

Microsoft Code Reference

Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or reviewing code that touches any Microsoft SDK, .NET library, Azure client library, or Microsoft API—even if they don't ask for a "reference." Catches hallucinated methods, wrong signatures, and deprecated patterns. If the task involves producing or fixing Microsoft-related code, this is the right skill.

Use this skill in a project

Open any RiverX project, search the Skills panel for microsoftdocs/agent-skills/azure-container-apps, and install it in one click.

Use this skill