openclaw-workspace

生产环境安全提示

本文档包含可直接执行的运维命令。执行前请确认：当前目标集群与 Namespace 是否正确；是否具备足够的 RBAC 权限；是否已在非生产环境验证。命令风险等级标注：🔴 高风险（可能造成数据丢失或服务中断）、🟡 中风险（会修改集群状态，但通常可回滚）、🟢 低风险/只读（信息收集，无副作用）。

title: K8S 运维诊断技能库 description: [[kubernetes|Kubernetes]] 运维诊断全栈技能库，涵盖 Pod/Node/Network/Storage/Performance 五大故障域的结构化 SOP category: ai-agent tags:

• ai
• agent
• llm
• rag
• multi-agent
• [[etcd|etcd]]
• apiserver
• [[kubelet|kubelet]]
• [[prometheus|prometheus]]
• coredns last_updated: 2026-04 difficulty: advanced reading_level: advanced audience:
• AI 工程师
• 架构师
• SRE estimated_read_time: 5min intent_queries:
• K8S 运维诊断技能库 是什么
• 如何 K8S 运维诊断技能库 trigger_keywords:
• K8S
• 运维诊断技能库
• ai
• agent authors:
• name: KUDIG Team role: contributor k8s_versions:
• '1.28'
• '1.29'
• '1.30'
• '1.31'
• '1.32'

---

K8S 运维诊断技能库

1. 技能覆盖范围

技能域全景:

├── Pod 故障域
│   ├── Pending（调度失败）
│   ├── CrashLoopBackOff（崩溃循环）
│   ├── OOMKilled（内存溢出）
│   ├── ImagePullBackOff（镜像拉取失败）
│   ├── Error / Unknown（其他异常）
│   └── Evicted（被驱逐）
│
├── Node 故障域
│   ├── NotReady（节点不就绪）
│   ├── MemoryPressure / DiskPressure / PIDPressure
│   ├── NetworkUnavailable
│   └── SchedulingDisabled
│
├── Network 故障域
│   ├── Service 不通
│   ├── DNS 解析失败
│   ├── Pod 间通信异常
│   ├── Ingress 不可达
│   └── NetworkPolicy 拦截
│
├── Storage 故障域
│   ├── PVC Pending
│   ├── 挂载失败
│   └── CSI 驱动异常
│
└── Performance 故障域
    ├── API Server 延迟高
    ├── etcd 延迟高
    ├── 调度延迟
    └── 网络延迟

2. Pod 故障诊断 SOP

2.1 Pod Pending

触发条件: Pod 状态为 Pending 超过 30 秒

# 🟢 低风险：只读/信息收集，通常无副作用
# Step 1: 确认状态
kubectl get pod <pod> -n <ns> -o wide

# Step 2: 查看事件（关键！事件中有调度失败原因）
kubectl describe pod <pod> -n <ns> | tail -20
kubectl get events -n <ns> --field-selector involvedObject.name=<pod> --sort-by=.lastTimestamp

# Step 3: 根据事件分支诊断

事件关键词	根因	修复方向
Insufficient cpu/memory	节点资源不足	扩容节点 / 调整 requests
node(s) didn't match selector	NodeSelector 不匹配	检查标签 / 修改选择器
node(s) had taint	Taint/Toleration 不匹配	添加 Toleration / 移除 Taint
persistentvolumeclaim not found	PVC 未绑定	检查 PVC 状态和 StorageClass
Unschedulable	节点不可调度	检查节点 SchedulingDisabled
pod has unbound immediate PVC	PVC 立即绑定未就绪	等待 PVC Ready 或检查 PV