vastdataorg/csi

VAST Data CSI Driver 技术文档

1. 镜像概述和主要用途

VAST Data CSI Driver是VAST Data提供的容器存储接口（CSI）驱动，用于Kubernetes等容器编排器（Container Orchestrator, CO）从VAST存储系统动态配置和管理存储卷。其核心用途是实现容器化应用与VAST存储系统的集成，支持持久化存储资源的按需分配与生命周期管理。

2. 核心功能和特性

• 动态卷配置：支持Kubernetes等容器编排器从VAST存储系统动态创建、删除存储卷，满足应用对持久化存储的动态需求。
• 卷挂载与访问：实现存储卷在容器中的自动挂载，支持多种访问模式（如ReadWriteOnce、ReadOnlyMany等，具体取决于VAST系统配置）。
• 存储生命周期管理：与Kubernetes存储框架深度集成，支持存储卷的扩展、回收（Reclaim）等生命周期操作。
• CSI规范兼容：遵循CSI标准接口，确保与Kubernetes等主流容器编排平台的兼容性。

3. 使用场景和适用范围

适用环境

• Kubernetes集群（版本需符合VAST官方兼容性要求，具体参考官方文档）。
• 已部署VAST存储系统，且Kubernetes集群可网络访问VAST系统。

典型场景

• 持久化应用存储：为数据库（如MySQL、PostgreSQL）、消息队列（如Kafka）等需要持久化数据的应用提供稳定存储。
• 高性能存储需求：针对需要高吞吐量、低延迟存储的应用（如大数据分析、AI训练），利用VAST存储系统的性能特性。
• 统一存储管理：在Kubernetes集群中集中管理VAST存储资源，简化多应用存储配置流程。

4. 使用方法和配置说明

4.1 前提条件

• Kubernetes集群已正常运行，且具备集群管理员权限。
• VAST存储系统已完成初始化配置，获取访问地址、认证凭证（用户名/密码或API密钥）及存储池信息。
• 集群节点已安装CSI驱动依赖组件（如CSI sidecar容器，具体参考Kubernetes CSI部署要求）。

4.2 安装部署

详细安装步骤请参考VAST官方文档：VAST with Kubernetes。以下为基本部署流程概述：

4.2.1 部署CSI驱动组件

通过kubectl应用官方提供的部署清单（示例命令，具体文件路径以官方为准）：

bash
# 下载并应用部署清单
kubectl apply -f https://support.vastdata.com/hc/en-us/article_attachments/360010932159/vast-csi-deployment.yaml

# 验证驱动Pod状态（默认命名空间可能为vast-csi，具体以部署清单为准）
kubectl get pods -n vast-csi

4.2.2 配置存储类（StorageClass）

创建StorageClass资源定义VAST存储的访问特性，示例配置（具体参数需根据VAST系统实际情况调整）：

yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: vast-storage-class  # 存储类名称，需与PVC关联
provisioner: csi.vastdata.com  # CSI驱动 provisioner名称
parameters:
  vastAddress: "https://vast-system.example.com"  # VAST系统API地址
  storagePool: "default-pool"  # VAST存储池名称（需提前在VAST系统创建）
  # 其他参数（如块大小、协议类型等，具体参考VAST官方文档）
reclaimPolicy: Delete  # 卷回收策略（Delete/Retain）
allowVolumeExpansion: true  # 是否支持卷扩展

应用存储类配置：

bash
kubectl apply -f vast-storageclass.yaml

4.3 使用示例

4.3.1 创建持久化卷声明（PVC）

通过PVC请求VAST存储资源，示例：

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: vast-pvc-demo  # PVC名称
spec:
  accessModes:
    - ReadWriteOnce  # 访问模式（根据VAST系统支持配置）
  storageClassName: vast-storage-class  # 关联上述创建的存储类
  resources:
    requests:
      storage: 50Gi  # 请求存储容量

应用PVC配置：

bash
kubectl apply -f vast-pvc.yaml

4.3.2 在Pod中使用存储卷

创建Pod并挂载上述PVC，示例：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: vast-storage-test
spec:
  containers:
  - name: test-container
    image: docker.xuanyuan.run/busybox:latest
    command: ["sh", "-c", "sleep 3600"]  # 保持容器运行
    volumeMounts:
    - name: vast-volume  # 卷名称，需与下方volumes字段对应
      mountPath: /data  # 容器内挂载路径
  volumes:
  - name: vast-volume
    persistentVolumeClaim:
      claimName: vast-pvc-demo  # 关联PVC名称

验证存储挂载：

bash
# 检查Pod状态
kubectl get pods

# 进入容器验证存储挂载
kubectl exec -it vast-storage-test -- df -h /data

5. 配置参数说明

VAST Data CSI Driver的详细配置参数（如VAST系统认证、存储池、性能优化等）需参考官方文档。以下为核心配置项说明（具体以官方最新文档为准）：

6. 注意事项

• 部署前需确认Kubernetes集群版本与CSI驱动版本的兼容性（参考VAST官方兼容性矩阵）。
• VAST系统的网络访问需打通（如防火墙策略允许Kubernetes节点访问VAST API端口）。
• 存储卷的性能特性（如IOPS、吞吐量）取决于VAST系统配置，需提前规划存储资源需求。

详细配置与故障排查请参考官方安装指南：VAST with Kubernetes。