容器与云原生 / 系统课时
创建静态 PV 与 PVC 绑定
创建静态 PV 与 PVC 绑定
静态供给的关键不是“先建 PV 再建 PVC”,而是让控制器找到一个满足声明条件的可用 PV。本文用一个可直接应用的实验,验证容量、访问模式、storageClassName、volumeMode 与 selector 如何共同决定 PVC 能否进入 Bound。
学习目标
- 能创建一组静态 PV、PVC,并验证一对一绑定结果。
- 能解释容量、访问模式、StorageClass、
volumeMode与标签 selector 的匹配关系。 - 能从 Pending PVC 反查到底是哪一条匹配条件没有满足。
先理解静态绑定的筛选条件
PVC 不会“拿到名字最像的 PV”,而是由控制器从当前可用卷中筛选候选。PV 的容量必须不小于 PVC 请求量,访问模式必须满足请求,storageClassName 与 volumeMode 要兼容;PVC 如果带 selector,PV 标签还必须满足 selector 的全部条件。

这些条件是“同时满足”关系。容量允许 PV 比请求更大,例如 5Gi PV 可以承接 2Gi PVC;但 1Gi PV 不能承接 2Gi 请求。selector.matchLabels 与 selector.matchExpressions 之间也会按 AND 关系共同过滤候选 PV。
创建用于绑定实验的资源
下面用 hostPath 只演示控制面的静态绑定规则。它适合单节点实验,不代表生产存储设计;多节点环境不要把这个示例当成可迁移的持久化方案。
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
name: static-demo
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: Immediate
---
apiVersion: v1
kind: PersistentVolume
metadata:
name: static-pv
labels:
storage-tier: demo
spec:
capacity:
storage: 5Gi
volumeMode: Filesystem
accessModes:
- ReadWriteOnce
persistentVolumeReclaimPolicy: Retain
storageClassName: static-demo
hostPath:
path: /var/lib/anystack-static-pv
type: DirectoryOrCreate
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: static-pvc
spec:
accessModes:
- ReadWriteOnce
volumeMode: Filesystem
storageClassName: static-demo
selector:
matchLabels:
storage-tier: demo
resources:
requests:
storage: 2Gi保存为 static-pv-pvc.yaml 后应用:
kubectl apply -f static-pv-pvc.yaml预期输出
storageclass.storage.k8s.io/static-demo created
persistentvolume/static-pv created
persistentvolumeclaim/static-pvc createdkubernetes.io/no-provisioner 表示这个 StorageClass 不负责动态创建卷;真正可绑定的容量来自已经存在的 static-pv。volumeBindingMode: Immediate 让这个实验可以在没有 Pod 消费者时直接观察绑定。
验证 PVC 与 PV 已形成一对一关系
绑定由控制器异步完成,资源刚创建时短暂看到 Pending 并不一定是故障。等待 PVC 进入 Bound,再同时检查双方记录的引用。
kubectl wait --for=jsonpath='{.status.phase}'=Bound persistentvolumeclaim/static-pvc --timeout=30s
kubectl get pv static-pv -o custom-columns='PV:.metadata.name,STATUS:.status.phase,CLAIM:.spec.claimRef.name,CLASS:.spec.storageClassName,CAPACITY:.spec.capacity.storage'
kubectl get pvc static-pvc -o custom-columns='PVC:.metadata.name,STATUS:.status.phase,PV:.spec.volumeName,CLASS:.spec.storageClassName,REQUEST:.spec.resources.requests.storage'预期输出
persistentvolumeclaim/static-pvc condition met
PV STATUS CLAIM CLASS CAPACITY
static-pv Bound static-pvc static-demo 5Gi
PVC STATUS PV CLASS REQUEST
static-pvc Bound static-pv static-demo 2Gi绑定后,PVC 的 spec.volumeName 指向 PV,PV 的 spec.claimRef 指回 PVC;这不是共享池里的临时借用,而是一对一绑定。即使 PV 容量大于请求量,多出来的容量也不会再切给另一个 PVC。
Pending 时按条件反查
如果 PVC 一直 Pending,先看 kubectl describe pvc static-pvc 的 Events,再逐项比较候选 PV。常见原因是 class 名不一致、selector 标签不匹配、PV 容量不足、访问模式不满足、volumeMode 不兼容,或者 PV 已经绑定/预留给其他 Claim。
PVC 同时设置非空 selector 时,当前 Kubernetes 不会为它动态供给新 PV,因此 selector 更适合这里这种“从现有静态 PV 中筛选”的场景。排障时把 PVC 的每项要求与 PV 的实际字段一一对照,比只盯着 Pending 状态更快找到不匹配条件。