azure-local

What this skill does

# 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-L75 | Diagnosing and fixing Azure Local deployment, SDN/NSG, Arc-enabled VM, health, logging, upgrade, migration, and known-issues across connected and disconnected environments. |
| Best Practices | L76-L85 | Guidance on networking, rack-aware deployment prep, metric alerts, and supported VM/update operations to keep Azure Local clusters healthy, compliant, and manageable. |
| Decision Making | L86-L99 | Guidance for planning Azure Local deployments: choosing VM models, migration paths, storage, networking, private endpoints, billing, scale, edge orchestrators, and upgrade strategies. |
| Architecture & Design Patterns | L100-L128 | Designing resilient Azure Local architectures: SDN topologies, rack-aware and disconnected network patterns, load balancing, Fibre Channel layouts, and VM/cluster disaster recovery planning |
| Limits & Quotas | L129-L133 | Arc-enabled VM scale, capacity, and resource limits in Azure Local, including max VMs, operations, and constraints for planning and managing deployments. |
| Security | L134-L180 | Security and compliance guidance for Azure Local: identity/RBAC, certificates/PKI, NSGs/firewalls, BitLocker, Defender, logging, and mappings to standards like FedRAMP, HIPAA, ISO, and PCI. |
| Configuration | L181-L300 | Configuring and operating Azure Local: networking, storage, GPUs, SDN, monitoring, alerts, updates, availability zones, migrations, multi-rack, disconnected use, and Arc/VM lifecycle management. |
| Integrations & Coding Patterns | L301-L324 | VM image prep and migration patterns, external SAN and storage integration, and connecting/migrating VMs (Azure, VMware, Hyper-V) to Azure Local using SSH/RDP, Arc, and automation tools. |
| Deployment | L325-L368 | End-to-end guidance for deploying, updating, and migrating Azure Local/Stack HCI environments, including SDN, disconnected setups, small form factor, and workload-specific (SQL, containers, VMs) scenarios. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Troubleshoot SDN on Azure Local with Arc | https://learn.microsoft.com/en-us/azure/azure-local/concepts/sdn-frequently-asked-questions?view=azloc-2605 |
| Validate rack aware cluster readiness using LLDP validator | https://learn.microsoft.com/en-us/azure/azure-local/deploy/rack-aware-cluster-readiness-check?view=azloc-2605 |
| Troubleshoot simplified machine provisioning for Azure Local (preview) | https://learn.microsoft.com/en-us/azure/azure-local/deploy/troubleshoot-simplified-machine-provisioning?view=azloc-2605 |
| Resolve common Azure Local deployment and connectivity issues | https://learn.microsoft.com/en-us/azure/azure-local/faq?view=azloc-2605 |
| Resolve known issues in Azure Local releases | https://learn.microsoft.com/en-us/azure/azure-local/known-issues?view=azloc-2605 |
| Collect 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-2605 |
| Collect and upload Azure Local diagnostic logs to Microsoft | https://learn.microsoft.com/en-us/azure/azure-local/manage/collect-logs?view=azloc-2605 |
| Use appliance fallback logging for Azure Local disconnected VMs | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-fallback?view=azloc-2605 |
| Review known issues for Azure Local disconnected operations | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-known-issues?view=azloc-2605 |
| Collect on-demand logs with PowerShell for Azure Local disconnected | https://learn.microsoft.com/en-us/azure/azure-local/manage/disconnected-operations-on-demand-logs?view=azloc-2605 |
| Use drift detection to diagnose Azure Local configuration issues | https://learn.microsoft.com/en-us/azure/azure-local/manage/drift-detection?view=azloc-2605 |
| Track and understand Health Service actions in Azure Local | https://learn.microsoft.com/en-us/azure/azure-local/manage/health-service-actions?view=azloc-2605 |
| Interpret and resolve Azure Local Health Service faults | https://learn.microsoft.com/en-us/azure/azure-local/manage/health-service-faults?view=azloc-2605 |
| Use AKS Arc Support Tool to remediate Azure Local infrastructure issues | https://learn.microsoft.com/en-us/azure/azure-local/manage/remediate-support-tool-infrastructure?view=azloc-2605 |
| 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-2605 |
| Collect SDN logs on Azure Local for support | https://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-log-collection?view=azloc-2605 |
| Troubleshoot Azure Local SDN and NSG connectivity issues | https://learn.microsoft.com/en-us/azure/azure-local/manage/sdn-troubleshooting?view=azloc-2605 |
| Run Azure Local Support Diagnostic Tool for issue resolution | https://learn.microsoft.com/en-us/azure/azure-local/manage/support-tools?view=azloc-2605 |
| Troubleshoot Azure Local Arc-enabled virtual machines | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-arc-enabled-vms?view=azloc-2605 |
| Collect traces and logs for common SDN issues | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-common-sdn-issues?view=azloc-2605 |
| Troubleshoot Azure Local registration failures in Configurator app | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-deployment-configurator-app?view=azloc-2605 |
| Troubleshoot Azure Local deployment validation issues via Azure portal | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-deployment?view=azloc-2605 |
| Troubleshoot SDN deployment via Windows Admin Center | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-sdn-deployment?view=azloc-2605 |
| Troubleshoot SDN Software Load Balancer data path | https://learn.microsoft.com/en-us/azure/azure-local/manage/troubleshoot-software-load-balancer?view=azloc-2605 |
| Unregister and re-register Azure Local machines safely | https://learn.microsoft.com/en-us/azure/azure-local/manage/unregister-register-machine?view=azloc-2605 |
| Troubleshoot Azure Local VM migrations with Azure Migrate | https://learn.microsoft.com/en-us/azure/azure-local/migrate/migrate-troubleshoot?view=azloc-2605 |
| Resolve Azure Local migration known issues | https://learn.microsoft.com/en-us/azure/azure-local/migrate/migration-known-issues?view=azloc-2605 |
| Troubleshoot Azure Local multi-rack Arc-enabled VMs | https://learn.microsoft.com/en-us/azure/azure-local/multi-rack/multi-rack-troubleshoot-arc-enabled-vms?view