跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
安全

azure-aks-edge-essentials

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, Windows Server nodes, IoT/OPC/ONVIF, or TPM workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Container Apps (use azure-container-apps), Azure Red Hat OpenShift (use azure-redhat-openshift), Azure Stack Edge (use azure-stack-edge).

MicrosoftDocs · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add MicrosoftDocs/Agent-Skills --skill azure-aks-edge-essentials

技能说明


name: azure-aks-edge-essentials description: Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, Windows Server nodes, IoT/OPC/ONVIF, or TPM workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Container Apps (use azure-container-apps), Azure Red Hat OpenShift (use azure-redhat-openshift), Azure Stack Edge (use azure-stack-edge). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-08-31" generator: "docs2skills/1.0.0"

Azure 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), 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

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

CategoryLinesDescription
TroubleshootingL37-L71Diagnosing and fixing AKS Edge/Hybrid/Arc issues: cluster creation/upgrade failures, networking, storage, auth, encryption, logs, node health, and control plane/etcd/kubelet problems.
Best PracticesL72-L80Guidance 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 MakingL81-L89Guidance on AKS Edge/Hybrid deployment choices, pricing/licensing, trials, monitoring/logging options, and planning/operating disconnected or on-premises AKS environments.
Architecture & Design PatternsL90-L96Designing 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 & QuotasL97-L112Hardware, scale, IP capacity, Kubernetes version, and support limits for AKS Edge/Hybrid, Azure Local, bare metal, and Windows Server deployments
SecurityL113-L141Securing AKS Edge/Hybrid/Arc: auth (Entra, AD, gMSA, SSO), RBAC, SSH hardening, cert and key management, workload identity, container image validation, and security bulletins.
ConfigurationL142-L198Configuring AKS Edge/Hybrid/Arc clusters: networking, storage, load balancers, GPU, autoscaling, proxies, Arc connectivity, templates/Bicep, and update/installation settings.
Integrations & Coding PatternsL199-L214Integrations, 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.
DeploymentL215-L228Deploying, upgrading, and safely managing AKS Arc/AKS on Azure Local clusters and Windows node pools, including Terraform/ARM deployments, OS/Kubernetes upgrades, and workload migration.

Troubleshooting

TopicURL
Run AKS Arc diagnostic checker for cluster failureshttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-arc-diagnostic-checker
Resolve AKS Arc Kubernetes image not ready issueshttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-arc-image-not-ready
Resolve known AKS Arc hybrid and edge issueshttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-arc-known-issues
Validate and troubleshoot AKS Edge secret encryptionhttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-edge-howto-secret-encryption
Collect and use AKS Edge Essentials logs for troubleshootinghttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-edge-resources-logs
Diagnose and resolve common AKS Edge Essentials issueshttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-edge-troubleshoot-overview
Collect and analyze kubelet logs on AKS Hybrid nodeshttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-get-kubelet-logs
Troubleshoot common issues in AKS Hybrid and Edgehttps://learn.microsoft.com/en-us/azure/aks/aksarc/aks-troubleshoot
Fix AKS cluster creation failures after Azure Local upgradehttps://learn.microsoft.com/en-us/azure/aks/aksarc/cluster-create-fails-after-azure-local-upgrade
Resolve K8sVersionValidation errors for AKS on Azure Localhttps://learn.microsoft.com/en-us/azure/aks/aksarc/cluster-k8s-version
Recover AKS Hybrid cluster unhealthy after upgradehttps://learn.microsoft.com/en-us/azure/aks/aksarc/cluster-unhealthy-after-kubernetes-upgrade
Unstick AKS Hybrid cluster upgrades stuck in Upgrading statehttps://learn.microsoft.com/en-us/azure/aks/aksarc/cluster-upgrade-status
Troubleshoot BGP with FRR and MetalLB in AKS Archttps://lear
阅读完整来源 ↗