C✳CODEZ.WIN
🌐 简体中文

Skill 多语言阅读指南

aks-troubleshooting用途、用法与原始来源

使用只读、证据优先的调查方式调试实时 Azure Kubernetes 服务 (AKS) 事件。适用场景:Pod 崩溃或处于 Pending 状态、CrashLoopBackOff、OOMKilled、ImagePullBackOff、节点 NotReady、DNS 或入口故障、连接超时、网络策略、SNAT 耗尽、节点池扩展因 QuotaExceeded 或 InsufficientVCPUQuota 而受阻、升级卡住、竞价型实例或区域中断、裸 VMExtensionProvisioningError 或 AllocationFailed 包装器、未编目的容量症状,或“调查我的 AKS 集群”。请勿用于:数据包捕获(请使用 aks-network-capture);GPU 或模型服务问题(请使用 aks-gpu-inference);集群创建或配置(请使用 azure-kubernetes);成本分析(请使用可选的 azure-cost 插件中的 cost-analysis);Pod 大小调整(请使用 azure-kubernetes)。完整的、包含所有必需嵌套限定符的、有文档记录的 AKS 签名(使用 aks-known-issues);非 AKS Azure 资源上的独立故障(使用 azure-diagnostics)。未限定的错误和未解决的事件仅保留在此处,且仅适用于 AKS。

原文采集时间:

来源仓库
microsoft/skills
SKILL.md
.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md
仓库 Star
3,157
仓库最近更新
2026/10/31
能力分类
工具集成
最近采集时间

许可:许可文件待核验

流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill,不属于实测评测。

下面的用途和操作片段来自上游文档,由本站整理并翻译,和另行标注的 Codez 编辑分析分开展示。

这个 Skill 能做什么

使用只读、证据优先的调查方式调试实时 Azure Kubernetes 服务 (AKS) 事件。适用场景:Pod 崩溃或处于 Pending 状态、CrashLoopBackOff、OOMKilled、ImagePullBackOff、节点 NotReady、DNS 或入口故障、连接超时、网络策略、SNAT 耗尽、节点池扩展因 QuotaExceeded 或 InsufficientVCPUQuota 而受阻、升级卡住、竞价型实例或区域中断、裸 VMExtensionProvisioningError 或 AllocationFailed 包装器、未编目的容量症状,或“调查我的 AKS 集群”。请勿用于:数据包捕获(请使用 aks-network-capture);GPU 或模型服务问题(请使用 aks-gpu-inference);集群创建或配置(请使用 azure-kubernetes);成本分析(请使用可选的 azure-cost 插件中的 cost-analysis);Pod 大小调整(请使用 azure-kubernetes)。完整的、包含所有必需嵌套限定符的、有文档记录的 AKS 签名(使用 aks-known-issues);非 AKS Azure 资源上的独立故障(使用 azure-diagnostics)。未限定的错误和未解决的事件仅保留在此处,且仅适用于 AKS。

如何使用:上游操作流程

AKS故障排除

利用只读、证据优先的调查方法,对实时发生的 AKS 事件进行根本原因分析。这项技能涵盖了全天的所有环节。2故障排除界面——工作负载、节点、网络、入口、升级和spot/zone中断——并生成结构化的事件报告。

原文片段 · L10 ↗

操作规则

默认情况下为只读。除非用户明确要求进行修复,否则请勿重启、删除、隔离、排空、扩展、升级或重新配置任何资源。收集证据,找出根本原因,并提出修复方案——但不要未经请求就实施修复。先有证据,后有结论。不要在没有引用支持证据的情况下陈述根本原因。“Pod 处于 Pending 状态”和“节点未就绪”是症状,而非原因——请将其追溯到特定的选择器、污染、耗尽的资源或 Azure 端状况。

原文片段 · L14 ↗

按症状诊断

对于节点池扩容或配额故障,负载node-issues.md在诊断或提出所有者行动建议之前,其配额部分定义了所需的操作证据、层级区分、计算方法和审批范围;不要仅凭一般的配额知识来回答问题。references/symptom-map.md是最快的路径:17症状部分,每个部分都是一个独立的、包含确切信息的模块。kubectl/az要运行的命令以及常见原因。如果症状明显,请先从这里入手;如需深入调查,请使用上面的主题文件。

原文片段 · L44 ↗

环境与依赖

本次未从该文件选出独立的环境要求片段,不代表无需依赖。请继续核对仓库的安装说明和引用文件。

限制与结果检查

本次未从该文件选出独立的限制片段,不代表适用于所有输入或环境。请阅读完整原文,并自行验证实际结果。

开始使用前

  1. 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档,只复制 SKILL.md 可能漏掉依赖。
  2. 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境,本站不假定存在通用的安装命令。
  3. 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作,应逐项核对后再授权。
  4. 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高,都不能证明结果正确。

Skill 文件与目录格式规范 ↗

继续阅读原始文档

翻译与介绍范围

本页从固定版本的上游 SKILL.md 整理用途与操作片段,译文使用辅助翻译。它不是完整手册,也不代表经过兼容性实测;使用前请核对原文及其引用文件。

介绍依据下方列出的固定版本;当前仓库动态和目录采集时间单独展示。

固定版本来源
阅读原文 ↗
原文采集时间
来源提交版本
00d66a64919edca5bca2c673373444e36a4b5461
原文 SHA-256
fdf30800f2ce84a13ea3c126c8f6e00ed88123d400596a78c6a2e63f173e9dbc
返回完整 Skill 目录