/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 deploying Azure Local racks/SDN, Arc VMs, SFF setups, disconnected Arc gateway, or NVIDIA GPU workloads, and other Azure Local related development tasks. Not for Microsoft Foundry Local (use microsoft-foundry-local), Azure Stack Edge (use azure-stack-edge), Azure Kubernetes Service Edge Essentials (use azure-aks-edge-essentials), Azure IoT Edge (use azure-iot-edge).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  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-L74 | Diagnosing and fixing Azure Local issues: provisioning, SDN/network, Arc VMs, storage/SAN, multi-rack/SFF, registration, upgrades, logs/health checks, and known release-specific problems. | | Best Practices | L75-L84 | Guidance on deploying and operating rack-aware clusters, SDN performance/availability, supported Arc VM operations (single/multi-rack), and best practices for managing Azure Local updates. | | Decision Making | L85-L105 | Guidance for planning and choosing Azure Local deployment types, scale, networking/SDN, VM migration, DR, updates in disconnected setups, and upgrade readiness. | | Architecture & Design Patterns | L106-L137 | Designing resilient Azure Local architectures: rack-aware AKS, SDN/BGP topologies, storage/network patterns, availability zones, DR, disconnected ops, and VM resiliency. | | Limits & Quotas | L138-L150 | Hardware, network, cluster, and migration requirements, limits, and known issues for Azure Local (disaggregated, rack-aware, SFF, disconnected, Hyper‑V/VMware). | | Security | L151-L197 | Security hardening for Azure Local: firewalls, NSGs, RBAC, identity, certificates/PKI, encryption, Trusted launch/vTPM, Defender, monitoring, and security for SFF and SDN components. | | Configuration | L198-L315 | Configuring and managing Azure Local infrastructure: networking, storage, GPUs, VM lifecycle, monitoring, SDN, multi-rack, disconnected/Arc gateway setups, and update/health settings. | | Integrations & Coding Patterns | L316-L326 | Patterns for integrating Azure Local with private endpoints, Arc gateway, ACR, Grafana, GPU REST APIs, automation tools (PowerShell/CLI/Terraform), and NVIDIA GPU workloads. | | Deployment | L327-L374 | End-to-end Azure Local deployment, OS install/upgrade, SDN setup, VM/image prep (including confidential and Arc VMs), SAN/multi-rack planning, SFF scenarios, and update/patch workflows. |

Troubleshooting

| Topic | URL | |-------|-----| | Troubleshoot simplified machine provisioning in Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/deploy/troubleshoot-simplified-machine-provisioning?view=azloc-2610 | | Diagnose and work around Azure Local known issues | https://learn.microsoft.com/en-us/azure/azure-local/known-issues?view=azloc-2610 | | Collect diagnostic logs for Azure Local Arc-enabled VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/collect-log-files-arc-enabled-vms?view=azloc-2610 | | Use appliance fallback logging for disconnected Azure Local VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-fallback?view=azloc-2610 | | Known issues and workarounds for Azure Local disconnected operations | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-known-issues?view=azloc-2610 | | Collect on-demand logs for disconnected Azure Local troubleshooting | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-on-demand-logs?view=azloc-2610 | | Diagnose and interpret Azure Local Health Service faults | https://learn.microsoft.com/en-us/azure/azure-local/manage/health-service-faults?view=azloc-2610 | | Use Remediation Support Tool to fix Azure Local infrastructure | https://learn.microsoft.com/en-us/azure/azure-local/manage/remediate-support-tool-infrastructure?view=azloc-2610 | | Use Remote Support Arc extension for Azure Local diagnostics | https://learn.microsoft.com/en-us/azure/azure-local/manage/remote-support-arc-extension?view=azloc-2610 | | Repair failed or unhealthy Azure Local nodes | https://learn.microsoft.com/en-us/azure/azure-local/manage/repair-server-disaggregated?view=azloc-2610 | | Collect logs for Azure Local SDN troubleshooting | https://learn.microsoft.com/en-us/azure/azure-local