storageos/csi-provisioner

CSI卷配置Sidecar容器

概述

该镜像为CSI（Container Storage Interface，容器存储接口）架构中的sidecar容器，专门负责卷配置（volume provisioning）功能。作为Kubernetes CSI部署的核心辅助组件，它与CSI驱动容器协同工作，实现存储卷的动态创建、绑定与管理，是连接Kubernetes控制平面与存储系统的关键桥梁。

主要用途

• 接收Kubernetes PersistentVolumeClaim（PVC）请求，触发存储卷动态创建流程
• 协调CSI驱动与Kubernetes API服务器之间的通信
• 管理卷的生命周期，包括创建、绑定、删除等操作
• 确保存储卷配置过程符合CSI规范及Kubernetes存储管理要求

核心功能与特性

• 动态卷配置：根据PVC规格自动创建符合要求的存储卷
• CSI规范兼容：严格遵循CSI 1.0+标准接口，支持与各类CSI驱动集成
• 自动化工作流：无需手动干预，自动完成卷创建与PVC绑定
• 状态监控：跟踪卷配置过程状态，提供错误反馈与恢复机制
• 可配置性：支持通过环境变量和命令行参数自定义行为

使用场景与适用范围

• Kubernetes存储插件部署：所有基于CSI规范开发的存储插件（如Ceph、AWS EBS、GCP PD等）均需部署此sidecar容器
• 动态存储供应：需要为应用自动分配持久化存储的Kubernetes集群环境
• 云原生应用：微服务、数据库、消息队列等需要持久化存储的容器化应用
• CSI驱动开发与测试：CSI驱动开发者用于验证驱动的卷配置功能

使用方法与配置说明

部署要求

• Kubernetes集群版本1.13+（支持CSI特性）
• 已部署目标CSI驱动容器
• 正确配置RBAC权限（允许访问PVC、PV等Kubernetes资源）

环境变量配置

Kubernetes部署示例

以下为典型的CSI驱动部署清单片段，包含该sidecar容器：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: csi-provisioner
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: csi-provisioner
  template:
    metadata:
      labels:
        app: csi-provisioner
    spec:
      containers:
        # CSI卷配置sidecar容器
        - name: csi-provisioner
          image: docker.xuanyuan.run/[镜像名称]
          args:
            - "--csi-address=$(CSI_ENDPOINT)"
            - "--v=5"
          env:
            - name: CSI_ENDPOINT
              value: /csi/csi.sock
            - name: PROVISIONER_NAME
              value: csi.example.com
          volumeMounts:
            - name: csi-socket-dir
              mountPath: /csi
        # CSI驱动容器（示例）
        - name: csi-driver
          image: docker.xuanyuan.run/[CSI驱动镜像]
          volumeMounts:
            - name: csi-socket-dir
              mountPath: /csi
      volumes:
        - name: csi-socket-dir
          emptyDir: {}

工作流程说明

1. 用户创建PVC对象，指定存储类（StorageClass）
2. Kubernetes调度器识别PVC请求，调用CSI provisioner sidecar
3. Sidecar容器通过CSI_ENDPOINT与CSI驱动通信，请求创建存储卷
4. CSI驱动与后端存储系统交互，完成实际卷创建
5. Sidecar容器创建对应的PersistentVolume（PV）对象，并将其与PVC绑定
6. 应用Pod通过PVC挂载使用该存储卷

注意事项

• 多副本部署时需启用leader选举，避免重复处理PVC请求
• 确保sidecar容器与CSI驱动容器共享同一CSI通信端点（通常通过emptyDir卷挂载）
• 根据后端存储系统性能调整超时参数（如--timeout）
• 部署前需验证CSI驱动与sidecar容器版本兼容性