Azure Local Skill

SkillCloud & infra

Expert knowledge for Azure Local development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when planning Azure Local racks/SDN, disconnected clusters, Arc VMs, GPU workloads, or Terraform automation, and other Azure Local related development tasks. Not for Microsoft Foundry Local (use microsoft-foundry-local), Azure Stack Edge (use azure-stack-edge), Azure Arc (use azure-arc), Azure Virtual Machines (use azure-virtual-machines).

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Azure Local Skill skill

What this skill tells your AI

The instructions your AI receives, as published by microsoftdocs/agent-skills in skills/azure-local/SKILL.md and read by ahel’s review.

This skill provides expert guidance for Azure Local. 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-L74Diagnosing and fixing Azure Local deployment, upgrade, SDN, Arc VM, multi-rack, and small form factor issues, plus collecting logs and using support tools for troubleshooting.
Best PracticesL75-L85Guidance on Azure Local networking, SDN performance, rack-aware deployments, VM operations, disks/NICs, multi-rack VM behavior, and safe update/maintenance practices.
Decision MakingL86-L103Guides for choosing Azure Local deployment types, scale, hardware, networking, identity, and billing models (including disconnected), and comparing Azure Local with other options.
Architecture & Design PatternsL104-L137Designing Azure Local network/SDN topologies, rack/room layouts, SAN patterns, resiliency and disaster recovery strategies, including connected and disconnected deployment architectures.
Limits & QuotasL138-L146Hardware, network, and system requirements, limits, and prerequisites for Azure Local disaggregated clusters, multi-rack setups, SLB HA ports, and Arc-enabled VMs.
SecurityL147-L194Compliance, identity, encryption, firewall/NSG, certificates, Defender, JIT access, and other security controls for Azure Local (connected and disconnected, multi-rack, small form factor).
ConfigurationL195-L325Configuring and managing Azure Local infrastructure: networking, storage, GPUs, VM images/activation, SDN, monitoring, Arc/disconnected setups, multi-rack, small form factor, and update settings.
Integrations & Coding PatternsL326-L337Integrating Azure Local with external tools and Azure services: Grafana monitoring, GPU REST APIs, disk/image import, VM creation/migration, and CLI/PowerShell/Terraform automation.
DeploymentL338-L381Deploying, updating, and upgrading Azure Local: cluster types, ARM/portal installs, SDN, SQL/CVM/VM apps, disconnected operations, repairs, and solution/OS update workflows.

Troubleshooting

TopicURL
Troubleshoot simplified machine provisioning in Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/deploy/troubleshoot-simplified-machine-provisioning?view=azloc-2608
Resolve known issues in Azure Local releaseshttps://learn.microsoft.com/en-us/azure/azure-local/known-issues?view=azloc-2608
FAQ for managing Azure Local Arc-enabled VMshttps://learn.microsoft.com/en-us/azure/azure-local/manage/azure-arc-vms-faq?view=azloc-2608
Collect diagnostic logs for Azure Local Arc VMshttps://learn.microsoft.com/en-us/azure/azure-local/manage/collect-log-files-arc-enabled-vms?view=azloc-2608
Use appliance fallback logging for ALDO Arc-enabled VMshttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-fallback?view=azloc-2608
Resolve known issues in Azure Local disconnected operationshttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-known-issues?view=azloc-2608
Collect on-demand logs for Azure Local disconnected operationshttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-on-demand-logs?view=azloc-2608
Track and manage Health Service actions in Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/health-service-actions?view=azloc-2608
Interpret and resolve Health Service faults in Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/health-service-faults?view=azloc-2608
Use AKS Arc Support Tool to remediate Azure Local infrastructurehttps://learn.microsoft.com/en-us/azure/azure-local/manage/remediate-support-tool-infrastructure?view=azloc-2608
Use Azure Local Remote Support Arc extensionhttps://learn.microsoft.com/en-us/azure/azure-local/manage/remote-support-arc-extension?view=azloc-2608
Collect SDN logs for Azure Local troubleshootinghttps://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-log-collection?view=azloc-2608
Troubleshoot Azure Local SDN deployment and connectivityhttps://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-troubleshooting?view=azloc-2608
Run Azure Local Support Diagnostic Tool for issue resolutionhttps://learn.microsoft.com/en-us/azure/azure-local/manage/support-tools?view=azloc-2608
Troubleshoot Azure Local Arc-enabled virtual machineshttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-arc-enabled-vms?view=azloc-2608
Gather traces and logs for common Azure Local SDN issueshttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-common-sdn-issues?view=azloc-2608
Troubleshoot confidential VM deployments on Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-confidential-vm?view=azloc-2608
Troubleshoot Azure Local registration via Configurator apphttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-deployment-configurator-app?view=azloc-2608
Resolve Azure Local deployment validation issues via portalhttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-deployment?view=azloc-2608
Troubleshoot SDN deployment via Windows Admin Center on Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-sdn-deployment?view=azloc-2608
Diagnose and fix Software Load Balancer data path issueshttps://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-software-load-balancer?view=azloc-2608
Troubleshoot Azure Local VM migration with Azure Migratehttps://learn.microsoft.com/en-us/azure/azure-local/migrate/migrate-troubleshoot?view=azloc-2608
Resolve known Azure Migrate issues for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/migrate/migration-known-issues?view=azloc-2608
Use serial console to troubleshoot Azure Local multi-rack VMshttps://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-serial-console?view=azloc-2608
Resolve Azure Local multi-rack storage appliance errorshttps://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-storage-appliance-error-messages?view=azloc-2608
Troubleshoot Azure Local multi-rack Arc-enabled VMshttps://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-troubleshoot-arc-enabled-vms?view=azloc-2608
Address known issues in Azure Local 23xx releaseshttps://learn.microsoft.com/en-us/azure/azure-local/previous-releases/known-issues-23?view=azloc-2608
Work around known issues in Azure Local 24xx releaseshttps://learn.microsoft.com/en-us/azure/azure-local/previous-releases/known-issues-24?view=azloc-2608
Collect support logs from Azure Local small form factorhttps://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-collect-system-logs?view=azloc-2608
Use Configurator App to manage Azure Local small form factor deviceshttps://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-configurator-app?view=azloc-2608
Diagnose known issues in Azure Local small form factorhttps://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-known-issues?view=azloc-2608
Troubleshoot Azure Local small form factor deploymentshttps://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-troubleshoot?view=azloc-2608
Troubleshoot Azure Local solution update failureshttps://learn.microsoft.com/en-us/azure/azure-local/update/update-troubleshooting-23h2?view=azloc-2608
Troubleshoot Azure Local upgrade issues and failureshttps://learn.microsoft.com/en-us/azure/azure-local/upgrade/troubleshoot-upgrade-to-23h2?view=azloc-2608

Best Practices

TopicURL
Apply Network ATC best practices in Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/network-atc-overview?view=azloc-2608
Prepare network and machines for rack aware deploymenthttps://learn.microsoft.com/en-us/azure/azure-local/deploy/rack-aware-cluster-deploy-prep?view=azloc-2608
Optimize availability and performance of Azure Local SDNhttps://learn.microsoft.com/en-us/azure/azure-local/manage/optimize-sdn-availability-performance?view=azloc-2608
Supported and unsupported operations for Azure Local VMshttps://learn.microsoft.com/en-us/azure/azure-local/manage/virtual-machine-operations?view=azloc-2608
Manage disks and NIC resources for Azure Local VMshttps://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-manage-arc-virtual-machine-resources?view=azloc-2608
Understand supported operations for Azure Local multi-rack VMshttps://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-virtual-machine-operations?view=azloc-2608
Best practices for managing Azure Local updateshttps://learn.microsoft.com/en-us/azure/azure-local/update/update-best-practices?view=azloc-2608

Decision Making

TopicURL
Use Azure Hybrid Benefit with Azure Local deploymentshttps://learn.microsoft.com/en-us/azure/azure-local/concepts/azure-hybrid-benefit?view=azloc-2608
Understand billing and payment for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/billing?view=azloc-2608
Compare Azure Local VM types and management capabilitieshttps://learn.microsoft.com/en-us/azure/azure-local/concepts/compare-vm-management-capabilities?view=azloc-2608
Decide between Azure Local and Windows Serverhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/compare-windows-server?view=azloc-2608
Select hardware and network for Azure Local deploymentshttps://learn.microsoft.com/en-us/azure/azure-local/concepts/system-requirements-23h2?view=azloc-2608
Plan private endpoint connectivity for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/deploy/about-private-endpoints?view=azloc-2608
Decide on local identity with Key Vault for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/deploy/deployment-local-identity-with-key-vault-overview?view=azloc-2608
Evaluate billing model for Azure Local disconnected operationshttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-billing?view=azloc-2608
Plan post-restore rehydration for disconnected Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-post-restore-overview?view=azloc-2608
Choose a network pattern for disaggregated Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/plan/choose-network-pattern-disaggregated?view=azloc-2608
Choose the right Azure Local deployment typehttps://learn.microsoft.com/en-us/azure/azure-local/plan/find-your-deployment-type?view=azloc-2608
Select Azure Local deployment scale and typehttps://learn.microsoft.com/en-us/azure/azure-local/scalability-deployments?view=azloc-2608
Select connectivity modes for Azure Local small form factorhttps://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/connectivity-modes?view=azloc-2608
Choose container orchestrator for Azure Local small form factorhttps://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-container-orchestrators?view=azloc-2608

Architecture & Design Patterns

TopicURL
Plan SDN infrastructure for Azure Local 23H2https://learn.microsoft.com/en-us/azure/azure-local/concepts/plan-software-defined-networking-infrastructure-23h2?view=azloc-2608
Understand private path network architecture for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/private-path-network-overview?view=azloc-2608
Apply rack aware cluster network reference patternshttps://learn.microsoft.com/en-us/azure/azure-local/concepts/rack-aware-cluster-reference-architecture?view=azloc-2608
Design room-to-room links for rack aware clustershttps://learn.microsoft.com/en-us/azure/azure-local/concepts/rack-aware-cluster-room-to-room-connectivity?view=azloc-2608
Design SDN Multisite topology and disaster recoveryhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/sdn-multisite-overview?view=azloc-2608
Plan SDN enabled by Azure Arc on Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/sdn-overview?view=azloc-2608
Design local availability zones for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/configure-local-availability-zones-disaggregated?view=azloc-2608
Design resilient infrastructure for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-infrastructure-resiliency?view=azloc-2608
Plan disaster recovery for Azure Local virtual machineshttps://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-overview?view=azloc-2608
Improve virtual machine resiliency on Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-vm-resiliency?view=azloc-2608
Design workload-level disaster recovery on Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-workloads-resiliency?view=azloc-2608
Design dedicated management clusters for disconnected Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-control-plane-appliance?view=azloc-2608
Plan networking for disconnected Azure Local deploymentshttps://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-network?view=azloc-2608
Load balance multiple logical networks in Azure Local SDNhttps://learn.microsoft.com/en-us/azure/azure-local/manage/load-balance-multiple-networks?view=azloc-2608
Select Azure Local deployment network patternshttps://learn.microsoft.com/en-us/azure/azure-local/plan/choose-network-pattern?view=azloc-2608
Design Azure Local cloud deployment networkhttps://learn.microsoft.com/en-us/azure/azure-local/plan/cloud-deployment-network-considerations?view=azloc-2608
Plan FC disaggregated pattern without backup networkhttps://learn.microsoft.com/en-us/azure/azure-local/plan/fiber-channel-no-backup-disaggregated-pattern?view=azloc-2608
Plan FC disaggregated pattern with backup networkhttps://learn.microsoft.com/en-us/azure/azure-local/plan/fiber-channel-with-backup-disaggregated-pattern?view=azloc-2608
Plan four-node switchless dual-link Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/four-node-switchless-two-switches-two-links?view=azloc-2608
Plan iSCSI 6-NIC disaggregated SAN patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/iscsi-6-network-adapters-disaggregated-pattern?view=azloc-2608
Understand network reference patterns for disaggregated Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/plan/network-patterns-overview-disaggregated?view=azloc-2608
Understand Azure Local network reference patternshttps://learn.microsoft.com/en-us/azure/azure-local/plan/network-patterns-overview?view=azloc-2608
Consider SDN options for Azure Local network patternshttps://learn.microsoft.com/en-us/azure/azure-local/plan/network-patterns-sdn-considerations?view=azloc-2608
Plan single-server network pattern for Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/plan/single-server-deployment?view=azloc-2608
Plan three-node switchless single-link Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/three-node-switchless-two-switches-single-link?view=azloc-2608
Plan three-node switchless dual-link Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/three-node-switchless-two-switches-two-links?view=azloc-2608
Plan two-node switched converged Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/two-node-switched-converged?view=azloc-2608
Plan two-node switched non-converged Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/two-node-switched-non-converged?view=azloc-2608
Plan two-node switchless single-switch Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/two-node-switchless-single-switch?view=azloc-2608
Plan two-node switchless dual-switch Azure Local patternhttps://learn.microsoft.com/en-us/azure/azure-local/plan/two-node-switchless-two-switches?view=azloc-2608

Limits & Quotas

TopicURL
Physical network requirements for disaggregated Azure Localhttps://learn.microsoft.com/en-us/azure/azure-local/concepts/physical-network-requirements-disaggregated?view=azloc-2608
System requirements for Azure Local disaggregated clustershttps://learn.microsoft.com/en-us/azure/azure-local/concepts/system-requirements-disaggregated?view=azloc-2608
Prerequisites for Azure Local Arc-enabled VMshttps://learn.microsoft.com/en-us/azure/azure-local/manage/azure-arc-vm-management-prerequisites?view=azloc-2608
Configure SLB high availability ports and understand limitationshttps://learn.microsoft.com/en-us/azure/azure-local/manage/configure-software-load-balancer?view=azloc-2608
Review requirements for Azure Local multi-rack VMshttps://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-vm-management-prerequisites?view=azloc-2608

Shortened here. Read the whole file on GitHub.

Signals

GitHub stars
740
Forks
119
Last commit
Sep 2026

ahel review

  • S4info
    community integration — published by microsoftdocs, not azure

Automated review, not a security audit. Ruleset v1.

Advanced
Catalog kind
skill
Gateway key
azure-local
Source
github.com/microsoftdocs/agent-skills