k8s.gcr.io/sig-storage/csi-attacher:v3.3.0

CSI Attacher 是 Kubernetes 存储生态中的核心组件，基于容器存储接口（CSI）规范实现，主要负责协调存储卷与节点间的挂载操作，是连接 Kubernetes 控制平面与 CSI 存储驱动的关键桥梁。 其核心功能围绕 VolumeAttachment 自定义资源（CRD）展开。当 Pod 被调度到节点且声明使用 CSI 存储卷时，Kubernetes 控制平面会创建 VolumeAttachment 对象，记录卷 ID、目标节点等信息。CSI Attacher 持续监听这类对象，一旦发现未处理的挂载请求，便通过 gRPC 调用 CSI 驱动的 ControllerPublishVolume 接口，指示驱动完成卷到目标节点的挂载准备（如配置 LUN 映射、激活文件系统等）。操作成功后，CSI Attacher 会更新 VolumeAttachment 状态为“attached”，此时节点上的 kubelet 才能进一步将卷挂载到 Pod 内部。 当 Pod 被删除或迁移时，CSI Attacher 同样监听 VolumeAttachment 的删除事件，调用 CSI 驱动的 ControllerUnpublishVolume 接口解除卷与节点的关联，并将状态更新为“detached”，避免存储资源长期占用。 在 Kubernetes 动态存储供应（Dynamic Provisioning）流程中，CSI Attacher 是不可或缺的一环。它衔接了调度系统（如 kube-scheduler）与存储驱动，确保存储卷在节点间按需分配、安全释放，支撑了 StatefulSet 有状态应用的稳定运行（如数据库、分布式存储集群）。 实际部署中，CSI Attacher 通常作为“Sidecar”容器与 CSI 驱动共同运行在控制器组件（如 Deployment）内，通过 Unix 域套接字与驱动通信。运维时需注意两点：一是版本兼容性（如 K8s 1.24+ 需搭配 CSI Attacher v3.4+），二是 RBAC 权限配置——需授予其访问 VolumeAttachment、节点信息（Node）及 CSI 驱动服务的权限。日常排查中，若出现“卷挂载超时”或“Pod Pending 状态且事件提示 AttachVolume.Attach failed”，可优先检查 CSI Attacher 日志，定位是否存在驱动响应延迟、节点存储端口未开放等问题。