microsoftdocs/agent-skills

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.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-container-apps

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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-L54Diagnosing 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 PracticesL55-L61Deployment, cold-start, and runtime tuning guidance: blue-green rollouts, reducing scale-out latency, and optimizing Java memory usage in Azure Container Apps.
Decision MakingL62-L82Guidance 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 PatternsL83-L88Architectures 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 & QuotasL89-L95Limits, quotas, and capacity rules for Container Apps, plus how to view current limits, request quota increases, and understand scaling/behavioral constraints.
SecurityL96-L135Auth, 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.
ConfigurationL136-L172Configuring 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 PatternsL173-L196Patterns 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.
DeploymentL197-L204Deploying 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
Troubleshoot Azure Arc Container Apps dependencies and runtimehttps://learn.microsoft.com/en-us/azure/container-apps/azure-arc-troubleshoot
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
Fix common deployment failures in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-deployment-errors
Resolve Azure Container Apps environment capacity errorshttps://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-environment-capacity
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 resolve 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
Plan Azure Arc Container Apps cluster capacity and designhttps://learn.microsoft.com/en-us/azure/container-apps/azure-arc-plan
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
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 Azure Container Apps Functions v1 to v2https://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 and configure Azure Container Apps workload profileshttps://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
Design microservices architecture on Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/microservices

Limits & Quotas

TopicURL
Azure Container Apps limits and behavioral FAQshttps://learn.microsoft.com/en-us/azure/container-apps/faq
Request and adjust Azure Container Apps quotashttps://learn.microsoft.com/en-us/azure/container-apps/quota-requests
Review Azure Container Apps quotas and limitshttps://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 for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/custom-domains-managed-certificates
Use Dapr APPAPITOKEN 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
Harden Container Apps VNets with NSG and UDR ruleshttps://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
Manage app and access 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 ingress restrictions for Azure 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 secrets securely 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
Enable and use mTLS with 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 egress policies for Container Apps Sandboxeshttps://learn.microsoft.com/en-us/azure/container-apps/sandboxes-egress-policies
Assign required RBAC role for Container Apps Sandboxeshttps://learn.microsoft.com/en-us/azure/container-apps/sandboxes-get-started
Manage security and roles for Container Apps Sandboxeshttps://learn.microsoft.com/en-us/azure/container-apps/sandboxes-overview
Apply security best practices to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/secure-deployment
Use managed identity for Azure Files mounts in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/storage-mounts-azure-files
Configure token store-backed auth for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/token-store
Secure Container Apps egress via 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
Reference ARM and YAML schema for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/azure-resource-manager-api-spec
Enable and verify confidential compute for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/confidential-compute
Configure virtual networks for Azure 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 Azure 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 custom KEDA scale rules for Functions on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/functions-scale-rule-override
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
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
Configure networking for Azure Container Apps environmentshttps://learn.microsoft.com/en-us/azure/container-apps/networking
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 private endpoints and DNS for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/private-endpoints-with-dns
Configure and manage Container Apps revisionshttps://learn.microsoft.com/en-us/azure/container-apps/revisions-manage
Configure custom domains with rule-based routinghttps://learn.microsoft.com/en-us/azure/container-apps/rule-based-routing-custom-domain
Define Azure Container Apps sandbox groups with Bicephttps://learn.microsoft.com/en-us/azure/container-apps/sandboxes-quickstart-bicep
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
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
Configure Container Apps workload profiles with 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
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
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
Use managed Gateway for Spring with Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-gateway-for-spring
Configure OpenTelemetry agents for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/opentelemetry-agents
Export Container Apps telemetry to Datadog via OpenTelemetryhttps://learn.microsoft.com/en-us/azure/container-apps/opentelemetry-export-datadog
Configure OpenTelemetry export to Dynatrace for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/opentelemetry-export-dynatrace
Configure OpenTelemetry export to Elastic for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/opentelemetry-export-elastic
Configure OpenTelemetry export to New Relic for Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/opentelemetry-export-new-relic
Use Python SDK to manage Container Apps sandboxeshttps://learn.microsoft.com/en-us/azure/container-apps/sandboxes-quickstart-python-sdk
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

Deployment

TopicURL
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
Migrate Container Apps logging from Log Analytics to Azure Monitorhttps://learn.microsoft.com/en-us/azure/container-apps/migrate-logs-azure-monitor
from this repository

More skills

All skills
microsoftdocs
Community

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 DTU/vCore tiers, configuring serverless or Hyperscale, geo-replication/DR, CI/CD, or Terraform, and other Azure SQL Database related development tasks. Not for Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual

1h installs
3
GitHub stars
801
Updated
Oct 26
microsoftdocs
Community

azure-repos

Expert knowledge for Azure Repos development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Git/TFVC repos, branch policies/PR checks, TFVC→Git migrations, large files, or security scanning, and other Azure Repos related development tasks. Not for Azure DevOps (use azure-devops), Azure Pipelines (use azure-pipelines), Azure Boards (use azure-boards), Azure

1h installs
1
GitHub stars
790
Updated
Oct 19
microsoftdocs
Community

azure-monitor

Expert knowledge for Azure Monitor development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring AMA/DCRs, Log Analytics workspaces, Application Insights, alerts, or Kusto (KQL) queries, and other Azure Monitor related development tasks. Not for Azure Network Watcher (use azure-network-watcher), Azure Resource Graph (use azure-resource-graph), A

1h installs
1
GitHub stars
779
Updated
Oct 11
microsoftdocs
Community

azure-rbac

Expert knowledge for Azure Role-based access control development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when defining custom/built-in roles, ABAC conditions, deny assignments, PIM, or ARM/Bicep-based role automation, and other Azure Role-based access control related development tasks. Not for Azure Policy (use azure-policy), Azure Security (use azure-security), Azure Resource Manager (use azure

1h installs
2
GitHub stars
777
Updated
Oct 5