Skip to content
azure-vm-scalesets logo

azure-vm-scalesets

Expert knowledge for Azure Virtual Machine Scale Sets development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring autoscale, standby pools, Sp...

MicrosoftDocs/Agent-Skills0installs770stars

SKILL.md

Full skill instructions

Azure 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), 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-L43Diagnosing and fixing issues with VMSS instance mix, standby pools behavior, and autoscale (rules, scaling delays, capacity mismatches, and common error scenarios).
Best PracticesL44-L49Configuring rolling upgrades for VM scale sets, tuning MaxSurge settings, and strategies to minimize downtime and maintain high availability during production updates.
Decision MakingL50-L66Guidance on choosing VMSS orchestration/​upgrade modes, autoscale, Spot vs standard/​priority mix, fault domains, standby pools, and cost-optimized configurations for different workload patterns.
Architecture & Design PatternsL67-L71Designing scale sets with proximity placement groups to minimize latency, improve performance, and ensure VMs are co-located for tightly coupled or high-performance workloads
Limits & QuotasL72-L77Limits, quotas, and behaviors of VM Scale Sets, including placement groups, max instance counts, capacity constraints, and how scaling and distribution work under these limits.
SecurityL78-L89Encrypting 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.
ConfigurationL90-L133Configuring VM Scale Sets: templates, networking, disks, images, zones, upgrades, autoscale, repairs, standby pools, instance mix/​protection, maintenance, and CLI/​PowerShell/​API management.
Integrations & Coding PatternsL134-L139Configuring VM scale set standby pools with Log Analytics for monitoring and integrating scale sets with Azure DSC extension for automated configuration management.
DeploymentL140-L146Creating VM scale sets from generalized/​specialized Shared Image Gallery images, migrating flexible sets to zonal, and deploying apps onto scale set instances.

Troubleshooting

Best Practices

Decision Making

TopicURL
Apply Azure Hybrid Benefit to Linux scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/azure-hybrid-benefit-linux
Migrate workloads to Flexible orchestration scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/flexible-virtual-machine-scale-sets-migration-resources
Decide when to use instance mix in VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-mix-overview
Compare Uniform and Flexible VMSS APIshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/orchestration-modes-api-comparison
Use Spot Placement Score to plan deploymentshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/spot-placement-score
Balance Spot and standard VMs with Priority Mixhttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/spot-priority-mix
Use standby pools to reduce VM scale set latencyhttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-overview
Use Spot VMs in scale sets for cost savingshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/use-spot
Select autoscale options for Azure VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-autoscale-overview
Design and choose features for VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-design-overview
Choose and configure fault domains for scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-manage-fault-domains
Choose VM scale set orchestration mode in Azurehttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-orchestration-modes
Choose upgrade policy modes for VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-upgrade-policy

Architecture & Design Patterns

Limits & Quotas

Security

Configuration

TopicURL
Alert on Automatic Instance Repairs ServiceState changeshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/alert-rules-automatic-repairs-service-state
Enable Automatic Zone Balance on scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/auto-zone-balance-enable
Use Automatic Zone Balance for VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/auto-zone-balance-overview
Define VM scale set configuration with ARM templateshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/flexible-virtual-machine-scale-sets-rest-api
Configure instance mix for Azure VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-mix-create
Update instance mix settings on Azure VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-mix-update
Inspect instance mix configuration on VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/instance-mix-view
Enable resilient create and delete for scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/resilient-vm-create-delete
Create and configure standby pools for VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-create
Retrieve standby pool and instance details for VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-get-details
Understand and query standby pool health state in VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-health-state
Get prediction results to size VM scale set standby poolshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-prediction-results
Configure Spot instances in VM scale set standby poolshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-spot-instances
Update or delete standby pools for Azure VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/standby-pools-update-delete
Configure attached data disks for VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-attached-disks
Configure automatic instance repairs for scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-automatic-instance-repairs
Configure automatic OS image upgrades for VMSShttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-automatic-upgrade
Change upgrade policy mode on existing scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-change-upgrade-policy
Sequence VM extensions in Azure scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-extension-sequencing
Configure Application Health extension for scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-health-extension
Understand and use instance IDs in scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-instance-ids
Configure instance protection on VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-instance-protection
Handle maintenance notifications for VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-maintenance-notifications
Manage VM Scale Sets using Azure CLI commandshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-manage-cli
Manage VM Scale Sets with Azure PowerShellhttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-manage-powershell
Reference custom images in scale set templateshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-mvss-custom-image
Use existing virtual networks in VMSS templateshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-mvss-existing-vnet
Configure guest-metric autoscale for Linux VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-mvss-guest-based-autoscale-linux
Author basic ARM templates for VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-mvss-start
Configure networking for Azure VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-networking
Perform manual instance upgrades in VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-perform-manual-upgrades
Reimage virtual machines in a scale sethttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-reimage-virtual-machine
Configure custom metrics for rolling upgradeshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-rolling-upgrade-custom-metrics
Configure scale-in policies for Azure VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-scale-in-policy
Define scaling profiles for Azure VM scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-scaling-profile
Set upgrade policy mode on VM Scale Setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-set-upgrade-policy
Enable terminate notifications for scale set instanceshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-terminate-notification
Modify VM Scale Set model and configuration via APIshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-upgrade-scale-set
Configure VM Scale Sets with availability zoneshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-use-availability-zones
Configure and manage zone balancing in scale setshttps://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-zone-balancing

Integrations & Coding Patterns

Deployment