dyrnq/csi-node-driver-registrar

CSI Node Driver Registrar

概述

k8s.gcr.io/sig-storage/csi-node-driver-registrar 是 Kubernetes CSI（容器存储接口）框架的核心组件之一，由 Kubernetes SIG Storage 维护。该组件运行在集群的每个节点上，负责将节点级 CSI 驱动程序注册到 kubelet，实现 kubelet 与 CSI 驱动之间的通信协调，是 CSI 驱动在 Kubernetes 集群中正常工作的必要组件。

主要功能

• 驱动注册：向 kubelet 注册节点上的 CSI 驱动，提供驱动名称、支持的功能（如卷挂载、快照等）及通信端点信息。
• 信息同步：维护 CSI 驱动与 kubelet 之间的状态同步，确保 kubelet 能实时获取驱动可用性及能力。
• 通信代理：作为中间层，转发 kubelet 与 CSI 驱动间的节点级请求（如 NodeStageVolume、NodePublishVolume）。

使用场景

适用于所有基于 Kubernetes CSI 规范部署存储驱动的场景，包括但不限于：

• 集群部署分布式存储插件（如 Ceph RBD、GlusterFS）；
• 集成云厂商存储服务（如 AWS EBS、Azure Disk、GCP PD）；
• 部署本地存储驱动（如 Local PV、LVM）。

部署示例（Kubernetes DaemonSet）

作为节点级组件，通常以 DaemonSet 形式部署，确保每个节点运行一个实例：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: csi-node-driver-registrar
  namespace: kube-system
spec:
  selector:
    matchLabels:
      app: csi-node-driver-registrar
  template:
    metadata:
      labels:
        app: csi-node-driver-registrar
    spec:
      containers:
      - name: csi-node-driver-registrar
        image: k8s.gcr.io/sig-storage/csi-node-driver-registrar:v2.8.0  # 替换为实际版本
        args:
        - --v=5  # 日志级别
        - --csi-address=/csi/csi.sock  # CSI 驱动的 Unix socket 路径
        - --kubelet-registration-path=/var/lib/kubelet/plugins_registry/csi-driver-registrar.sock
        volumeMounts:
        - name: plugin-dir
          mountPath: /csi
        - name: registration-dir
          mountPath: /var/lib/kubelet/plugins_registry/
      volumes:
      - name: plugin-dir
        hostPath:
          path: /var/lib/kubelet/plugins/<csi-driver-name>/  # CSI 驱动的主机路径
          type: DirectoryOrCreate
      - name: registration-dir
        hostPath:
          path: /var/lib/kubelet/plugins_registry/
          type: Directory

注意事项

• 需与 CSI 驱动容器协同部署，确保共享 CSI 驱动的 Unix socket 文件（通常位于 /var/lib/kubelet/plugins/<csi-driver-name>/csi.sock）。
• 镜像版本需与 Kubernetes 集群版本兼容，建议参考 https://kubernetes-csi.github.io/docs/node-driver-registrar.html#compatibility%E3%80%82
• 运行时需挂载 kubelet 的 plugins_registry 目录（默认 /var/lib/kubelet/plugins_registry/），确保注册信息持久化。