quay.io/kubevirt/hostpath-csi-driver:v0.18.0

quay.io/kubevirt/hostpath-csi-driver 技术说明

技术定位

quay.io/kubevirt/hostpath-csi-driver 是 Kubevirt 生态中的 HostPath CSI（Container Storage Interface）驱动镜像，用于在 Kubernetes 集群中提供基于主机节点本地路径的存储服务。其核心功能是通过 CSI 标准接口，将节点的本地目录（HostPath）抽象为可被 Pod 或 Kubevirt 虚拟机（VM）访问的持久化存储资源。

典型使用场景

• 开发与测试环境：快速部署依赖本地存储的应用或虚拟机，无需配置复杂的分布式存储系统。
• Kubevirt 虚拟机存储：为 Kubevirt 管理的虚拟机提供本地持久化存储，适用于对存储性能要求不高或数据本地性有需求的场景。
• 边缘计算场景：在资源受限的边缘节点中，利用本地存储满足轻量级应用的存储需求。

版本信息

镜像标签遵循语义化版本规范，主要版本包括：

• 稳定版：v1.13.1（最新稳定版）、v0.25.2、v0.24.0 等
• 最新版：latest（通常对应最新稳定版或开发分支）

与生态集成

• Kubernetes：遵循 CSI 规范，需配合 Kubernetes 集群的 CSI 插件框架使用，支持动态 provisioning、存储卷挂载等标准功能。
• Kubevirt：作为 Kubevirt 项目的配套存储驱动，专为虚拟机场景优化，可与 Kubevirt 的 VM 资源定义（如 VirtualMachine）结合使用。
• HostPath 存储：依赖节点本地文件系统路径（如 /var/lib/hostpath-csi），存储数据仅存在于单个节点，不具备跨节点高可用性。

使用示例（通用流程）

1. 部署 CSI 驱动（需结合 Kubernetes 资源清单）：

# 示例：部署 DaemonSet 以在节点上运行驱动
   apiVersion: apps/v1
   kind: DaemonSet
   metadata:
     name: hostpath-csi-driver
   spec:
     template:
       spec:
         containers:
           - name: driver
             image: quay.io/kubevirt/hostpath-csi-driver:v1.13.1

2. 创建存储类（StorageClass）：

apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: hostpath-csi
   provisioner: kubevirt.io/hostpath-csi-driver

3. 创建 PVC 并关联至 Pod/VM：

apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: example-pvc
   spec:
     storageClassName: hostpath-csi
     accessModes: ["ReadWriteOnce"]
     resources:
       requests:
         storage: 10Gi