Kubernetes存储版本容量清单与跨团队交接 - 第2节

2.1 CSI 驱动架构回顾

Container Storage Interface (CSI) 是 Kubernetes 与存储系统之间的标准插件接口。自 Kubernetes 1.13 进入 GA 以来，CSI 已成为集群存储扩展的唯一推荐方式，替代了原有的 in-tree 存储插件。

CSI 架构核心组件

CSI 驱动以一组 DaemonSet 和 StatefulSet 的形式部署在集群中，通过 gRPC 与 kubelet 及外部控制器通信。其核心组件包括：

2.2 驱动版本与 K8s 版本兼容矩阵

CSI 驱动的版本与 Kubernetes 版本之间存在严格的兼容性约束。每个 CSI 驱动版本都针对特定范围的 Kubernetes 版本进行测试和验证。升级 Kubernetes 控制面而不升级 CSI 驱动，或反之，都可能导致 PV/PVC 操作失败。

兼容性维度

• CSI 规范版本： CSI 1.x 与 CSI 2.x 的 gRPC 接口存在差异，驱动必须与 kubelet 支持的 CSI 规范版本匹配。
• Sidecar 版本： External Provisioner、Attacher 等 Sidecar 容器与 Kubernetes API 版本绑定，旧版 Sidecar 可能无法处理新版 API 对象。
• Kubernetes 特性门控： 某些 CSI 功能（如卷快照、卷克隆）依赖特定的 Kubernetes 特性门控，驱动版本必须与集群特性门控状态一致。

典型兼容矩阵示例

2.3 驱动升级导致 PV/PVC 版本不一致的典型场景

CSI 驱动升级过程中，PV/PVC 对象可能因为版本不匹配而出现状态异常。以下三个场景是生产环境中最高频的故障模式。

场景一：Sidecar 版本滞后导致 PVC 无法绑定

升级 Kubernetes 控制面后，PVC 的 API 版本从 v1 升级到 v1beta1（或反之），但 External Provisioner 仍使用旧版 API 监听事件。Provisioner 无法识别新版 PVC 对象，导致 PVC 一直处于 Pending 状态。

# 查看 PVC 状态
kubectl get pvc my-pvc -o wide
NAME     STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   AGE
my-pvc   Pending                                      fast-storage   5m

# 查看 Provisioner 日志
kubectl logs -n kube-system csi-provisioner-xxxxx
E0825 10:23:45.123456       1 controller.go:789] 
  failed to provision volume: 
  storageclass.storage.k8s.io "fast-storage" not found
  # 实际 StorageClass 存在，但 Provisioner 无法解析新版 API

场景二：CSI Controller 与 Node 版本不一致导致挂载失败

升级 CSI Controller 到 v3.0.x 但未升级 CSI Node DaemonSet，导致 Controller 创建的卷元数据格式与 Node 端解析逻辑不兼容。Pod 调度到节点后，Node 端无法正确挂载卷。

# Pod 事件显示挂载失败
kubectl describe pod my-app
Events:
  Type     Reason       Age   From               Message
  ----     ------       ----  ----               -------
  Warning  FailedMount  12s   kubelet            MountVolume.SetUp failed 
    for volume "pvc-xxxxx" : 
    rpc error: code = Internal desc = 
    staging target path is not mounted:
    /var/lib/kubelet/plugins/kubernetes.io/csi/pv/pvc-xxxxx/globalmount

场景三：CSI 规范版本不匹配导致卷操作超时

Kubernetes 1.28 默认启用 CSI 规范 v1.9 的某些特性（如卷健康监测），但 CSI 驱动仍使用 v1.5 规范。Controller 返回的卷状态字段格式与 kubelet 期望的不一致，导致卷操作超时。