linode/driver-registrar

node-driver-registrar 镜像文档

镜像概述和主要用途

node-driver-registrar是Kubernetes CSI（容器存储接口）生态系统的核心组件，负责通过kubelet插件注册机制将CSI驱动程序注册到节点的kubelet，使kubelet能够发现并与CSI驱动建立通信，从而实现容器存储的动态配置与管理。

核心功能和特性

• CSI驱动注册：通过kubelet插件注册机制完成CSI驱动的节点注册，确保kubelet识别CSI驱动
• 通信中介：作为CSI驱动与kubelet间的通信桥梁，处理注册过程中的信息交换
• 规范兼容：严格遵循CSI规范，支持标准的CSI驱动注册流程
• 轻量部署：组件轻量化，资源占用低，适合在Kubernetes节点以DaemonSet形式运行

使用场景和适用范围

• CSI驱动部署：在Kubernetes集群部署任何CSI兼容存储驱动时，需配合该组件实现驱动的节点注册
• 容器存储管理：适用于需要通过CSI接口实现动态存储配置、卷挂载、快照等功能的场景
• 多节点集群：作为DaemonSet在集群所有节点运行，确保每个节点的CSI驱动均能被kubelet正确识别

使用方法和配置说明

部署方式

通常在Kubernetes集群中以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: node-driver-registrar
        image: k8s.gcr.io/sig-storage/csi-node-driver-registrar:v2.8.0
        args:
        - --v=5
        - --csi-address=/csi/csi.sock
        - --kubelet-registration-path=/var/lib/kubelet/plugins/<CSI_DRIVER_NAME>/csi.sock
        volumeMounts:
        - name: plugin-dir
          mountPath: /csi
        - name: registration-dir
          mountPath: /registration
      volumes:
      - name: plugin-dir
        hostPath:
          path: /var/lib/kubelet/plugins/<CSI_DRIVER_NAME>
          type: DirectoryOrCreate
      - name: registration-dir
        hostPath:
          path: /var/lib/kubelet/plugins_registry/
          type: Directory

关键配置参数

• --csi-address：CSI驱动的Unix域套接字路径，通常挂载为容器内/csi/csi.sock
• --kubelet-registration-path：kubelet注册插件的路径，指向主机上CSI驱动的套接字位置
• --v：日志详细级别，取值1-10（默认5），级别越高日志越详细

卷挂载说明

• plugin-dir：挂载主机上CSI驱动的插件目录，包含CSI驱动的Unix域套接字
• registration-dir：挂载kubelet的插件注册目录，用于完成驱动注册流程

参考链接

项目详情与最新版本信息：https://github.com/kubernetes-csi/node-driver-registrar