azure-local

# 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: provisioning, SDN/networking, Arc/VMs, upgrades, health checks, logs/diagnostics, known bugs, and version-specific or SFF/multi-rack workarounds. | | Best Practices | L73-L82 | Guidance for planning, deploying, and operating Azure Local rack-aware clusters, SDN, Arc VMs (single/multi-rack), and managing update/maintenance best practices for reliability and performance. | | Decision Making | L83-L102 | Guidance for choosing Azure Local deployment types, scale, networking/SDN, VM migration, DR, updates in disconnected setups, and container orchestrators for the right architecture. | | Architecture & Design Patterns | L103-L136 | Designing resilient Azure Local architectures: rack-aware clusters, SDN/BGP topologies, storage/network patterns, availability zones, DR, disconnected ops, and VM/network resiliency. | | Limits & Quotas | L137-L148 | Requirements, limits, and supported configurations for Azure Local disaggregated clusters, networking, rack-aware setups, disconnected ops, and VM migration (Hyper-V/VMware). | | Security | L149-L194 | Security hardening for Azure Local: firewalls, NSGs, RBAC, identity, certificates/PKI, BitLocker, Trusted Launch/guest attestation, Defender, logging/SIEM, and SFF security features. | | Configuration | L195-L309 | Configuring and operating Azure Local: networking, storage, GPUs, SDN, monitoring, updates, Arc/Arc gateway, disconnected backup/restore, and VM lifecycle for single, multi-rack, and SFF setups. | | Integrations & Coding Patterns | L310-L320 | Patterns for integrating Azure Local with private endpoints, Arc gateway, ACR, Grafana, GPU REST APIs, and automating VM migration via Arc agents, PowerShell, CLI, and Terraform. | | Deployment | L321-L378 | End-to-end deployment and update guidance for Azure Local: cluster and SDN setup, VM/image prep, SFF scenarios, OS/solution upgrades, and protecting workloads (SQL, ASR, confidential VMs). | ### 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 | | Resolve known issues in Azure Local releases | 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 | | Collect logs for Azure Local SDN troubleshooting | https://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-log-collection?view=azloc-2610 | | Troubleshoot Azure Local SDN and NSG connectivity issues | https://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-troubleshooting?view=azloc-2610 | | Run Azure Local Support Diagnostic Tool for issue resolution | https://learn.microsoft.com/en-us/azure/azure-local/manage/support-tools?view=azloc-2610 | | Troubleshoot Azure Local Arc-enabled virtual machines | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-arc-enabled-vms?view=azloc-2610 | | Collect traces and logs for common Azure Local SDN issues | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-common-sdn-issues?view=azloc-2610 | | Troubleshoot Azure Local confidential VM deployments and attestation | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-confidential-vm?view=azloc-2610 | | Troubleshoot Azure Local registration via Configurator app | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-deployment-configurator-app?view=azloc-2610 | | Fix Azure Local deployment validation issues in Azure portal | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-deployment?view=azloc-2610 | | Resolve Azure Local health check failures | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-health-check-failures?view=azloc-2610 | | Troubleshoot Azure Local SDN deployment via Windows Admin Center | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-sdn-deployment?view=azloc-2610 | | Troubleshoot Azure Local SDN Software Load Balancer | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-software-load-balancer?view=azloc-2610 | | Troubleshoot Azure Migrate VM migrations to Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/migrate/migrate-troubleshoot?view=azloc-2610 | | Resolve known Azure Migrate issues for Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/migrate/migration-known-issues?view=azloc-2610 | | Use Azure CLI serial console to troubleshoot Azure Local VMs | https://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-serial-console?view=azloc-2610 | | Resolve Azure Local multi-rack storage appliance error messages | https://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-storage-appliance-error-messages?view=azloc-2610 | | Troubleshoot Azure Local multi-rack Arc-enabled VMs and known issues | https://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-troubleshoot-arc-enabled-vms?view=azloc-2610 | | Diagnose and work around Azure Local 23xx issues | https://learn.microsoft.com/en-us/azure/azure-local/previous-releases/known-issues-23?view=azloc-2610 | | Work around known issues in Azure Local 24xx releases | https://learn.microsoft.com/en-us/azure/azure-local/previous-releases/known-issues-24?view=azloc-2610 | | Collect support logs from Azure Local SFF devices | https://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-collect-system-logs?view=azloc-2610 | | Review known issues and limitations for Azure Local small form factor | https://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-known-issues?view=azloc-2610 | | Troubleshoot Azure Local small form factor deployments | https://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-troubleshoot?view=azloc-2610 | | Troubleshoot Azure Local 23H2 solution updates | https://learn.microsoft.com/en-us/azure/azure-local/update/update-troubleshooting-23h2?view=azloc-2610 | | Troubleshoot Azure Local upgrade issues | https://learn.microsoft.com/en-us/azure/azure-local/upgrade/troubleshoot-upgrade-to-23h2?view=azloc-2610 | ### Best Practices | Topic | URL | |-------|-----| | Prepare network and machines for rack aware cluster deployment | https://learn.microsoft.com/en-us/azure/azure-local/deploy/rack-aware-cluster-deploy-prep?view=azloc-2610 | | Perform post-deployment tasks for rack aware clusters | https://learn.microsoft.com/en-us/azure/azure-local/deploy/rack-aware-cluster-post-deployment?view=azloc-2610 | | Optimize availability and performance for Azure Local SDN | https://learn.microsoft.com/en-us/azure/azure-local/manage/optimize-sdn-availability-performance?view=azloc-2610 | | Use supported operations for Azure Local Arc VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/virtual-machine-operations?view=azloc-2610 | | Use supported operations for Azure Local multi-rack Arc VMs | https://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-virtual-machine-operations?view=azloc-2610 | | Apply best practices for managing Azure Local updates | https://learn.microsoft.com/en-us/azure/azure-local/update/update-best-practices?view=azloc-2610 | ### Decision Making | Topic | URL | |-------|-----| | Compare Azure Local VM management capabilities | https://learn.microsoft.com/en-us/azure/azure-local/concepts/compare-vm-management-capabilities?view=azloc-2610 | | Decide between Azure Local and Windows Server | https://learn.microsoft.com/en-us/azure/azure-local/concepts/compare-windows-server?view=azloc-2610 | | Plan Network Controller VM deployment on Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/concepts/plan-network-controller-deployment?view=azloc-2610 | | Plan SDN infrastructure for Azure Local 23H2 | https://learn.microsoft.com/en-us/azure/azure-local/concepts/plan-software-defined-networking-infrastructure-23h2?view=azloc-2610 | | Choose SDN management options on Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/concepts/sdn-overview?view=azloc-2610 | | Plan workload-level disaster recovery on Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-workloads-resiliency?view=azloc-2610 | | Plan control plane and workload updates in disconnected Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-plan-updates?view=azloc-2610 | | Plan post-restore rehydration for disconnected Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-post-restore-overview?view=azloc-2610 | | Choose migration options for VMs to Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/migrate/migration-options-overview?view=azloc-2610 | | Evaluate Azure Local disaggregated deployment options | https://learn.microsoft.com/en-us/azure/azure-local/overview/disaggregated-overview?view=azloc-2610 | | Select a disaggregated network pattern for Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/plan/choose-network-pattern-disaggregated?view=azloc-2610 | | Choose the right Azure Local deployment type | https://learn.microsoft.com/en-us/azure/azure-local/plan/find-your-deployment-type?view=azloc-2610 | | Select Azure Local deployment scale options | https://learn.microsoft.com/en-us/azure/azure-local/scalability-deployments?view=azloc-2610 | | Select connectivity mode for Azure Local SFF devices | https://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/connectivity-modes?view=azloc-2610 | | Choose container orchestrator for Azure Local SFF | https://learn.microsoft.com/en-us/azure/azure-local/small-form-factor/small-form-factor-container-orchestrators?view=azloc-2610 | | Validate Azure Local solution upgrade readiness | https://learn.microsoft.com/en-us/azure/azure-local/upgrade/validate-solution-upgrade-readiness?view=azloc-2610 | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Use external SAN storage with Azure Local workloads | https://learn.microsoft.com/en-us/azure/azure-local/concepts/external-storage-support?view=azloc-2610 | | Design rack-aware AKS node placement on Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/concepts/rack-aware-cluster-aks-nodes?view=azloc-2610 | | Use network reference patterns for rack aware clusters | https://learn.microsoft.com/en-us/azure/azure-local/concepts/rack-aware-cluster-reference-architecture?view=azloc-2610 | | Design room-to-room connectivity for rack aware clusters | https://learn.microsoft.com/en-us/azure/azure-local/concepts/rack-aware-cluster-room-to-room-connectivity?view=azloc-2610 | | Design BGP Route Reflector topology for Azure Local SDN | https://learn.microsoft.com/en-us/azure/azure-local/concepts/route-reflector-overview?view=azloc-2610 | | Plan SDN Multisite topology and disaster recovery | https://learn.microsoft.com/en-us/azure/azure-local/concepts/sdn-multisite-overview?view=azloc-2610 | | Plan private endpoint connectivity for Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/deploy/about-private-endpoints?view=azloc-2610 | | Plan and configure local availability zones for Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/configure-local-availability-zones-disaggregated?view=azloc-2610 | | Plan infrastructure resiliency for Azure Local deployments | https://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-infrastructure-resiliency?view=azloc-2610 | | Design disaster recovery strategy for Azure Local VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-overview?view=azloc-2610 | | Design virtual machine resiliency on Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/disaster-recovery-vm-resiliency?view=azloc-2610 | | Plan disconnected operations architecture for Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-overview?view=azloc-2610 | | Load balance multiple SDN logical networks in Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/load-balance-multiple-networks?view=azloc-2610 | | Migrate Azure Local from public to private path connectivity | https://learn.microsoft.com/en-us/azure/azure-local/manage/move-public-path-to-private-path?view=azloc-2610 | | Select Azure Local network deployment patterns | https://learn.microsoft.com/en-us/azure/azure-local/plan/choose-network-pattern?view=azloc-2610 |