容器与云原生 / 系统课时
使用 StorageClass 动态供应卷
使用 StorageClass 动态供应卷
StorageClass 决定 PVC 由哪个存储驱动供应、何时创建卷以及释放后如何处理。本课通过一个可验证的动态供应示例,串起 PVC、StorageClass、CSI 与 PV,并明确四个核心字段的生效位置。
学习目标
- 说明 StorageClass 四个核心字段分别由谁读取、影响哪个阶段。
- 创建一个引用 StorageClass 的 PVC,并追踪它生成的 PV 与 CSI 驱动。
- 判断
Immediate、WaitForFirstConsumer、Delete与Retain对生命周期的实际影响。
StorageClass 决定动态供应策略
PVC 只描述容量、访问模式和可选的 storageClassName,并不直接写后端磁盘类型、区域或快照策略。控制面找到对应 StorageClass 后,再由它的 provisioner 选择供应器。对 CSI 驱动而言,这个值通常与 CSIDriver 的驱动名一致,external-provisioner 会监听待供应 PVC,并调用 CSI Controller 创建后端卷。
parameters 是供应器自定义参数,常用于指定磁盘类型、文件系统、加密或存储池。它们不是 Kubernetes 的统一语义,同名参数在不同驱动中可能完全不同,因此迁移 StorageClass 时必须重新核对驱动文档。

先读取集群已有的 StorageClass
先不要新建类。生产环境通常已经由平台团队提供可用的 StorageClass,先确认它对应的供应器和绑定模式,再决定 PVC 应引用哪一个。下面命令中的 <STORAGECLASS> 替换为实际名称。
kubectl get storageclass
kubectl get storageclass "<STORAGECLASS>" -o yaml预期输出会显示该类的供应器、回收策略与绑定模式,实际名称、年龄和参数因集群而异。
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
<STORAGECLASS> <CSI_DRIVER> <POLICY> <BINDING_MODE> <TRUE_OR_FALSE> <AGE>如果 provisioner 指向一个集群中没有运行的供应器,StorageClass 本身仍可能存在,但 PVC 会长期停在 Pending。这类问题要继续看 PVC 事件,而不是只看 StorageClass 是否能被 kubectl get 查到。
创建 PVC 并触发动态供应
下面是完整实验清单。它创建一个 1 GiB PVC,并用 Pod 消费该卷。即使 StorageClass 使用 WaitForFirstConsumer,Pod 出现后也能触发调度与供应流程。将 <STORAGECLASS> 替换为集群中支持 ReadWriteOnce 的动态供应类。
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: dynamic-demo
spec:
accessModes:
- ReadWriteOnce
storageClassName: <STORAGECLASS>
resources:
requests:
storage: 1Gi
---
apiVersion: v1
kind: Pod
metadata:
name: storage-consumer
spec:
containers:
- name: app
image: busybox:1.36
command: ["sh", "-c", "echo ready > /data/status && sleep 3600"]
volumeMounts:
- name: data
mountPath: /data
volumes:
- name: data
persistentVolumeClaim:
claimName: dynamic-demo保存为 dynamic-demo.yaml 后执行:
kubectl apply -f dynamic-demo.yaml
kubectl wait --for=jsonpath='{.status.phase}'=Bound pvc/dynamic-demo --timeout=120s
kubectl wait --for=condition=Ready pod/storage-consumer --timeout=120s
kubectl get pvc dynamic-demo
PV_NAME="$(kubectl get pvc dynamic-demo -o jsonpath='{.spec.volumeName}')"
kubectl get pv "$PV_NAME" -o custom-columns='NAME:.metadata.name,STORAGECLASS:.spec.storageClassName,RECLAIM:.spec.persistentVolumeReclaimPolicy,DRIVER:.spec.csi.driver'预期结果是 PVC 进入 Bound,Pod 进入 Ready,并能从动态生成的 PV 上读到 StorageClass、回收策略和 CSI 驱动。卷名、时间与具体策略会因环境不同。
persistentvolumeclaim/dynamic-demo condition met
pod/storage-consumer condition met
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE
dynamic-demo Bound <PV_NAME> 1Gi RWO <STORAGECLASS> <AGE>
NAME STORAGECLASS RECLAIM DRIVER
<PV_NAME> <STORAGECLASS> <POLICY> <CSI_DRIVER>四个字段在不同阶段生效
| 字段 | 主要作用位置 | 关键结果 |
|---|---|---|
provisioner |
供应器选择 | 决定哪个 external provisioner 或 CSI 驱动处理 PVC |
parameters |
创建后端卷时 | 作为驱动特定参数参与 CreateVolume,不保证原样出现在 PV 中 |
reclaimPolicy |
PVC 释放之后 | 动态生成 PV 会继承为 persistentVolumeReclaimPolicy;常见值为 Delete 或 Retain,省略时默认为 Delete |
volumeBindingMode |
绑定与调度阶段 | Immediate 尽早供应并绑定,且为默认值;WaitForFirstConsumer 等待 Pod,再结合可用区等拓扑约束供应 |
reclaimPolicy 不是“删除 PVC 时是否删除 PVC”,而是 PV 在原 Claim 释放后如何处理。Delete 通常会继续删除后端卷,Retain 则保留 PV 和数据,等待管理员决定如何清理或复用。
WaitForFirstConsumer 的价值在有拓扑约束的存储上最明显:调度器先综合 Pod 的 nodeSelector、亲和性和节点可用区,再让卷落到可被目标节点访问的位置,避免先建卷、后发现 Pod 无法调度到对应拓扑。
Pending 时沿事件链定位
如果 PVC 没有进入 Bound,先看 PVC 本身的事件,再回看 StorageClass。WaitForFirstConsumer 下“等待首个消费者”是正常状态;ProvisioningFailed、找不到 provisioner、拓扑不满足或后端拒绝创建才是故障信号。
kubectl describe pvc dynamic-demo
kubectl get events --field-selector "involvedObject.kind=PersistentVolumeClaim,involvedObject.name=dynamic-demo" --sort-by=.metadata.creationTimestamp预期结果是在 Events 或事件列表中看到供应链当前停在哪里。正常等待时可能出现 WaitForFirstConsumer,供应开始后通常会出现 provisioning 相关事件;失败时会出现 Warning 以及驱动返回的原因。事件 Reason 与 Source 由 Kubernetes 版本和 CSI sidecar 实现决定,应以本集群实际输出为准。
TYPE REASON OBJECT MESSAGE
Normal <WAIT_OR_PROVISIONING> persistentvolumeclaim/dynamic-demo <DETAIL>
Warning <FAILURE_REASON> persistentvolumeclaim/dynamic-demo <ERROR_DETAIL>真正要验证的是完整链路:PVC 引用了正确的 StorageClass,供应器能处理它,后端卷成功创建,PV 继承了预期回收策略,并最终与 PVC 绑定。只看到 StorageClass 对象存在,并不能证明动态供应已经可用。