/azure-local

name: azure-local
description: 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 clusters, SDN networking, Arc‑managed VMs, disconnected racks, or GPU workloads, and other Azure Local related development tasks. Not for Microsoft Foundry Local (use microsoft-foundry-local), Azure Virtual Machines (use azure-virtual-machines), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Container Apps (use azure-container-apps).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-08-09"
  generator: "docs2skills/1.0.0"

Azure Local Skill

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](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 | L37-L72 | Diagnosing and fixing Azure Local issues: log collection, SDN/network faults, VM/Arc/registration/migration problems, health service errors, updates/upgrades, and known bugs/workarounds. | | Best Practices | L73-L83 | Guidance on Azure Local operations: SDN performance/availability, drift detection, alerts, supported VM operations (Arc/multi‑rack), Network ATC, and update management best practices. | | Decision Making | L84-L97 | Guidance on licensing, billing, VM and deployment choices, network patterns, support lifecycle, and selecting orchestrators or architectures when planning Azure Local solutions. | | Architecture & Design Patterns | L98-L132 | Designing resilient Azure Local architectures: SDN and rack-aware patterns, storage/network topologies, DR/HA strategies, and reference designs for connected and disconnected deployments | | Limits & Quotas | L133-L143 | Network, hardware, and system requirements for Azure Local disaggregated deployments, including rack-aware clusters, SLB HA ports, and Hyper-V/VMware migration prerequisites. | | Security | L144-L191 | Securing Azure Local: firewall/NSG rules, private endpoints, identity/RBAC, certificates/PKI, BitLocker, Defender, syslog/SIEM, Trusted launch, and security baselines/updates. | | Configuration | L192-L294 | Configuring Azure Local infrastructure: networking, storage, GPUs, SDN, monitoring, Arc/CLI/PowerShell, disconnected ops, multi-rack, VM lifecycle, migration, and update behavior. | | Integrations & Coding Patterns | L295-L304 | Integrating Azure Local with external SAN and Azure Storage, configuring GPUs and storage classes, and creating, downloading, and remotely accessing multi-rack VMs and VM images. | | Deployment | L305-L347 | Deploying, scaling, updating, and maintaining Azure Local clusters (rack-aware, disaggregated, SFF, disconnected), plus SDN, VM/container migrations, and post-deployment operations. |

Troubleshooting

| Topic | URL | |-------|-----| | Troubleshoot simplified machine provisioning for Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/deploy/troubleshoot-simplified-machine-provisioning?view=azloc-2607 | | Resolve known issues and workarounds in Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/known-issues?view=azloc-2607 | | Collect diagnostic logs for Azure Local Arc VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/collect-log-files-arc-enabled-vms?view=azloc-2607 | | Collect and upload Azure Local diagnostic logs | https://learn.microsoft.com/en-us/azure/azure-local/manage/collect-logs?view=azloc-2607 | | Use fallback log collection for Azure Local VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-fallback?view=azloc-2607 | | Known issues for Azure Local disconnected operations | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-known-issues?view=azloc-2607 | | Collect on-demand Azure Local logs for support | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-on-demand-logs?view=azloc-2607 | | Interpret and resolve Health Service faults in Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/health-service-faults?view=azloc-2607 | | Use AKS Arc Support Tool to remediate Azure Local infrastructure | https://learn.microsoft.com/en-us/azure/azure-local/manage/remediate-support-tool-infrastructure?view=azloc-2607 | | Use Azure Local Remote Support Arc extension | https://learn.microsoft.com/en-us/azure/azure-local/manage/remote-support-arc-extension?view=azloc-2607 | | Collect SDN logs for Azure Local troubleshooting | https://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-log-collection?view=azloc-2607