Skill

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 ingress/scale, Entra/OIDC auth, GitHub Actions CI/CD, Dapr integrations, or Java microservices on ACA, 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).

npx claudepluginhub atc-net/atc-agentic-toolkit --plugin azure

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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.

SKILL.md

Similar Skills

container-apps-gpu-2025

Guides Azure Container Apps deployment with 2025 GPU support for serverless AI/ML workloads, scale-to-zero, Dapr integration, jobs, and Foundry Models.

azure-master

twelve-factor

Guides 12-Factor methodology for scalable cloud-native apps. Use for microservices design, container config, Kubernetes deployment, CI/CD pipelines, and environment management.

all-skills

aws-containers

533

Deploys and operates containerized workloads on AWS ECS, Fargate, and ECR. Covers task definitions, services, debugging with ECS Exec, scaling, load balancers, and image management for AWS container optimization.

10 files1 tool

aws-core

Stats

Parent Repo Stars1

Parent Repo Forks1

Last CommitApr 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Azure Container Apps Skill

How to Use This Skill

IMPORTANT for Agent: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question This skill requires network access to fetch documentation content. Use mcp_microsoftdocs:microsoft_docs_fetch to retrieve full articles.

Fallback: Use the built-in WebFetch tool if the Microsoft Learn MCP server is not available.

Category Index

Category	Lines	Description
Troubleshooting	L31-L44	Diagnosing and fixing Container Apps issues: image pulls, container create/start, health probes, ports, storage mounts, OCI runtime, Java log levels, MCP servers, and using logs/debug console.
Best Practices	L46-L51	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	L53-L67	Guidance on choosing Container Apps plans, compute, GPUs, and hosting options, estimating costs, and planning/migrating environments from legacy setups or other platforms like Heroku/Functions
Architecture & Design Patterns	L69-L75	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	L77-L81	Quota and limit rules for Container Apps (CPU/memory, environments, revisions, scale) and how to request increases when you hit platform or subscription limits.
Security	L83-L116	Securing Container Apps: auth (Entra, social, OIDC, mTLS, certs), secrets & managed identity, private endpoints, NSGs/firewalls, WAF, DNS/TLS, CORS, and security best practices.
Configuration	L118-L161	Configuring Container Apps environments: networking, ingress, scaling (KEDA/Dapr), revisions/traffic, storage, workload profiles, logging/monitoring, alerts, Java features, and routing.
Integrations & Coding Patterns	L163-L187	Patterns for connecting Container Apps to each other, Azure services, Spring components, Front Door, and using Dapr, Service Connector, and code interpreter/dynamic sessions with AI frameworks.
Deployment	L189-L198	Guides for deploying and automating Container Apps: CI/CD with GitHub Actions/Azure Pipelines, Docker Compose and Functions deployment, Arc-enabled clusters, 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
Resolve container create 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 health probe failures in Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-health-probe-failures
Diagnose image pull failures in Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-image-pull-failures
Fix 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 Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/troubleshoot-target-port-settings
Diagnose Azure Container Apps using logs and config	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
Choose 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
Choose 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
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 appropriate workload profiles for Container Apps	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
Deploy Java microservices with managed components on Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/java-microservice-get-started
Understand AI-enabled PetClinic architecture on Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/java-petclinic-ai-overview
Design microservices architecture on Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/microservices

Limits & Quotas

Topic	URL
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
Enable GitHub authentication in 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 providers for Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/authentication-openid
Enable X (Twitter) authentication in 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
Secure Dapr requests with APP_API_TOKEN in Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/dapr-authentication-token
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 NSGs and firewalls	https://learn.microsoft.com/en-us/azure/container-apps/firewall-integration
Secure Container Apps with private endpoints	https://learn.microsoft.com/en-us/azure/container-apps/how-to-use-private-endpoint
Configure IP-based ingress restrictions for 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
Store and use secrets securely 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
Configure ACR image pulls via managed identity	https://learn.microsoft.com/en-us/azure/container-apps/managed-identity-image-pull
Configure authentication for MCP servers on Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/mcp-authentication
Configure mutual TLS for Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/mtls
Use built-in Azure Policy definitions for Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/policy-reference
Configure private endpoints and DNS for Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/private-endpoints-with-dns
Apply security best practices to Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/secure-deployment
Apply security features and practices in Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/security
Configure token store-backed auth for Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/token-store
Secure PostgreSQL access with managed identity from Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/tutorial-java-quarkus-connect-managed-identity-postgresql-database
Secure Container Apps egress with Azure Firewall	https://learn.microsoft.com/en-us/azure/container-apps/use-azure-firewall
Control Container Apps outbound traffic via Azure Firewall	https://learn.microsoft.com/en-us/azure/container-apps/user-defined-routes
Protect Container Apps with Application Gateway WAF	https://learn.microsoft.com/en-us/azure/container-apps/waf-app-gateway

Configuration

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

Integrations & Coding Patterns

Topic	URL
Implement direct microservice calls in Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/communicate-between-microservices
Configure inter-app communication in Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/connect-apps
Securely connect Dapr components to Azure services	https://learn.microsoft.com/en-us/azure/container-apps/dapr-component-connect-services
Create Dapr components for Azure services in portal	https://learn.microsoft.com/en-us/azure/container-apps/dapr-component-connection
Use Azure Functions Dapr extension in Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/dapr-functions-extension
Expose private Azure Container Apps via Front Door Premium	https://learn.microsoft.com/en-us/azure/container-apps/front-door-custom-virtual-network-private-link
Integrate Azure Container Apps with Front Door via Private Link	https://learn.microsoft.com/en-us/azure/container-apps/how-to-integrate-with-azure-front-door
Connect Container Apps to managed Admin for Spring	https://learn.microsoft.com/en-us/azure/container-apps/java-admin
Integrate Admin for Spring with Eureka Server on Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/java-admin-eureka-integration
Connect Container Apps to managed Config Server for Spring	https://learn.microsoft.com/en-us/azure/container-apps/java-config-server
Integrate managed Eureka Server with Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/java-eureka-server
Use managed Gateway for Spring with Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/java-gateway-for-spring
Visualize Java metrics with Azure Managed Grafana	https://learn.microsoft.com/en-us/azure/container-apps/java-metrics-with-grafana
Connect Container Apps to Azure services with Service Connector	https://learn.microsoft.com/en-us/azure/container-apps/service-connector
Integrate AutoGen agents with Azure Container Apps code interpreter sessions	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-autogen
Use Azure Container Apps code interpreter sessions with LangChain	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-langchain
Connect LlamaIndex agents to Azure Container Apps code interpreter sessions	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-llamaindex
Execute JavaScript via Azure Container Apps dynamic sessions	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-nodejs
Integrate Semantic Kernel with Azure Container Apps code interpreter sessions	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-semantic-kernel
Run shell commands using Azure Container Apps session pools	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-shell
Use platform-managed MCP with dynamic shell sessions in Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/sessions-tutorial-shell-mcp
Run event-driven jobs from Storage queues in Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/tutorial-event-driven-jobs

Deployment

Topic	URL
Enable Azure Container Apps on Arc-enabled Kubernetes clusters	https://learn.microsoft.com/en-us/azure/container-apps/azure-arc-enable-cluster
Automate Container Apps revisions with Azure Pipelines	https://learn.microsoft.com/en-us/azure/container-apps/azure-pipelines
Deploy Docker Compose agent workloads to Azure Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/compose-agent
Deploy custom containerized Functions to Container Apps	https://learn.microsoft.com/en-us/azure/container-apps/functions-container-apps
Automate Container Apps revisions with GitHub Actions	https://learn.microsoft.com/en-us/azure/container-apps/github-actions
Generate Container Apps GitHub Actions via Azure CLI	https://learn.microsoft.com/en-us/azure/container-apps/github-actions-cli
Run self-hosted CI/CD runners with Container Apps jobs	https://learn.microsoft.com/en-us/azure/container-apps/tutorial-ci-cd-runners-jobs