About azure-vm-scalesets
azure-vm-scalesets is a guidance skill for agents working with Azure Virtual Machine Scale Sets. It combines local references with remotely fetched documentation on design, scaling, security, configuration, and deployment.
Key features
- 01Troubleshooting instance mix and autoscale
- 02Rolling upgrade and availability guidance
- 03Orchestration, Spot, and scaling choices
- 04Capacity limits and security references
- 05Configuration, integration, and deployment guidance
Use cases
- 01Diagnosing autoscale or standby pool issues
- 02Choosing orchestration and upgrade strategies
- 03Planning availability zones and VM placement
- 04Encrypting disks and deploying scale sets
MCP support
The skill can fetch Microsoft documentation using mcp_microsoftdocs:microsoft_docs_fetch; fetch_webpage is listed as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-vm-scalesetsAfter installing, type/azure-vm-scalesetsin Claude Code to confirm it loaded.
Details
From the project READMEAzure Virtual Machine Scale Sets Skill
This skill provides expert guidance for Azure Virtual Machine Scale Sets. 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L43 | Diagnosing and fixing issues with VMSS instance mix, standby pools behavior, and autoscale (rules, scaling delays, capacity mismatches, and common error scenarios). |
| Best Practices | L44-L49 | Configuring rolling upgrades for VM scale sets, tuning MaxSurge settings, and strategies to minimize downtime and maintain high availability during production updates. |
| Decision Making | L50-L67 | Guidance on choosing VM scale set modes, availability, upgrade and autoscale strategies, Spot/Hybrid benefits, and cost/performance tradeoffs for different deployment scenarios. |
| Architecture & Design Patterns | L68-L73 | Designing VM scale sets for high availability and low latency using automatic zone balancing and proximity placement groups for optimal placement and resilience. |
| Limits & Quotas | L74-L79 | Scale set capacity, instance, and resource limits; placement group behavior; scaling constraints; and how limits affect deployment, availability, and distribution of VMs. |
| Security | L80-L91 | Encrypting VMSS disks (CLI, PowerShell, ARM), configuring Azure Disk Encryption with Key Vault and extensions, and securing scale sets via Azure Policy and RBAC for standby pools. |
| Configuration | L92-L134 | Configuring VM scale sets: templates, networking, disks, zones, upgrades, autoscale, standby pools, instance mix/protection, health/maintenance, and CLI/PowerShell/API management. |
| Integrations & Coding Patterns | L135-L140 | Configuring VM scale set standby pools with Log Analytics for monitoring and integrating scale sets with Azure DSC extension for automated configuration management. |
| Deployment | L141-L147 | Creating VM scale sets from generalized/specialized Shared Image Gallery images, migrating flexible sets to zonal, and deploying/rolling out applications to scale set instances |
Troubleshooting
| Topic | URL |
|---|---|
| FAQ and troubleshooting for VM scale set instance mix | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-mix-faq-troubleshooting |
| FAQ and troubleshooting for VM scale set standby pools | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-faq |
| Troubleshoot autoscale issues in Azure VM scale sets | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-troubleshoot |
Best Practices
| Topic | URL |
|---|---|
| Configure rolling upgrades for production scale sets | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-configure-rolling-upgrades |
| Use MaxSurge rolling upgrades to improve uptime | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-maxsurge |
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Use automatic zone balance for VM scale sets | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/auto-zone-balance-overview |
| Use proximity placement groups with scale sets | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/proximity-placement-groups |
Limits & Quotas
| Topic | URL |
|---|---|
| Reference limits and behaviors for VM Scale Sets | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq |
| Understand placement groups and scale set capacity limits | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-placement-groups |
Security
Configuration
Integrations & Coding Patterns
| Topic | URL |
|---|---|
| Integrate VM scale set standby pools with Azure Log Analytics | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-monitor-pool-events |
| Integrate VM Scale Sets with Azure DSC extension | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-dsc |
Deployment
| Topic | URL |
|---|---|
| Create scale sets from generalized gallery images | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-generalized-image-version |
| Create scale sets from specialized gallery images | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-specialized-image-version |
| Migrate regional flexible scale sets to zonal | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/migrate-scale-set-flex-to-availability-zones |
| Deploy applications to VM Scale Set instances | https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-deploy-app |