Skip to main content
skill CX Codex

azure-container-instances — skill for Claude Code

A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that equips your AI assistant with expert guidance on Azure Container Instances.

CC-BY-4.0 188 installs ★ 818 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-container-instances -a claude-code
Open on GitHub

What azure-container-instances does

The skill brings reference material for container deployment, security, network architectures, and troubleshooting. Covers DNS setup, environment variables, readiness probes, restart policies, volumes, and logging. Helps you decide between Spot containers for cost savings and standard instances, plan static inbound and outbound IPs using Application Gateway, firewall rules, or NAT Gateway, and understand resource limits and quotas.

Works across six platforms: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Requires network access to fetch documentation from Microsoft Learn via mcp_microsoftdocs or fetch_webpage. If content becomes older than three months, your agent will suggest pulling the latest version from the repository.

What it helps with

  • deploy a container to Azure without manual configuration steps
  • set up static IP addresses for inbound and outbound traffic
  • compare costs between standard and Spot container instances
  • secure containers with TLS, secrets, and managed identities
  • diagnose deployment failures using logs and ACI events

Example prompts for the agent

  • Show me how to deploy a container from ACR with managed identity and environment variables.
  • Configure outbound IP for a container through NAT Gateway behind a firewall.
  • Compare the cost of a standard container versus a Spot instance for my background worker task.

How to install azure-container-instances

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-container-instances -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-container-instances/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-container-instances/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-container-instances

How do I install azure-container-instances in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-container-instances -a claude-code in your terminal, then open ~/.claude/skills/azure-container-instances/SKILL.md. For other platforms, the command differs: for Cursor use -a cursor, for GitHub Copilot use gh skill install MicrosoftDocs/Agent-Skills azure-container-instances.

What does this skill do?

It adds a reference guide on Azure Container Instances to your AI assistant, covering architecture, deployment, security, network patterns, resource limits, Spot containers, and troubleshooting. Your assistant can fetch current documentation and help configure containers within your editor.

Do I need this skill if I use Azure Kubernetes Service?

No, AKS has a separate skill called azure-kubernetes-service. Use azure-container-instances if you deploy individual containers or container groups without Kubernetes orchestration.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-container-instances
description: Expert knowledge for Azure Container Instances development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and deployment. Use when configuring ACI networking/IPs, standby pools, Spot containers, GitHub Actions deploys, or secure ACR pulls, and other Azure Container Instances related development tasks. Not for Azure Container Apps (use azure-container-apps), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Virtual Machines (use azure-virtual-machines), Azure Batch (use azure-batch).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  generator: "docs2skills/1.0.0"
---
# Azure Container Instances Skill

This skill provides expert guidance for Azure Container Instances. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, 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 | L36-L42 | Diagnosing ACI issues using logs/events, understanding provisioning/runtime states, and troubleshooting deployment failures and container startup problems. |
| Best Practices | L43-L47 | Guidance on designing and running ACI workloads reliably: resource sizing, networking, storage, security, scaling, image management, and operational best practices. |
| Decision Making | L48-L53 | Guidance on cost-optimizing ACI with Spot containers and using prediction-based sizing to configure and right-size Azure Container Instances standby pools. |
| Architecture & Design Patterns | L54-L60 | Design patterns for giving ACI containers static inbound/outbound IPs using Application Gateway, firewalls, and NAT Gateway for controlled, predictable network egress/ingress. |
| Limits & Quotas | L61-L69 | ACI CPU/memory limits, quotas, standby pool caps, VNet constraints, and FAQs on scaling, resource behavior, and how to check or stay within these limits. |
| Security | L70-L84 | Securing Azure Container Instances: TLS/HTTPS setup, secrets and CMK encryption, managed identities/RBAC, secure ACR pulls, DNS reuse protection, and Azure Policy for compliance. |
| Configuration | L85-L116 | Configuring ACI behavior: DNS, env vars, commands/entrypoints, probes, restart policies, volumes, GPUs, standby pools, logging, and monitoring/log analytics setup. |
| Deployment | L117-L120 | Using GitHub Actions to build, push, and automatically deploy container images to Azure Container Instances, including workflow YAML setup and authentication configuration. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Retrieve Azure Container Instances logs and events for troubleshooting | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-get-logs |
| Troubleshoot Azure Container Instances deployment issues | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-troubleshooting |
| Interpret Azure Container Instances provisioning and runtime states | https://learn.microsoft.com/en-us/azure/container-instances/container-state |

### Best Practices
| Topic | URL |
|-------|-----|
| Apply Azure Container Instances workload best practices | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-best-practices-and-considerations |

### Decision Making
| Topic | URL |
|-------|-----|
| Decide when to use ACI Spot containers for cost savings | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-spot-containers-overview |
| Use prediction results to right-size Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-prediction-results |

### Architecture & Design Patterns
| Topic | URL |
|-------|-----|
| Expose Azure Container Instances via Application Gateway static IP | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-application-gateway |
| Configure static outbound IP for Azure Container Instances with firewall | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-egress-ip-address |
| Configure Azure Container Instances egress via NAT Gateway | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-nat-gateway |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Use Big Containers with ACI vCPU and memory limits | https://learn.microsoft.com/en-us/azure/container-instances/big-containers |
| Azure Container Instances FAQs on limits and behavior | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-faq |
| Check Azure Container Instances resource and quota limits | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-resource-and-quota-limits |
| FAQ and limits for Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-faq |
| Understand ACI virtual network scenarios and limits | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-virtual-network-concepts |

### Security
| Topic | URL |
|-------|-----|
| Configure automatic HTTPS for Azure Container Instances using Caddy | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-container-group-automatic-ssl |
| Enable TLS for Azure Container Instances with Nginx sidecar | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-container-group-ssl |
| Encrypt Azure Container Instances deployment data with customer-managed keys | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-encrypt-data |
| Secure images and secrets for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-image-security |
| Configure managed identities for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-managed-identity |
| Configure RBAC permissions for Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-configure-permissions |
| Secure ACI pulls from Azure Container Registry with service principals | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-using-azure-container-registry |
| Mount secret volumes in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-volume-secret |
| Set ACI DNS name reuse policy to prevent subdomain takeover | https://learn.microsoft.com/en-us/azure/container-instances/how-to-reuse-dns-names |
| Use built-in Azure Policy definitions for Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/policy-reference |
| Use managed identities for ACI access to Azure Container Registry | https://learn.microsoft.com/en-us/azure/container-instances/using-azure-container-registry-mi |

### Configuration
| Topic | URL |
|-------|-----|
| Use config maps to manage settings in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-config-map |
| Configure custom DNS for Azure Container Instances container groups | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-custom-dns |
| Configure environment variables for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-environment-variables |
| Execute commands in running Azure Container Instances containers | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-exec |
| Deploy GPU-enabled workloads on Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-gpu |
| Configure init containers in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-init-container |
| Configure liveness probes for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-liveness-probe |
| Configure Azure Container Instances log collection | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-log-analytics |
| Configure readiness probes for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-readiness-probe |
| Configure Azure Container Instances with YAML reference | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-reference-yaml |
| Configure restart policies for run-once tasks in ACI | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-restart-policy |
| Create standby pools for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-create |
| Retrieve details of Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-get-details |
| Understand and query health state of Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-health-state |
| Use standby pools to reduce Azure Container Instances scale-out latency | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-overview |
| Request container groups from Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-request-container |
| Update or delete Azure Container Instances standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pool-update-delete |
| Configure Log Analytics monitoring for ACI standby pools | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-standby-pools-monitor-pool-events |
| Override container entrypoint command in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-start-command |
| Manually stop and start Azure Container Instances container groups | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-stop-start |
| Update running container groups in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-update |
| Mount Azure Files volumes in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-volume-azure-files |
| Use emptyDir volumes to share data in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-volume-emptydir |
| Mount gitRepo volumes in Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-volume-gitrepo |
| Configure monitoring and alerts for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/monitor-azure-container-instances |
| Configure monitoring and alerts for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/monitor-azure-container-instances |
| Monitoring data reference for Azure Container Instances | https://learn.microsoft.com/en-us/azure/container-instances/monitor-azure-container-instances-reference |
| View Azure Container Instances logs in Log Analytics via portal | https://learn.microsoft.com/en-us/azure/container-instances/viewing-logs-in-portal |

### Deployment
| Topic | URL |
|-------|-----|
| Automate ACI deployments with GitHub Actions workflow configuration | https://learn.microsoft.com/en-us/azure/container-instances/container-instances-github-action |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-ai-vision Skill for Azure AI Vision on Claude Code, Codex, Cursor and other platforms. Gives your agent reference docs on Image Analysis, OCR containers, background removal and video frame analysis—including API migration, quotas, and deployment. CX Codex +1 193installs azure-resource-graph This skill guides Azure Resource Graph work, from query errors and quotas to pagination and integrations. Use it for ARG development tasks. CX Codex +1 189installs azure-sql-managed-instance Brings expert guidance on Azure SQL Managed Instance architecture, connectivity, and troubleshooting directly into the agent. CX Codex +1 189installs azure-artifacts This skill guides Azure Artifacts work: feed setup, package publishing, upstream sources, and troubleshooting. Use it when the task concerns Azure Artifacts. CX Codex +1 188installs azure-reliability azure-reliability is a Claude Code skill with guidance on Azure architecture, service limits, region selection and high availability for AKS, databases and networks. CX Codex +1 186installs azure-web-application-firewall azure-web-application-firewall — a skill for Claude Code guides the AI through Azure WAF setup, rule tuning, rate limits, and bot protection. Operates across Front Door and Application Gateway deployments. CX Codex +1 186installs azure-container-storage Skill for Claude Code, Codex, Cursor, and other AI code editors with expert guidance on Azure Container Storage. CX Codex +1 186installs azure-network-watcher Guides agents through Azure Network Watcher configuration, VPN troubleshooting, and flow log setup. Useful when building Terraform automations or writing KQL analytics queries. CX Codex +1 186installs

Project sponsors

Companies that keep this analytics open