容器与云原生 / 系统课时

创建静态 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 与 PVC 匹配筛选

这些条件是“同时满足”关系。容量允许 PV 比请求更大,例如 5Gi PV 可以承接 2Gi PVC;但 1Gi PV 不能承接 2Gi 请求。selector.matchLabels 与 selector.matchExpressions 之间也会按 AND 关系共同过滤候选 PV。

创建用于绑定实验的资源

下面用 hostPath 只演示控制面的静态绑定规则。它适合单节点实验,不代表生产存储设计;多节点环境不要把这个示例当成可迁移的持久化方案。

yaml
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 后应用:

bash
kubectl apply -f static-pv-pvc.yaml

预期输出

text
storageclass.storage.k8s.io/static-demo created
persistentvolume/static-pv created
persistentvolumeclaim/static-pvc created

kubernetes.io/no-provisioner 表示这个 StorageClass 不负责动态创建卷;真正可绑定的容量来自已经存在的 static-pv。volumeBindingMode: Immediate 让这个实验可以在没有 Pod 消费者时直接观察绑定。

验证 PVC 与 PV 已形成一对一关系

绑定由控制器异步完成,资源刚创建时短暂看到 Pending 并不一定是故障。等待 PVC 进入 Bound,再同时检查双方记录的引用。

bash
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'

预期输出

text
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 状态更快找到不匹配条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建静态 PV 与 PVC 绑定

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

登录哪都通