容器与云原生 / 系统课时
PersistentVolumeClaim
PersistentVolumeClaim
PersistentVolumeClaim(PVC)让应用只声明“需要什么存储”,而不必知道真实磁盘来自哪里。本课会创建 PV、PVC 和 Pod,验证容量与访问模式匹配、PVC 绑定,以及 Pod 通过声明完成读写。
学习目标
- 编写包含容量、访问模式和 StorageClass 的 PVC
- 解释 PVC 与 PV 的匹配、绑定和延迟绑定过程
- 在 Pod 中挂载 PVC,并验证数据可读写
PVC 声明了什么
PVC 是命名空间级资源。它通常通过 resources.requests.storage 声明最小容量,通过 accessModes 声明访问方式,并通过 storageClassName 指定存储类别。Pod 只需要写 claimName,不直接选择具体 PV。
静态供应时,集群中必须先有满足条件的 PV;动态供应时,StorageClass 对应的 CSI 供应器会按 PVC 创建新卷。PVC 一旦绑定,便与某个 PV 建立一对一关系。
匹配与绑定过程
控制器会综合检查 PVC 的请求容量、访问模式、storageClassName、volumeMode 和可选选择器。候选 PV 的容量必须不小于请求值,且当前没有绑定其他 PVC。

若没有候选 PV,PVC 会保持 Pending。当 StorageClass 使用 WaitForFirstConsumer 时,供应或绑定会延迟到 Pod 参与调度,以便结合可用区和节点拓扑选择合适存储。
创建 PVC 并挂载到 Pod
下面示例使用 hostPath 作为教学存储。将内容保存为 pvc-demo.yaml:
apiVersion: v1
kind: PersistentVolume
metadata:
name: demo-pv-claim
spec:
capacity:
storage: 1Gi
volumeMode: Filesystem
accessModes:
- ReadWriteOnce
persistentVolumeReclaimPolicy: Retain
storageClassName: manual
hostPath:
path: /data/pvc-demo
type: DirectoryOrCreate
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: demo-claim
spec:
accessModes:
- ReadWriteOnce
storageClassName: manual
resources:
# 申请值必须不大于候选 PV 的容量
requests:
storage: 512Mi
---
apiVersion: v1
kind: Pod
metadata:
name: pvc-demo
spec:
containers:
- name: writer
image: busybox:1.36
command: ["sh", "-c"]
args:
- echo pvc-ok > /data/result.txt && sleep 3600
volumeMounts:
- name: data
mountPath: /data
volumes:
- name: data
# Pod 只引用 PVC,不直接引用底层 PV
persistentVolumeClaim:
claimName: demo-claim三个对象应用后,PVC 会匹配 demo-pv-claim,Pod 再通过 PVC 挂载该卷。执行验证:
kubectl apply -f pvc-demo.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Bound pvc/demo-claim --timeout=60s
kubectl wait --for=condition=Ready pod/pvc-demo --timeout=60s
kubectl exec pvc-demo -- cat /data/result.txt预期输出:
persistentvolume/demo-pv-claim created
persistentvolumeclaim/demo-claim created
pod/pvc-demo created
persistentvolumeclaim/demo-claim condition met
pod/pvc-demo condition met
pvc-ok实际等待时间可能不同。若 PVC 一直处于 Pending,先运行 kubectl describe pvc demo-claim,重点检查 StorageClass、访问模式、容量和事件;若 PVC 已 Bound 但 Pod 未就绪,再检查节点挂载、镜像拉取和卷插件错误。
关键边界
删除 Pod 不会删除 PVC,重新创建 Pod 后仍可挂载同一声明。删除 PVC 后如何处理数据由 PV 的回收策略决定。扩容 PVC 还需要 StorageClass 允许扩容,并且底层驱动与文件系统支持相应操作。
使用完示例后,可依次删除 Pod、PVC 和 PV;因为策略是 Retain,节点目录中的数据不会随 PVC 自动清除。