/azure-stack-edge

name: azure-stack-edge
description: Expert knowledge for Azure Stack Edge development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying IoT Edge modules, GPU/Kubernetes apps, DeepStream workloads, Arc GitOps, or local ARM integrations, and other Azure Stack Edge related development tasks. Not for Azure IoT Edge (use azure-iot-edge), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Kubernetes Service Edge Essentials (use azure-aks-edge-essentials), Azure Local (use azure-local).
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 Stack Edge Skill

This skill provides expert guidance for Azure Stack Edge. Covers troubleshooting, best practices, decision making, 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 | L36-L88 | Diagnosing and fixing Azure Stack Edge/Data Box Gateway issues: release-specific known problems, alerts, ordering, activation, certificates, ARM/blob/IoT/VM/GPU errors, and using diagnostics/logs. | | Best Practices | L89-L94 | Best practices for Azure Stack Edge Pro: device failure recovery, GPU sharing/partitioning guidance, and operational guidelines for deployment, monitoring, and maintenance. | | Decision Making | L95-L103 | Guidance on region and data-location choices, resiliency behavior, disconnected deployment planning, and processes for replacing Azure Stack Edge devices. | | Limits & Quotas | L104-L116 | Limits, capacities, performance, and system requirements for Azure Stack Edge and Data Box Gateway devices, including supported VM sizes, GPU limits, and cross-subscription resource moves. | | Security | L117-L143 | Securing Azure Stack Edge: user access, certificates/TLS, Key Vault secrets, VPN/BCDR, encryption, secure wipe, Kubernetes RBAC, and built-in security features/policies. | | Configuration | L144-L196 | Configuring and managing Azure Stack Edge/Data Box Gateway devices: networking, power, storage, Kubernetes/VMs, GPUs, monitoring, automation, and hardware/system requirements. | | Integrations & Coding Patterns | L197-L208 | How to deploy and integrate workloads on Azure Stack Edge: IoT Edge modules, GPU-sharing/Kubernetes apps, DeepStream, Arc/Kubernetes GitOps, and connecting to local ARM. | | Deployment | L209-L212 | Predeployment requirements and planning for Azure Stack Edge Pro GPU, including hardware, networking, certificates, capacity, and environment checks before deployment. |

Troubleshooting

| Topic | URL | |-------|-----| | Troubleshoot Azure Edge Hardware Center ordering issues | https://learn.microsoft.com/en-us/azure/azure-edge-hardware-center/azure-edge-hardware-center-troubleshoot-order | | Azure Data Box Gateway 1905 GA release known issues | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-1905-release-notes | | Azure Data Box Edge and Gateway 1906 release issues | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-1906-release-notes | | Azure Stack Edge and Data Box Gateway 1911 release issues | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-1911-release-notes | | Azure Stack Edge and Data Box Gateway 2007 release issues | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2007-release-notes | | Azure Data Box Gateway 2101 release known issues and workarounds | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2101-release-notes | | Azure Data Box Gateway 2105 release known issues and fixes | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2105-release-notes | | Azure Data Box Gateway 2301 release issues and fixes | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2301-release-notes | | Apply Azure Data Box Gateway 2409 release notes to diagnose problems | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2409-release-notes | | Use Azure Data Box Gateway 2610 release notes for issue resolution | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2610-release-notes | | Azure Data Box Gateway general availability release notes | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-release-notes | | Troubleshoot Azure Data Box Gateway using diagnostics and logs | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-troubleshoot | | Interpret and respond to Azure Stack Edge alerts | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-alerts | | Review critical issues for Azure Stack Edge preview | https://learn.m