linode/linode-blockstorage-csi-driver

Linode Block Storage CSI Driver

概述与主要用途

Linode Block Storage CSI Driver 是一个符合 https://github.com/container-storage-interface/spec 的存储驱动，用于连接容器编排器（如 Kubernetes）与 Linode Block Storage 服务。其核心用途是实现 Kubernetes 集群对 Linode Block Storage 卷的生命周期管理，包括动态配置、挂载、扩容、快照及删除等操作，为容器化应用提供持久化存储能力。

核心功能与特性

核心功能

• 动态卷配置：根据 Kubernetes PersistentVolumeClaim（PVC）的请求，自动创建 Linode Block Storage 卷。
• 卷挂载与卸载：支持将创建的 Block Storage 卷挂载到 Kubernetes Pod，并在 Pod 销毁时自动卸载。
• 卷生命周期管理：支持卷的创建、删除、扩容（需存储类启用）及快照（需配置快照控制器）。
• 与 Linode API 集成：通过 Linode API 实现对 Block Storage 资源的直接操作，确保配置实时生效。

特性

• 多区域支持：可指定 Linode 数据中心区域（如 us-east、eu-west），确保存储与应用就近部署。
• 存储类型适配：支持 Linode Block Storage 的不同性能类型（如标准存储、高性能存储）。
• Kubernetes 原生集成：符合 Kubernetes 存储架构，支持 StorageClass、PVC、PersistentVolume（PV）等原生资源。
• 安全认证：通过 Linode API 令牌（Token）进行身份验证，确保存储操作的安全性。

使用场景与适用范围

适用场景

• 持久化应用部署：需持久化数据的 Kubernetes 应用，如数据库（MySQL、PostgreSQL）、消息队列（RabbitMQ）、分布式存储（MinIO）等。
• 状态化服务迁移：需要跨 Pod/节点保持数据一致性的状态化应用。
• 动态存储扩容：应用数据量增长时，通过 PVC 扩容实现存储容量动态调整。

适用范围

• 集群环境：Linode Kubernetes Engine（LKE）或自建在 Linode 虚拟机上的 Kubernetes 集群（版本需 ≥1.18，支持 CSI 规范 v1.0+）。
• 存储服务：需与 Linode Block Storage 集成的容器化环境，依赖 Linode 账户及 Block Storage 服务可用性。

使用方法与配置说明

前置条件

1. 环境准备：

   • 运行中的 Kubernetes 集群（版本 ≥1.18）。
   • Linode 账户及有效的 https://www.linode.com/docs/products/tools/api/get-started/#get-an-access-token%EF%BC%88%E9%9C%80%E5%8C%85%E5%90%AB linodes:read_write、volumes:read_write 权限）。
   • kubectl 命令行工具配置并指向目标 Kubernetes 集群。

2. 依赖组件：

   • 若需使用卷快照功能，需部署 Kubernetes https://kubernetes-csi.github.io/docs/snapshot-controller.html%E3%80%82

部署步骤

Linode Block Storage CSI Driver 通常通过 Kubernetes 资源清单或 Helm Chart 部署。以下为基于官方资源清单的部署流程：

1. 获取部署文件

从 https://github.com/linode/linode-blockstorage-csi-driver/ 获取最新部署清单：

bash
git clone https://github.com/linode/linode-blockstorage-csi-driver.git
cd linode-blockstorage-csi-driver

2. 配置 Linode API 令牌

创建包含 Linode API 令牌的 Secret（替换 <YOUR_LINODE_API_TOKEN> 为实际令牌）：

bash
kubectl create secret generic linode-csi -n kube-system \
  --from-literal=token=<YOUR_LINODE_API_TOKEN>

3. 部署 CSI Driver

应用部署清单（包含 Controller 和 Node 组件）：

bash
kubectl apply -f deploy/kubernetes/linode-csi-driver.yaml

验证部署：检查 kube-system 命名空间下的 CSI Controller Pod（linode-csi-controller-*）和 CSI Node DaemonSet Pod（linode-csi-node-*）是否运行正常。

存储配置与使用

1. 创建 StorageClass

定义 Kubernetes StorageClass，指定 Linode Block Storage 的配置参数（如区域、存储类型）。示例：

yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: linode-blockstorage-standard
provisioner: linodebs.csi.linode.com
parameters:
  region: us-east  # Linode 区域，如 us-east、eu-west、ap-south
  type: standard   # 存储类型：standard（标准）或 high（高性能）
  fsType: ext4     # 文件系统类型，支持 ext4、xfs
reclaimPolicy: Delete  # 卷回收策略：Delete（默认，删除 PVC 时删除卷）或 Retain
allowVolumeExpansion: true  # 启用卷扩容（需驱动支持）

2. 创建 PersistentVolumeClaim（PVC）

通过 PVC 请求存储资源，关联上述 StorageClass。示例：

yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: linode-pvc-example
spec:
  accessModes:
    - ReadWriteOnce  # 访问模式：ReadWriteOnce（单节点读写）、ReadOnlyMany（多节点只读）
  resources:
    requests:
      storage: 10Gi  # 请求存储容量（最小 10Gi，Linode Block Storage 最小卷大小）
  storageClassName: linode-blockstorage-standard  # 关联上述 StorageClass

3. 在 Pod 中使用 PVC

将 PVC 挂载到 Pod，实现应用数据持久化。示例：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: app-with-linode-storage
spec:
  containers:
  - name: app
    image: docker.xuanyuan.run/nginx:alpine
    volumeMounts:
    - name: data-volume
      mountPath: /data  # 容器内挂载路径
  volumes:
  - name: data-volume
    persistentVolumeClaim:
      claimName: linode-pvc-example  # 关联创建的 PVC

配置参数说明

环境变量（部署 CSI Driver 时配置）

StorageClass 参数

参考链接

• https://github.com/linode/linode-blockstorage-csi-driver/
• https://www.linode.com/docs/products/storage/block-storage/
• https://github.com/container-storage-interface/spec
• https://kubernetes-csi.github.io/docs/