digitalocean/do-csi-plugin

DigitalOcean CSI Plugin 镜像文档

镜像概述

DigitalOcean CSI Plugin是DigitalOcean官方提供的容器存储接口（CSI）插件，用于将DigitalOcean块存储（Block Storage）无缝集成到容器编排平台（如Kubernetes）。通过该插件，用户可在容器环境中便捷地使用DigitalOcean块存储，实现持久卷（Persistent Volume）的动态配置、挂载、快照、扩展等全生命周期管理，满足容器化应用对持久化存储的需求。

核心功能与特性

标准CSI功能

• 动态卷配置：支持通过StorageClass动态创建DigitalOcean块存储卷，无需手动创建卷
• 卷生命周期管理：支持持久卷（PV）的创建、挂载、卸载和删除
• 卷快照：支持创建和恢复卷快照，实现数据备份与恢复
• 卷扩展：支持在线扩展卷容量，无需重启应用
• 访问模式支持：支持ReadWriteOnce（单节点读写）访问模式

DigitalOcean特有功能

• 原生集成：与DigitalOcean块存储服务深度集成，利用其高性能SSD存储
• 多区域支持：自动适配DigitalOcean各区域块存储服务
• 资源标签：支持为创建的块存储卷添加自定义标签，便于成本追踪和资源管理

使用场景与适用范围

主要应用场景

• Kubernetes集群持久化存储：为Kubernetes集群提供持久化存储解决方案
• 有状态应用部署：支持数据库（如MySQL、PostgreSQL）、分布式缓存（如Redis集群）、消息队列（如RabbitMQ）等有状态应用
• 数据密集型应用：适用于需要高性能、低延迟存储的应用，如日志分析、数据处理服务
• 灾备需求场景：通过卷快照功能实现数据定期备份与快速恢复

适用环境

• Kubernetes集群（推荐版本1.20+）
• 运行在DigitalOcean Droplet的Kubernetes集群（如DigitalOcean Kubernetes服务或自管理集群）
• 需要持久化存储的容器化应用

使用方法与配置说明

前提条件

1. 拥有DigitalOcean账户及有效的API令牌（需具备write权限）
2. 运行中的Kubernetes集群（控制平面和节点需能访问DigitalOcean API）
3. kubectl命令行工具已配置并连接到目标集群

部署步骤

1. 准备DigitalOcean API令牌

获取DigitalOcean个人访问令牌（PAT），步骤：

• 登录DigitalOcean控制台
• 进入API > 个人访问令牌
• 创建令牌，勾选write权限，保存令牌值（后续使用DO_API_TOKEN指代）

2. 创建Secret存储API令牌

bash
kubectl create secret generic digitalocean-secret \
  --namespace kube-system \
  --from-literal=access-token=DO_API_TOKEN

替换DO_API_TOKEN为实际的API令牌

3. 部署CSI插件

使用官方提供的部署清单部署插件：

bash
kubectl apply -f https://raw.githubusercontent.com/digitalocean/csi-digitalocean/master/deploy/kubernetes/releases/csi-digitalocean-v4.0.0.yaml

注意：请通过https://github.com/digitalocean/csi-digitalocean%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E6%B8%85%E5%8D%95%E5%9C%B0%E5%9D%80

核心配置参数

环境变量（CSI控制器/节点组件）

StorageClass配置参数

创建StorageClass时可指定以下参数：

示例用法

1. 创建StorageClass

yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: do-block-storage
provisioner: dobs.csi.digitalocean.com
parameters:
  type: "s-2vcpu-4gb"  # 性能型卷
  fstype: "ext4"
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer

应用配置：

bash
kubectl apply -f storageclass.yaml

2. 创建PersistentVolumeClaim (PVC)

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: example-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi  # 请求10GB存储
  storageClassName: do-block-storage

应用配置：

bash
kubectl apply -f pvc.yaml

3. 创建Pod使用PVC

yaml
apiVersion: v1
kind: Pod
metadata:
  name: example-pod
spec:
  containers:
  - name: app
    image: nginx:latest
    volumeMounts:
    - name: data
      mountPath: /usr/share/nginx/html
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: example-pvc

应用配置：

bash
kubectl apply -f pod.yaml

验证与管理

检查CSI组件状态

bash
kubectl get pods -n kube-system | grep csi-digitalocean

预期输出包含运行中的控制器和节点 pods：

csi-digitalocean-controller-xxxxxxxxx-xxxxx   3/3     Running   0     5m
csi-digitalocean-node-xxxxx                   2/2     Running   0     5m

检查PV和PVC状态

bash
kubectl get pv
kubectl get pvc

创建卷快照（需部署快照控制器）

yaml
apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshot
metadata:
  name: example-snapshot
spec:
  volumeSnapshotClassName: do-block-storage-snapshot
  source:
    persistentVolumeClaimName: example-pvc

注意事项

• 确保Kubernetes集群版本与CSI插件版本兼容（参考官方兼容性矩阵）
• API令牌需妥善保管，避免泄露（建议使用Secret管理）
• 卷扩展功能需Kubernetes 1.16+支持，且StorageClass需设置allowVolumeExpansion: true
• 删除PVC前确保数据已备份，默认回收策略为删除卷（Delete）

参考链接

• https://github.com/digitalocean/csi-digitalocean
• DigitalOcean块存储文档
• https://kubernetes-csi.github.io/docs/