模块资料｜Kubernetes 持久化与 CSI
原图深度模块的结构化资料摘录，保留目标、知识、命令线索、风险、排障、练习与验收。它不是一张原子知识卡，也不是可直接执行的操作手册。
所属方向：数据库与存储。
目标
- 定位 PVC、挂载、扩容、快照与拓扑问题。
知识拆解
- PV/PVC/StorageClass
- dynamic provisioning
- CSI controller/node
- access mode
- topology/binding
- snapshot/clone
命令 / 配置 / 关键对象
以下是原图中的命令名、缩写或配置对象，并非经校验的完整命令行；其中可能含写操作。执行前必须补齐版本、权限、目标和风险。
- kubectl describe pvc/pv/pod
- VolumeAttachment
- CSI logs
- mount/findmnt
- storage metrics
高频故障与风险
- PVC Pending
- Multi-Attach
- mount timeout
- zone mismatch
- 扩容未完成
- stale attachment
排障路径
- PVC→PV→SC→CSI provisioner
- 调度拓扑→attach→mount
- 检查后端容量/权限
实战练习
- WaitForFirstConsumer
- 快照恢复与卷扩容
验收标准
- 有应用一致性方案
- 节点故障可恢复
- 容量告警提前于耗尽
对应优秀开源项目
继续拆卡的规则
本页是资料入口。只在形成一个能独立解释、带依据与边界的认识后，提炼为 Concept；故障观察进入 Troubleshooting，满足诊断条件的处置进入 Runbook，真实事件进入 Incident。