容器与云原生 / 系统课时

理解 CSI 对象与能力声明

理解 CSI 对象与能力声明

看到 CSIDriver 并不等于驱动已在每个节点注册,也不等于所有 CSI RPC 都受支持。本课把 CSIDriver、CSINode、CSIStorageCapacity 与 CSI 协议能力查询分层阅读,帮助你判断“集群声明了什么、节点注册了什么、哪里具备供给容量、实际支持哪些调用”。

学习目标

  • 读懂 CSIDriver、CSINode 与 CSIStorageCapacity 分别回答的问题。
  • 根据节点注册、拓扑和容量对象判断动态供给所需条件。
  • 区分 Kubernetes API 声明与 ControllerGetCapabilities、NodeGetCapabilities 返回的真实 RPC 能力。

把支持范围拆成四层

CSI 的“支持”至少包含四层:集群级集成策略、节点级注册、拓扑容量信息和 CSI RPC 能力。只检查其中一层容易得出错误结论,例如集群存在 CSIDriver,但目标 Node 的 CSINode 没有该驱动;或者节点已经注册,却没有启用容量感知调度。

CSI 对象与能力声明关系

用 CSIDriver 读集群级声明

CSIDriver 是非命名空间对象,名称应与 CSI 驱动通过 GetPluginInfo 返回的插件名一致。它描述 Kubernetes 应如何集成该驱动,而不是驱动当前是否健康。排障时重点关注 attachRequired、storageCapacity、podInfoOnMount 和 volumeLifecycleModes:它们分别影响 Attach 流程、容量感知调度、传给 NodePublishVolume 的 Pod 信息,以及 Persistent/Ephemeral 生命周期模式。

下面一次查看三类对象。将 DRIVER 替换成目标 PV 的 spec.csi.driver:

bash
DRIVER='<VALUE>'

kubectl get csidriver "$DRIVER" -o custom-columns='NAME:.metadata.name,ATTACH_REQUIRED:.spec.attachRequired,STORAGE_CAPACITY:.spec.storageCapacity,POD_INFO:.spec.podInfoOnMount,LIFECYCLE_MODES:.spec.volumeLifecycleModes'
kubectl get csinode -o custom-columns='NODE:.metadata.name,DRIVERS:.spec.drivers[*].name,NODE_IDS:.spec.drivers[*].nodeID,TOPOLOGY_KEYS:.spec.drivers[*].topologyKeys,MAX_VOLUMES:.spec.drivers[*].allocatable.count'
kubectl get csistoragecapacity -A -o custom-columns='NAMESPACE:.metadata.namespace,STORAGE_CLASS:.storageClassName,CAPACITY:.capacity,MAX_VOLUME_SIZE:.maximumVolumeSize,NODE_TOPOLOGY:.nodeTopology'

预期输出

text
NAME      ATTACH_REQUIRED   STORAGE_CAPACITY   POD_INFO   LIFECYCLE_MODES
<VALUE>   <VALUE>           <VALUE>            <VALUE>    <VALUE>
NODE      DRIVERS           NODE_IDS           TOPOLOGY_KEYS   MAX_VOLUMES
<VALUE>   <VALUE>           <ID>               <VALUE>         <VALUE>
NAMESPACE   STORAGE_CLASS   CAPACITY   MAX_VOLUME_SIZE   NODE_TOPOLOGY
<VALUE>     <VALUE>         <VALUE>    <VALUE>           <VALUE>

不同驱动可能省略可选字段,因此空值必须结合 API 默认值和驱动部署配置解释,不能机械地视为“不支持”。这里 CSIStorageCapacity 的命名空间来自 .metadata.namespace,StorageClass 名称来自 .storageClassName;两列必须独立读取,不能把 custom-columns 路径拼接在一起。

用 CSINode 判断节点实际注册

CSINode 与 Kubernetes Node 同名,记录该节点已经向 kubelet 注册的 CSI 驱动。每个 spec.drivers[] 条目把 Kubernetes 节点映射到存储系统使用的 nodeID;topologyKeys 指定 Kubernetes 应从 Node 标签读取哪些拓扑维度;allocatable.count 存在时,可用于限制该驱动在该节点上可使用的唯一卷数量。

因此,“集群里有 CSIDriver”只能证明 Kubernetes 知道这个驱动;“目标节点的 CSINode 包含相同 driver name”才证明该节点上的插件已完成注册。若目标节点缺少条目,应优先检查 CSI Node DaemonSet、node-driver-registrar、插件 socket 和节点选择规则,而不是先怀疑 PVC。

用 CSIStorageCapacity 判断可供给容量

CSIStorageCapacity 描述某个 StorageClass 在特定 nodeTopology 范围内可用于新卷动态供给的容量信息。它主要服务于延迟绑定:CSIDriver.spec.storageCapacity=true、StorageClass 使用 WaitForFirstConsumer,并且 Pod 需要动态供给新卷时,调度器可据此判断某个拓扑位置是否有足够容量满足 PVC 请求。

它不是“现有 PV 还剩多少空间”的监控对象,也不能证明一个已创建卷能成功 Mount。排查动态供给时,应同时核对 StorageClass、PVC 请求容量、候选节点拓扑以及对应的 CSIStorageCapacity;若容量信息与请求不匹配,调度器可能无法把该拓扑位置视为可供给位置。

不要把 Kubernetes 对象当成 RPC 能力清单

CSI 插件还会通过协议自身的能力查询声明可调用操作。Controller 侧例如 PUBLISH_UNPUBLISH_VOLUME 表示支持 ControllerPublishVolume 和 ControllerUnpublishVolume;Node 侧的 STAGE_UNSTAGE_VOLUME 表示支持 NodeStageVolume 和 NodeUnstageVolume。这些能力分别通过 ControllerGetCapabilities、NodeGetCapabilities 查询,而 GetPluginCapabilities 用于插件级能力协商;它们不会完整展开到 CSIDriver 或 CSINode 中。

判断实际支持范围时,应合并四层证据:先用 CSIDriver 看 Kubernetes 集成策略,再用目标 CSINode 确认节点注册;涉及延迟动态供给时,再用 CSIStorageCapacity 检查拓扑容量;最后通过驱动日志、sidecar 探测结果或驱动提供的诊断方式确认 CSI RPC 能力。只有这些证据相互吻合,才能把“对象存在”提升为“该工作负载具备所需存储能力”的结论。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 CSI 对象与能力声明

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通