k8s-chaos-skills

name	k8s-chaos-skills
description	CNI IP 耗尽注入 — 自动计算副本数，精确耗尽目标节点 IP 而不触发 OutOfpods。参数: --namespace <ns> --node <node> --kubeconfig <path> Use when this capability is needed.

K8s 故障演练

意图识别 ──→ 用例选择 ──→ 用例执行
(提取四维度)  (决策树匹配)  (读取文件并按步骤执行)

安全红线

以下规则优先级高于一切操作指令，在任何步骤中都不得违反：

• 隔离：在隔离命名空间或测试集群演练，严禁在生产核心链路注入
• 最小影响：用精确标签选择器定位目标，范围尽可能小
• 可回滚：注入前明确回滚方案，确保 30 秒内可恢复
• 有监控：无监控不演练
• 仅限已有用例：只能执行 references/catalogue/ 中已有的故障注入用例，严禁自行编造、拼凑或即兴发挥用例中未涉及的故障注入操作。无法匹配时必须明确告知用户「当前不支持该场景」并停止
• 禁止：业务高峰期演练 / 对 etcd、kube-apiserver 等控制平面注入 / 无备份对 StatefulSet 做破坏性实验

---

第一步：意图识别

从用户输入中提取四个维度：

维度	说明	示例
故障层级	作用在哪个层面	Pod / Workload / Service / Node
故障现象	期望模拟的表现	Pending、OOM、CPU 高
故障原因	具体根因	资源不足、配置错误
目标应用	注入目标	应用名、命名空间
kubeconfig	集群凭证路径	~/.kube/config

层级判断关键词：

关键词	层级
pod、容器、崩溃、重启、OOM、CPU高、内存高、镜像、挂载、磁盘空间、磁盘IO	Pod
副本、deployment、扩容、缩容	Workload
service、服务发现、负载均衡、端口、endpoints	Service
节点、node、磁盘、宿主机	Node

信息不全时的处理：

• 用户明确说出故障现象 → 直接进入第二步
• 用户只说大致目标（如「测试容错」） → 提问引导确认四个维度
• 用户描述生产问题要复现 → 从描述提取现象和原因，匹配用例
• 匹配到多个用例 → 列出候选，让用户选择
• 只说了现象没说根因 → 推荐该分类下最常见的用例，并列出其他选项
• 不在覆盖范围 → 明确告知「当前不支持该场景」，停止操作，严禁自行构造用例外的故障注入

---

第二步：用例选择（动态发现）

所有用例存储在 references/catalogue/ 下，通过目录结构和文件命名规约自动发现，无需维护静态索引。

命名规约

references/catalogue/
├── <故障分类>/                         # 目录名 = 故障层级_故障现象（每个目录对应唯一的 Scope+Target+Action 组合）
│   ├── <故障分类>_<根因A>.md           # 文件名 = 分类名_具体根因
│   ├── <故障分类>_<根因B>.md
│   └── ...
└── ...

示例：

• references/catalogue/Pod_Pending/Pod_Pending_节点资源不足.md
• references/catalogue/Pod_磁盘空间使用率过高/Pod_磁盘空间使用率过高_应用日志数据积累.md（pod-disk fill）
• references/catalogue/Pod_磁盘IO过高/Pod_磁盘IO过高_异常IO占用.md（pod-disk burn）

发现流程

第 1 步：列出所有分类目录，匹配故障现象

ls references/catalogue/

从返回的目录名中，根据第一步识别的故障现象选择最匹配的目录。目录名本身已包含故障层级和故障现象信息（如 Pod_Pending、service_conditions状态异常、节点容器运行时磁盘使用率过高）。

第 2 步：列出该目录下所有用例文件，匹配根因

ls references/catalogue/<匹配的目录>/

从返回的文件名中，根据用户描述的根因选择最匹配的文件。文件名中 _ 后的部分即为该用例对应的根因。

• 如果用户明确了根因 → 直接选择对应文件
• 如果用户未说明根因 → 将文件列表展示给用户，让用户选择
• 如果没有匹配的文件 → 告知用户「当前不支持该场景」，停止操作

新增/删除用例

遵循命名规约即可，无需修改本文件：

• 新增用例：在对应分类目录下新建 <分类>_<根因>.md
• 新增分类：新建目录 <故障层级>_<故障现象>/，在其中添加用例文件
• 删除用例：直接删除对应 .md 文件

辅助脚本

• scripts/list_scenarios.py：一键列出所有已支持的演练场景（JSON 结构化输出），用于快速总览或对接外部系统 用法：execute_skill_script(skill_name="k8s-chaos-skills", script_name="list_scenarios.py")

---

第三步：用例执行

1. 读取 references/catalogue/<分类目录>/<用例文件>.md
2. 将用例中的占位符替换为用户实际参数（应用 A → 目标应用，<namespace> → 实际命名空间）
3. 所有 blade 和 kubectl 命令必须显式指定 --kubeconfig <路径>，使用第一步中用户确认的 kubeconfig 路径，禁止依赖默认值
4. 涉及 blade 命令时，查阅 references/chaosblade-commands.md 获取完整参数
5. 严格按用例中的 演练步骤 → 注入验证 → 注入恢复 → 恢复验证 顺序执行
6. 执行完毕后输出演练报告：

演练报告
- 用例：[决策树路径，如 Pod > Pending > 节点资源不足]
- 目标：[namespace/app-name]
- 注入结果：[成功/失败] + 观察到的现象
- 恢复结果：[成功/失败] + 是否符合基准事实
- 发现的问题与改进建议

---

Source: chaosblade-io/chaosblade — distributed by TomeVault.