容器与云原生 / 系统课时

StorageClass 动态供给

StorageClass 动态供给

本课解决“应用声明容量后,如何自动获得可用存储”的问题。你将配置 StorageClass、创建 PVC,并通过 Pod 挂载验证动态供给结果,不再手工预建每一个 PV。

学习目标

  • 说明 StorageClass、PVC、CSI 驱动与 PV 的协作关系
  • 配置动态供给所需的 provisioner、绑定模式和回收策略
  • 验证 PVC 绑定、Pod 挂载与容量扩展行为

动态供给的工作链路

静态供给要求管理员先创建 PV,再等待 PVC 匹配。动态供给则由 PVC 触发:控制器读取 storageClassName,调用对应 CSI provisioner 创建后端卷,再生成 PV 并与 PVC 绑定。

StorageClass 动态供给链路

StorageClass 本身不保存数据,它只是“如何创建卷”的模板。真正执行创建动作的是集群中已安装的 CSI 驱动;若 provisioner 名称与驱动不匹配,PVC 会一直保持 Pending。

配置 StorageClass 与 PVC

下面以 AWS EBS CSI 驱动为例。运行前需确认集群已经安装 ebs.csi.aws.com 驱动;其他环境应替换 provisioner 和 parameters,但 PVC 与 Pod 的写法不变。

yaml
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: app-gp3
provisioner: ebs.csi.aws.com
parameters:
  type: gp3
reclaimPolicy: Delete
allowVolumeExpansion: true
volumeBindingMode: WaitForFirstConsumer
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: app-data
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: app-gp3
  resources:
    requests:
      storage: 2Gi
---
apiVersion: v1
kind: Pod
metadata:
  name: storage-check
spec:
  containers:
    - name: writer
      image: busybox:1.36
      command: ["sh", "-c", "echo dynamic-ok > /data/result.txt; sleep 3600"]
      volumeMounts:
        - name: data
          mountPath: /data
  volumes:
    - name: data
      persistentVolumeClaim:
        claimName: app-data

WaitForFirstConsumer 会等到 Pod 参与调度后再创建卷,使卷所在可用区与目标节点一致。reclaimPolicy: Delete 表示 PVC 删除并释放 PV 后,后端卷通常也会被删除,生产环境应结合数据保留要求选择。

将内容保存为 storage-demo.yaml 后执行:

bash
kubectl apply -f storage-demo.yaml
kubectl wait --for=condition=Ready pod/storage-check --timeout=180s >/dev/null
kubectl get pvc app-data -o custom-columns='NAME:.metadata.name,STATUS:.status.phase,VOLUME:.spec.volumeName,CAPACITY:.status.capacity.storage,CLASS:.spec.storageClassName'
PV_NAME=$(kubectl get pvc app-data -o jsonpath='{.spec.volumeName}')
kubectl get pv "$PV_NAME" -o custom-columns='NAME:.metadata.name,STATUS:.status.phase,CLAIM:.spec.claimRef.name,RECLAIM:.spec.persistentVolumeReclaimPolicy'
kubectl exec storage-check -- cat /data/result.txt

预期输出:

text
storageclass.storage.k8s.io/app-gp3 created
persistentvolumeclaim/app-data created
pod/storage-check created
NAME       STATUS   VOLUME     CAPACITY   CLASS
app-data   Bound    pvc-<ID>   2Gi        app-gp3
NAME       STATUS   CLAIM      RECLAIM
pvc-<ID>   Bound    app-data   Delete
dynamic-ok

PV 名称、节点和等待时间由集群动态决定,实际值可能不同。只要 PVC 为 Bound、Pod 为 Ready 且文件可读取,就说明供给与挂载链路已经完成。

默认类、扩容与常见失败

若 PVC 省略 storageClassName,集群会尝试使用带默认注解的 StorageClass。多个默认类会造成选择不明确,建议只保留一个默认类,并让关键业务显式填写名称。

扩容时先确认 StorageClass 已设置 allowVolumeExpansion: true,再增大 PVC 的 resources.requests.storage。容量通常只能增加,不能缩小;文件系统是否在线扩展还取决于 CSI 驱动与卷类型。

PVC 长时间 Pending 时,按顺序检查 kubectl describe pvc app-data 的 Events、StorageClass 是否存在、CSI 控制器是否运行、provisioner 名称是否一致,以及云账号配额和权限。使用 WaitForFirstConsumer 时,没有消费 Pod 属于正常等待,不应误判为故障。

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

目录与阅读设置

阅读设置

17

记录一个想法

StorageClass 动态供给

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

登录哪都通