容器与云原生 / 系统课时
部署并验证 CSI 驱动
部署并验证 CSI 驱动
这一步的目标不是只看到 Pod 变成 Running,而是确认 CSI Controller、Node 插件、CSIDriver 与各节点的 CSINode 已形成完整注册链路。完成后,你能区分“工作负载已启动”和“驱动已被 kubelet 正确认知”这两种状态。
学习目标
- 部署 CSI Controller 与 Node 组件并检查工作负载就绪状态
- 识别
CSIDriver、CSINode与 kubelet 插件注册之间的关系 - 根据工作负载、注册对象和日志定位常见部署失败
部署前确认驱动边界
CSI 驱动的镜像、RBAC、StorageClass 参数和安装方式由厂商实现决定,因此本课不虚构某个驱动的专有配置。准备好官方 manifest 的本地路径或 HTTPS 地址,并确认当前账号具备安装所需的集群级权限。
# 确认集群可达、节点就绪,并检查创建 CSIDriver 的权限。
kubectl cluster-info
kubectl get nodes
kubectl auth can-i create csidrivers.storage.k8s.io预期输出
Kubernetes control plane is running at <URL>
NAME STATUS ROLES AGE VERSION
<NODE> Ready <ROLE> <AGE> <VERSION>
yes实际节点名、角色、版本和控制面地址会不同。如果最后一行是 no,应先补齐安装所需权限,不要继续执行一个只能部署部分资源的驱动清单。
典型的动态供给 CSI 驱动包含两类工作负载:Controller 负责创建、删除、附加等控制面操作,常以 Deployment 或 StatefulSet 运行;Node 插件负责节点侧阶段化、挂载与卸载,通常以 DaemonSet 覆盖目标节点。Node Pod 中的 node-driver-registrar 通过 kubelet 的插件注册机制登记 CSI 驱动。

应用 Controller 与 Node 工作负载
把 <PATH_OR_HTTPS_URL> 替换为驱动官方 manifest,把 <NAMESPACE> 替换为该清单实际使用的命名空间。若安装包由 Helm 或 Operator 管理,应使用对应的官方安装命令,而不是强行套用 kubectl apply。
# 应用官方清单,并检查控制器类工作负载与节点 DaemonSet。
CSI_MANIFEST='<PATH_OR_HTTPS_URL>'
CSI_NS='<NAMESPACE>'
kubectl apply -f "$CSI_MANIFEST"
kubectl get deploy,sts,ds -n "$CSI_NS"
kubectl get pods -n "$CSI_NS" -o wide预期输出
<RESOURCE>/<NAME> <APPLY_STATUS>
...
NAME READY UP-TO-DATE AVAILABLE
<CONTROLLER_WORKLOAD> <N>/<N> <N> <N>
...
NAME DESIRED CURRENT READY
<NODE_DAEMONSET> <N> <N> <N>
...
<CSI_POD_ROWS><APPLY_STATUS> 可能是 created、configured 或 unchanged。验收重点不是资源名,而是 Controller 副本达到 Ready,Node DaemonSet 的 READY 与预期覆盖节点数一致。若驱动仅面向特定操作系统或节点标签,DESIRED 应与它的调度范围一致,而不是机械地等于集群总节点数。
核对 CSIDriver 与 CSINode
Pod Ready 只能证明容器进程已通过就绪检查。节点侧注册是否成功,要看对应节点的 CSINode.spec.drivers 是否出现驱动名以及该驱动返回的 nodeID;CSIDriver 则声明驱动的集群级行为,例如是否需要 attach。
# 查看集群级驱动声明,并按节点核对已注册的 CSI 驱动。
kubectl get csidriver -o 'custom-columns=NAME:.metadata.name,ATTACH_REQUIRED:.spec.attachRequired,POD_INFO:.spec.podInfoOnMount'
kubectl get csinode -o 'custom-columns=NODE:.metadata.name,DRIVERS:.spec.drivers[*].name,NODE_IDS:.spec.drivers[*].nodeID'预期输出
NAME ATTACH_REQUIRED POD_INFO
<DRIVER_NAME> <VALUE> <VALUE>
NODE DRIVERS NODE_IDS
<NODE> <DRIVER_NAME> <NODE_ID>同一节点安装多个 CSI 驱动时,DRIVERS 和 NODE_IDS 会包含多项。验收时应按驱动名逐节点核对,不能只因为集群里存在 CSINode 对象就判定目标驱动已注册。
用注册证据定位失败
如果 Controller 正常而 Node DaemonSet 不 Ready,先查 Node Pod 的事件、权限和 hostPath 挂载;如果 Node Pod 已 Ready 但 CSINode 中仍没有目标驱动,则重点查看 registrar 容器日志,以及 Node 插件 CSI socket 与 kubelet 插件注册目录的交互。自定义 kubelet 根目录的集群还要确认驱动清单使用了匹配的宿主机路径。
# 仅在节点注册异常时执行;Pod 和容器名以实际驱动清单为准。
CSI_NS='<NAMESPACE>'
NODE_POD='<NODE_PLUGIN_POD>'
REGISTRAR='<REGISTRAR_CONTAINER>'
kubectl describe pod "$NODE_POD" -n "$CSI_NS"
kubectl logs "$NODE_POD" -n "$CSI_NS" -c "$REGISTRAR" --tail=100预期输出
Name: <NODE_PLUGIN_POD>
Status: <STATUS>
Containers: <CONTAINER_LIST>
Events:
<EVENT_LINES>
<REGISTRAR_LOG_LINES>若日志出现 socket 不存在、插件注册目录不可写、权限拒绝或持续重连,应先修复 Node 插件与 kubelet 的本地通信,而不是调整 PVC。若 CSIDriver 缺失,优先回到安装清单和 RBAC;若只有少数节点缺少驱动,优先检查 DaemonSet 的调度条件与这些节点上的 Node Pod。
验收注册链路
部署完成后至少满足三点:Controller 工作负载就绪,Node DaemonSet 覆盖预期节点,目标驱动同时出现在 CSIDriver 与这些节点的 CSINode.spec.drivers 中。只有注册链路完整,后续对 PVC、PV、VolumeAttachment 和挂载故障的判断才有可信基础。