容器与云原生 / 系统课时

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。

PVC 与 PV 的匹配绑定流程

若没有候选 PV,PVC 会保持 Pending。当 StorageClass 使用 WaitForFirstConsumer 时,供应或绑定会延迟到 Pod 参与调度,以便结合可用区和节点拓扑选择合适存储。

创建 PVC 并挂载到 Pod

下面示例使用 hostPath 作为教学存储。将内容保存为 pvc-demo.yaml:

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 挂载该卷。执行验证:

bash
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

预期输出:

text
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 自动清除。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

PersistentVolumeClaim

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通