azure-aks-edge-essentials
About azure-aks-edge-essentials
azure-aks-edge-essentials is a guidance skill for agents working with Azure Kubernetes Service Edge Essentials and related AKS environments. It combines local references with remote documentation retrieval for deployment, operations, security, and troubleshooting.
Key features
- 01Cluster troubleshooting and diagnostics
- 02Deployment, upgrade, and configuration guidance
- 03Networking, storage, and capacity references
- 04Security and integration guidance
- 05Local reference with remote documentation fetching
Use cases
- 01Diagnosing cluster, node, or networking failures
- 02Planning disconnected or on-premises AKS environments
- 03Configuring secure clusters and workload integrations
MCP support
The skill recommends mcp_microsoftdocs:microsoft_docs_fetch to retrieve documentation, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-aks-edge-essentialsAfter installing, type/azure-aks-edge-essentialsin Claude Code to confirm it loaded.
Details
From the project READMEAzure Kubernetes Service Edge Essentials Skill
This skill provides expert guidance for Azure Kubernetes Service Edge Essentials. 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L71 | Diagnosing and fixing AKS Edge/Hybrid/Arc issues: cluster creation/upgrade failures, networking, storage, auth, encryption, logs, node health, and Azure Local/MetalLB/BGP problems. |
| Best Practices | L72-L80 | Guidance on resilient AKS Edge Essentials setups: availability sets, Azure Policy on Windows Server, restoring AKS Arc after VM failure, and upgrading AKS Arc clusters/Kubernetes versions. |
| Decision Making | L81-L89 | Guidance on AKS Edge/Hybrid deployment choices, pricing/licensing, trials, monitoring/logging options, and planning/operating disconnected or on-premises AKS environments. |
| Architecture & Design Patterns | L90-L96 | Designing AKS on Windows Server for Azure Local: high availability on two-node setups, SDN VNet architectures, and deployment patterns for AKS Arc target clusters. |
| Limits & Quotas | L97-L112 | System requirements, capacity planning, and scale/support limits for AKS Edge/Hybrid/Azure Local/Windows Server, including IP planning, VM sizes, and supported Kubernetes versions. |
| Security | L113-L141 | Securing AKS Edge/Hybrid/Arc: auth (Entra, AD, gMSA, SSO), RBAC, SSH hardening, cert and key management, etcd encryption, and container image validation. |
| Configuration | L142-L198 | Configuring AKS Edge/Hybrid/Arc clusters: networking, storage (CSI/NFS), load balancers, autoscaling, GPU, proxies, GitOps, offline/online updates, and cluster/node pool setup. |
| Integrations & Coding Patterns | L199-L214 | Integrations, APIs, and PowerShell for connecting AKS Edge/Hybrid to Arc, IoT/OPC/ONVIF, TPM, storage/backup, metrics, AI models, CSI plugins, and Key Vault secrets. |
| Deployment | L215-L228 | Deploying, upgrading, and maintaining AKS Arc/AKS on Azure Local clusters on Windows/Windows Server, including Terraform/ARM deployments, node pools, OS upgrades, and safe cluster lifecycle operations. |
Troubleshooting
Best Practices
| Topic | URL |
|---|---|
| Use availability sets to improve AKS workload resilience | https://learn.microsoft.com/en-us/azure/aks/aksarc/availability-sets |
| Apply Azure policy best practices to AKS on Windows Server | https://learn.microsoft.com/en-us/azure/aks/aksarc/policy-guidance |
| Restore AKS Arc clusters after management VM failure | https://learn.microsoft.com/en-us/azure/aks/aksarc/restore-aks-cluster |
| Upgrade AKS Arc workload clusters with PowerShell | https://learn.microsoft.com/en-us/azure/aks/aksarc/upgrade |
| Upgrade AKS Arc Kubernetes version via Admin Center | https://learn.microsoft.com/en-us/azure/aks/aksarc/upgrade-kubernetes |
Decision Making
| Topic | URL |
|---|---|
| Understand AKS Edge Essentials pricing and licensing options | https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-edge-pricing |
| Choose monitoring and logging options for AKS Hybrid | https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-monitor-logging |
| Choose between AKS cloud, edge, and on-premises | https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-platforms-compare |
| Plan and manage disconnected AKS on Azure Local | https://learn.microsoft.com/en-us/azure/aks/aksarc/disconnected-operations-aks |
| Evaluate AKS on Windows Server pricing and trials | https://learn.microsoft.com/en-us/azure/aks/aksarc/pricing |
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Understand AKS on Windows Server availability on two-node Azure Local | https://learn.microsoft.com/en-us/azure/aks/aksarc/deploy-cluster-on-two-node-hci |
| Deploy AKS Arc target clusters across SDN VNets | https://learn.microsoft.com/en-us/azure/aks/aksarc/deploy-target-clusters-virtual-networks |
| Architect AKS on Windows Server with SDN virtual networking | https://learn.microsoft.com/en-us/azure/aks/aksarc/software-defined-networking |