全部文档
当前文档
最近更新时间：2026-10-13 23:31:07
KPFS支持多种缓存机制来降低访问时延和提高吞吐量，包括本地缓存和分布式缓存。本文介绍如何在CSI Driver中使用缓存相关功能。
在开始阅读本文前，您需要先了解CSI存储卷的使用流程。
在CSI Driver中，您可以使用宿主机路径（hostPath）作为KPFS客户端缓存，该方式简单易用，缓存数据会落在Kubetnetes节点的本地数据盘。
在使用时，一定要注意正确设置缓存路径。在设置缓存路径后，Kuberenetes宿主机上的路径会以hostPath卷的形式挂载到Mount Pod（KPFS客户端运行在Mount Pod中，Mount Pod是每个节点内的应用Pod读写KPFS的通道）中，您还需要根据缓存盘参数，对缓存相关的挂载参数进行调整。
静态配置下，在PV中定义。
apiVersion: v1
kind: PersistentVolume
metadata:
name: kpfs-pv
labels:
type: kpfs-pv
name: kpfs_test
spec:
capacity:
storage: 10Pi
volumeMode: Filesystem
accessModes:
- ReadWriteMany
persistentVolumeReclaimPolicy: Retain
csi:
driver: csi.kpfs.com
volumeHandle: kpfs-pv
fsType: kpfs
nodePublishSecretRef:
name: kpfs-secret
namespace: default
mountOptions:
- --cache-dir /DATA/disk0,/DATA/disk1
- --cache-size 2048
- --cache-group mygroup动态配置下，在StorageClass中定义。
#sc yaml示例
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: kpfs-csi-provisioner-retain
provisioner: csi.kpfs.com
parameters:
csi.storage.k8s.io/provisioner-secret-name: kpfs-secret
csi.storage.k8s.io/provisioner-secret-namespace: default
csi.storage.k8s.io/node-publish-secret-name: kpfs-secret
csi.storage.k8s.io/node-publish-secret-namespace: default
reclaimPolicy:
Retain
mountOptions:
- --cache-dir /DATA/disk0,/DATA/disk1
- --cache-size 2048
- --cache-group mygroup纯净模式