TopoLVM 使用教程

项目介绍

TopoLVM 是一个基于 LVM（逻辑卷管理）的 Kubernetes CSI（容器存储接口）插件。它能够为 Kubernetes 提供动态存储卷的创建和管理，支持动态 Provisioning、原生数据块卷（Raw Block Volume）、Volume 伸缩等功能。TopoLVM 通过使用 CSI 和 LVM，实现了本地持久化存储卷的具体实现。

项目快速启动

环境准备

• Kubernetes 集群（版本 1.28 或更高）
• 节点操作系统：Linux（支持 LVM2，例如 Ubuntu）
• Docker 镜像：ghcr.io/topolvm/topolvm

安装步骤

1. 克隆项目仓库

   git clone https://github.com/topolvm/topolvm.git
   cd topolvm
   

2. 部署 TopoLVM

   kubectl apply -f deploy/manifests/topolvm-csi-node.yaml
   kubectl apply -f deploy/manifests/topolvm-controller.yaml
   

3. 验证安装

   kubectl get pods -n topolvm-system
   

创建存储类

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: topolvm-storageclass
provisioner: topolvm.cybozu.com
parameters:
  fsType: ext4

创建 PersistentVolumeClaim

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: topolvm-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
  storageClassName: topolvm-storageclass

应用案例和最佳实践

动态 Provisioning

TopoLVM 支持动态创建存储卷，当创建 PersistentVolumeClaim 对象时，存储卷会自动创建并绑定到相应的 Pod。

原生数据块卷

TopoLVM 支持将存储卷作为原生数据块设备提供给容器使用，适用于需要直接访问块设备的应用。

Volume 伸缩

通过编辑 PersistentVolumeClaim 对象，可以动态扩展存储卷的大小，满足不断增长的存储需求。

典型生态项目

Carina

Carina 是一个云原生本地磁盘管理方案，除了基于 LVM 的方案外，还支持裸盘分区方式以及 IOPS 限制等功能。Carina 的代码组织规范更贴合云原生社区的方式，整体非常值得一探。

项目地址：https://github.com/carina-io/carina

通过以上步骤和案例，您可以快速上手并使用 TopoLVM 进行 Kubernetes 的存储管理。希望本教程对您有所帮助！