boky/csi-node-driver-registrar

Node Driver Registrar镜像

镜像概述

本镜像为多架构（arm/arm64/amd64）版本的Kubernetes CSI节点驱动注册器，是CSI驱动的sidecar容器，用于通过Kubelet插件注册机制将CSI驱动注册到Kubelet，确保Kubelet能通过指定的Unix域套接字与CSI驱动交互，执行NodeGetInfo、NodeStageVolume等存储操作。

核心功能

1. 驱动注册：将CSI驱动注册到Kubelet，告知Kubelet交互的套接字路径。
2. 套接字管理：维护注册套接字和CSI驱动套接字，实现Kubelet与CSI驱动的通信。
3. 多架构支持：兼容arm、arm64、amd64架构，适配不同硬件环境的Kubernetes节点。

兼容性

注：release-0.4及以下版本请参考https://github.com/kubernetes-csi/driver-registrar%E3%80%82

使用场景

在Kubernetes集群中部署CSI存储驱动时，需将本镜像作为sidecar容器与CSI驱动容器共同运行，确保Kubelet能正确识别并调用CSI驱动。

配置说明

必要参数

• --csi-address：CSI驱动套接字在pod内的路径（如/csi/csi.sock）。
• --kubelet-registration-path：CSI驱动套接字在主机节点上的路径（如/var/lib/kubelet/plugins/<drivername.example.com>/csi.sock）。

必要权限

• 需挂载主机路径卷（plugin-dir和registration-dir）。
• 需具有访问CSI驱动套接字和注册套接字的文件权限。

部署示例（DaemonSet中的sidecar配置）

yaml
containers:
  - name: csi-driver-registrar
    image: boky/csi-node-driver-registrar
    args:
      - "--csi-address=/csi/csi.sock"
      - "--kubelet-registration-path=/var/lib/kubelet/plugins/<drivername.example.com>/csi.sock"
    lifecycle:
      preStop:
        exec:
          command: ["/bin/sh", "-c", "rm -rf /registration/<plugin> /registration/<drivername.example.com>-reg.sock"]
    volumeMounts:
      - name: plugin-dir
        mountPath: /csi
      - name: registration-dir
        mountPath: /registration
volumes:
  - name: registration-dir
    hostPath:
      path: /var/lib/kubelet/plugins_registry/
      type: Directory
  - name: plugin-dir
    hostPath:
      path: /var/lib/kubelet/plugins/<drivername.example.com>/
      type: DirectoryOrCreate

社区与支持

• Slack频道：#wg-csi、#sig-storage
• 邮件列表：https://groups.google.com/forum/#!forum/kubernetes-sig-storage
• 行为准则：遵循Kubernetes Code of Conduct