dbscale/csi-node-driver-registrar

CSI Node Driver Registrar 镜像文档

概述

本镜像为k8s.gcr.io/sig-storage/csi-node-driver-registrar的克隆版本，是Kubernetes CSI（容器存储接口）规范的核心组件之一。其主要功能是在Kubernetes节点上运行，负责将CSI驱动程序注册到节点的kubelet服务，建立kubelet与CSI驱动之间的通信通道，确保kubelet能够发现并使用CSI驱动提供的存储服务。

核心功能与特性

• 驱动注册：向kubelet注册CSI驱动程序，提供驱动名称、支持的存储能力等元数据
• 通信桥梁：建立kubelet与CSI驱动之间的gRPC通信通道，传递存储操作请求
• 状态上报：实时上报CSI驱动的运行状态，确保集群感知驱动可用性
• 规范兼容：完全遵循CSI规范，支持CSI 1.0及以上版本，兼容各类CSI存储驱动
• 轻量级：镜像体积小，资源占用低，适合在Kubernetes节点作为DaemonSet长期运行

使用场景与适用范围

• CSI驱动部署：在Kubernetes集群中部署任何CSI兼容存储驱动（如云厂商存储、本地存储、分布式存储等）时，需作为节点组件部署
• 存储服务发现：确保kubelet能够发现节点上的CSI驱动，实现Pod与存储的动态绑定
• 集群存储管理：支持Kubernetes存储功能的扩展，如动态配置卷、卷快照、存储类等高级特性

使用方法与配置说明

部署方式

通常在Kubernetes集群中以DaemonSet方式部署，确保每个节点运行一个实例。

环境变量

卷挂载

需挂载以下路径以实现与kubelet和CSI驱动的通信：

• kubelet的CSI插件目录：通常为/var/lib/kubelet/csi-plugins，用于存放注册socket
• CSI驱动的socket目录：由CSI驱动定义，用于与驱动通信

Docker运行示例

bash
docker run -d \
  --name csi-node-driver-registrar \
  --privileged \
  -v /var/lib/kubelet/csi-plugins:/var/lib/kubelet/csi-plugins \
  -v /path/to/csi-driver-socket:/csi \
  -e KUBELET_REGISTRATION_PATH=/var/lib/kubelet/csi-plugins/my-csi-driver/reg.sock \
  -e CSI_DRIVER_REG_SOCK_PATH=/csi/csi-reg.sock \
  [镜像名称]:[标签]

Kubernetes DaemonSet示例片段

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: csi-node-driver-registrar
spec:
  selector:
    matchLabels:
      app: csi-node-driver-registrar
  template:
    metadata:
      labels:
        app: csi-node-driver-registrar
    spec:
      containers:
      - name: registrar
        image: [镜像名称]:[标签]
        env:
        - name: KUBELET_REGISTRATION_PATH
          value: /var/lib/kubelet/csi-plugins/my-csi-driver/reg.sock
        - name: CSI_DRIVER_REG_SOCK_PATH
          value: /csi/csi-reg.sock
        volumeMounts:
        - name: kubelet-csi-plugins
          mountPath: /var/lib/kubelet/csi-plugins
        - name: csi-driver-socket
          mountPath: /csi
      volumes:
      - name: kubelet-csi-plugins
        hostPath:
          path: /var/lib/kubelet/csi-plugins
          type: DirectoryOrCreate
      - name: csi-driver-socket
        hostPath:
          path: /path/to/csi-driver-socket
          type: DirectoryOrCreate

注意事项

• 需确保镜像版本与CSI驱动版本兼容，建议使用与原k8s.gcr.io/sig-storage/csi-node-driver-registrar相同的标签版本
• 运行时需具备足够权限（通常需要--privileged或相应的安全上下文）以访问主机路径
• 注册路径和socket路径需与CSI驱动配置保持一致，否则会导致注册失败