容器与云原生 / 系统课时
PersistentVolume
PersistentVolume
PersistentVolume(PV)用于把集群中的真实存储抽象成可声明、可绑定的资源。本课会用一个静态 PV 说明容量、访问模式、回收策略和生命周期,并通过命令确认资源进入可供 PVC 使用的 Available 状态。
学习目标
- 识别 PV 中决定容量、挂载方式和存储来源的关键字段
- 理解访问模式、回收策略与生命周期状态之间的关系
- 创建并验证一个可被 PVC 匹配的静态 PV
PV 的本质
PV 是集群级资源,不属于某个命名空间。它描述一块已经存在或可被供应的存储,包括容量、卷模式、访问模式、回收策略、StorageClass 以及具体存储实现。应用通常不直接引用 PV,而是通过 PersistentVolumeClaim(PVC)提出需求,再由控制器完成绑定。
PV 与底层磁盘不是同一对象。删除 PV 资源是否会删除真实数据,取决于回收策略和存储插件;因此清理资源前必须先确认策略。
容量与访问模式
spec.capacity.storage 表示可提供的容量。PVC 的请求值可以小于 PV 容量,但一个 PV 同一时间只能绑定一个 PVC,剩余空间不会自动拆分给其他声明。
| 模式 | 含义 | 典型场景 |
|---|---|---|
ReadWriteOnce(RWO) |
单个节点读写挂载 | 常见块存储 |
ReadOnlyMany(ROX) |
多个节点只读挂载 | 共享只读内容 |
ReadWriteMany(RWX) |
多个节点读写挂载 | NFS、部分分布式文件系统 |
ReadWriteOncePod(RWOP) |
同一时间仅一个 Pod 读写 | 支持该能力的 CSI 存储 |
访问模式主要参与匹配和挂载约束,并不等同于文件系统权限控制。是否真正支持某种模式,最终由底层存储和驱动决定。
回收策略与生命周期
常用回收策略有两种:Retain 在 PVC 删除后保留存储和数据,PV 通常进入 Released,管理员清理数据和绑定引用后才能重新使用;Delete 会请求存储插件删除后端卷,并移除对应 PV,适合可自动重建的数据。

生命周期中最常见的状态是 Available、Bound、Released 和 Failed。Released 不等于可以再次绑定,因为旧 PVC 的引用仍可能保留。
创建并验证静态 PV
下面示例使用 hostPath,只适合本地单节点或教学环境。生产环境应使用 CSI 驱动提供的网络盘、云盘或分布式存储。将以下内容保存为 pv.yaml:
apiVersion: v1
kind: PersistentVolume
metadata:
name: demo-pv
spec:
capacity:
storage: 1Gi
volumeMode: Filesystem
accessModes:
- ReadWriteOnce
persistentVolumeReclaimPolicy: Retain
storageClassName: manual
# hostPath 绑定节点本地目录,不适合作为多节点生产存储
hostPath:
path: /data/pv-demo
type: DirectoryOrCreate该配置创建一个容量为 1Gi、文件系统模式、RWO、回收策略为 Retain 的静态 PV。执行创建和状态检查:
kubectl apply -f pv.yaml
kubectl get pv demo-pv -o custom-columns='NAME:.metadata.name,CAPACITY:.spec.capacity.storage,MODE:.spec.accessModes[0],RECLAIM:.spec.persistentVolumeReclaimPolicy,PHASE:.status.phase'预期输出:
persistentvolume/demo-pv created
NAME CAPACITY MODE RECLAIM PHASE
demo-pv 1Gi ReadWriteOnce Retain Available若 PHASE 不是 Available,优先检查同名 PV 是否已存在、字段是否合法,以及它是否已经被某个 PVC 绑定。