容器与云原生 / 系统课时

使用 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 时必须重新核对驱动文档。

PVC 经 StorageClass 动态供应到 PV 的控制链路

先读取集群已有的 StorageClass

先不要新建类。生产环境通常已经由平台团队提供可用的 StorageClass,先确认它对应的供应器和绑定模式,再决定 PVC 应引用哪一个。下面命令中的 <STORAGECLASS> 替换为实际名称。

bash
kubectl get storageclass
kubectl get storageclass "<STORAGECLASS>" -o yaml

预期输出会显示该类的供应器、回收策略与绑定模式,实际名称、年龄和参数因集群而异。

text
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 的动态供应类。

yaml
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 后执行:

bash
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 驱动。卷名、时间与具体策略会因环境不同。

text
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、拓扑不满足或后端拒绝创建才是故障信号。

bash
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 实现决定,应以本集群实际输出为准。

text
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 对象存在,并不能证明动态供应已经可用。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 StorageClass 动态供应卷

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

登录哪都通