Kubernetes StorageClass 怎么用:动态制备一块 PVC,附 Pending 排查

技术教程 · K8s · 存储 · 2026-10-05

Kubernetes StorageClass 怎么用:动态制备一块 PVC,附 Pending 排查

一句话开头

管理 K8s 集群的人大概都遇到过这个场景:Pod 起不来,kubectl describe pod 里写着 pod has unbound immediate PersistentVolumeClaims,回头看 PVC,状态一直是 Pending。

多数时候不是存储坏了,而是 StorageClass 没配对。这篇把 StorageClass 怎么用、PVC 为什么 Pending 一次讲清。

前置准备

步骤 1:先看集群有哪些 StorageClass,谁是默认

kubectl get storageclass
# 简写
kubectl get sc

名字后面带 (default) 的那个就是默认存储类。PVC 不写 storageClassName 时,会绑定到它。

如果这个列表是空的,说明集群里没有可用的制备器(CSI 驱动没装,或者压根没建 SC)—— 这种情况下 PVC 一定会 Pending。

建一个 StorageClass:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: fast-storage
provisioner: ebs.csi.aws.com      # 换成你集群的 CSI 驱动名
reclaimPolicy: Retain             # 默认是 Delete,存重要数据建议显式写 Retain
allowVolumeExpansion: true        # 允许后续扩容量
volumeBindingMode: WaitForFirstConsumer
parameters:
  type: gp3

三个字段最值得说:

步骤 2:创建 PVC,验证动态制备

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: fast-storage   # 引用上面的 StorageClass
  resources:
    requests:
      storage: 10Gi
kubectl apply -f pvc.yaml
kubectl get pvc my-pvc -w

注意:如果 SC 用的是 WaitForFirstConsumer,此时 PVC 停在 Pending 是正常的,不是故障。要等到有 Pod 用它,才会触发卷制备。

步骤 3:写个 Pod 挂载它

apiVersion: v1
kind: Pod
metadata:
  name: pvc-demo
spec:
  containers:
    - name: app
      image: busybox
      command: ["sh", "-c", "echo hello > /data/hello.txt && sleep 3600"]
      volumeMounts:
        - name: data
          mountPath: /data
  volumes:
    - name: data
      persistentVolumeClaim:
        claimName: my-pvc

apply 之后再查:

kubectl get pvc      # 状态应变成 Bound
kubectl get pv       # 能看到自动创建的 PV,名字类似 pvc-<uuid>

到这一步,StorageClass 的动态制备链路就通了:PVC → 触发 provisioner → 自动建 PV → 绑定。

常见坑

作者补充:见过一次真实事故——存储类 SC 用的是默认 Delete,测试同学清理命名空间时顺手删了 PVC,PV 跟着被删,快照又没配,数据直接没了。生产集群的 StorageClass 建议一开始就把 reclaimPolicy: Retain 写死。事后改 SC 不会影响已经创建出来的 PV,补救是来不及的。

一句话总结

StorageClass 就是「按需自动买盘」的模板,PVC 引用它,K8s 就动态制备 PV。遇到 Pending 先 kubectl describe pvc 看 Events:九成是 SC 名字错、集群没有默认 SC,或者 WaitForFirstConsumer 正在等 Pod。