azure-container-instances

Name: azure-container-instances
Author: microsoftdocs

github.com/microsoftdocsCloud & DevOps796186 installsUpdated 3d ago

About azure-container-instances

A guidance skill for agents working with Azure Container Instances, covering troubleshooting, design, security, configuration, and deployment. It combines local quick references with remote documentation fetching.

Key features

01Deployment and runtime troubleshooting
02Workload design and resource planning
03Networking, security, and quota references
04Container group configuration and monitoring
05Local references with remote document fetching

Use cases

01Investigate container startup or deployment failures
02Plan static network addresses and outbound traffic
03Configure identities, secrets, and image access
04Deploy containers through GitHub Actions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-container-instances

After installing, type/azure-container-instancesin Claude Code to confirm it loaded.

Details

From the project README

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

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 limits, quotas, and behaviors: max CPU/memory (Big Containers), per‑region quotas, standby pool limits, VNet constraints, and FAQs on scaling, performance, and resource usage.
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 container groups: env vars, DNS, volumes, GPUs, probes, logging/monitoring, standby pools, restarts, entrypoints, updates, and runtime command execution.
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
Monitor Azure Container Instances standby pool events with Log Analytics	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

Comments

Markdown supported

Details

Author: microsoftdocs
Repository: microsoftdocs/agent-skills
Category: Cloud & DevOps
Installs: 186
GitHub stars: 796

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.