容器与云原生 / 系统课时

识别 CSI Sidecar 组件职责

识别 CSI Sidecar 组件职责

CSI 驱动通常不是一个容器独自完成所有 Kubernetes 集成工作。本篇把常见 Sidecar 按“监听什么对象、调用什么 CSI RPC、部署在哪一侧”拆开,并给出一套现场核对方法,便于后续看到报错时直接定位应该检查的组件。

学习目标

  • 区分控制器侧 Sidecar 与节点侧 node-driver-registrar 的职责边界。
  • 把 PVC、VolumeAttachment、扩容和快照事件映射到对应 CSI RPC。
  • 通过 Pod 容器列表与 CSIDriver 对象确认集群实际启用了哪些能力。

从职责边界理解 Sidecar

CSI Driver 负责实现标准 CSI 服务,Sidecar 则承担 Kubernetes 适配逻辑:监听 API 对象,根据对象状态通过 Unix Domain Socket 调用驱动,再把结果写回 Kubernetes API。它们通常与驱动容器同 Pod 部署,但并非所有驱动都需要启用全部 Sidecar。

控制器侧 Sidecar 处理创建、附加、扩容、快照等集群级动作;节点侧的 node-driver-registrar 跟随 CSI Node Plugin 以 DaemonSet 方式运行,负责把驱动注册给 kubelet。注册完成后,真正的 NodeStageVolume、NodePublishVolume 等节点卷 RPC 由 kubelet 调用 CSI Node Driver。

CSI Sidecar 与驱动职责关系

五类组件分别负责什么

组件 主要监听对象或信号 关键 CSI 调用 典型位置
external-provisioner PVC 与 StorageClass CreateVolume、DeleteVolume Controller
external-attacher VolumeAttachment ControllerPublishVolume、ControllerUnpublishVolume Controller
external-resizer PVC 容量变更 ControllerExpandVolume Controller
external-snapshotter VolumeSnapshotContent CreateSnapshot、DeleteSnapshot、ListSnapshots Controller
node-driver-registrar kubelet 插件注册机制 GetPluginInfo 用于识别驱动;节点卷 RPC 由 kubelet 调用 Node

这里要特别避免把两个 RPC 名拼成一个不存在的调用:external-provisioner 创建卷时调用 CreateVolume,删除动态供应卷时调用 DeleteVolume。排障时应按这两个准确名称检索驱动日志。

external-snapshotter 不是完整的快照控制面。它通常与集群级 snapshot-controller 协作:snapshot-controller 处理快照 API 对象的控制逻辑,external-snapshotter 再把需要落到存储系统的动作转换为 CSI Snapshot RPC。

这里的 registrar 通常指 node-driver-registrar。现代驱动应在安装清单中直接提供所需的 CSIDriver 资源,而不是依赖已经淘汰的 cluster-driver-registrar 创建该对象。

用部署对象确认实际组件

先找出驱动的 Controller Pod 和任意一个 Node Plugin Pod,再查看容器名与 CSIDriver 配置。下面的占位符需要替换成集群中的实际值;不同厂商可能省略不需要的 Sidecar,容器名也可能有所不同。

bash
NAMESPACE="<NAMESPACE>"
CONTROLLER_POD="<CONTROLLER_POD>"
NODE_POD="<NODE_POD>"

kubectl -n "$NAMESPACE" get pod "$CONTROLLER_POD" -o jsonpath='{.spec.containers[*].name}'; echo
kubectl -n "$NAMESPACE" get pod "$NODE_POD" -o jsonpath='{.spec.containers[*].name}'; echo
kubectl get csidriver -o custom-columns=NAME:.metadata.name,ATTACH_REQUIRED:.spec.attachRequired,POD_INFO_ON_MOUNT:.spec.podInfoOnMount

预期输出(示例,实际组件以驱动能力和安装方式为准):

text
csi-provisioner csi-attacher csi-resizer csi-snapshotter <DRIVER_CONTAINER>
node-driver-registrar <DRIVER_CONTAINER>
NAME            ATTACH_REQUIRED   POD_INFO_ON_MOUNT
<DRIVER_NAME>   true              false

如果 attachRequired 为 false,Kubernetes 会跳过控制器附加阶段,因此该驱动通常不需要 external-attacher。反过来,看到某个 Sidecar 缺失也不能直接判定安装错误,应先确认驱动是否支持并声明了对应能力。

排障时按动作所有者找日志

供应失败先看 external-provisioner 与 CSI Controller Driver 的 CreateVolume;删除动态供应卷失败看 DeleteVolume;卷附加失败看 external-attacher、VolumeAttachment 和 ControllerPublishVolume;扩容失败看 external-resizer 与 ControllerExpandVolume;快照失败则同时检查 snapshot-controller、external-snapshotter 和驱动的快照 RPC。

节点挂载失败应把注意力转向 kubelet 与 CSI Node Driver。node-driver-registrar 的价值主要在于确认驱动是否成功注册、kubelet 能否发现注册 socket,它并不负责执行文件系统挂载。按动作所有者和 RPC 边界查日志,可以避免在错误的 Sidecar 上浪费时间。

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

目录与阅读设置

阅读设置

17

记录一个想法

识别 CSI Sidecar 组件职责

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

登录哪都通