容器与云原生 / 系统课时
识别 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 调用 | 典型位置 |
|---|---|---|---|
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,容器名也可能有所不同。
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预期输出(示例,实际组件以驱动能力和安装方式为准):
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 上浪费时间。