容器与云原生 / 系统课时
StorageClass 动态供给
StorageClass 动态供给
本课解决“应用声明容量后,如何自动获得可用存储”的问题。你将配置 StorageClass、创建 PVC,并通过 Pod 挂载验证动态供给结果,不再手工预建每一个 PV。
学习目标
- 说明 StorageClass、PVC、CSI 驱动与 PV 的协作关系
- 配置动态供给所需的 provisioner、绑定模式和回收策略
- 验证 PVC 绑定、Pod 挂载与容量扩展行为
动态供给的工作链路
静态供给要求管理员先创建 PV,再等待 PVC 匹配。动态供给则由 PVC 触发:控制器读取 storageClassName,调用对应 CSI provisioner 创建后端卷,再生成 PV 并与 PVC 绑定。

StorageClass 本身不保存数据,它只是“如何创建卷”的模板。真正执行创建动作的是集群中已安装的 CSI 驱动;若 provisioner 名称与驱动不匹配,PVC 会一直保持 Pending。
配置 StorageClass 与 PVC
下面以 AWS EBS CSI 驱动为例。运行前需确认集群已经安装 ebs.csi.aws.com 驱动;其他环境应替换 provisioner 和 parameters,但 PVC 与 Pod 的写法不变。
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-dataWaitForFirstConsumer 会等到 Pod 参与调度后再创建卷,使卷所在可用区与目标节点一致。reclaimPolicy: Delete 表示 PVC 删除并释放 PV 后,后端卷通常也会被删除,生产环境应结合数据保留要求选择。
将内容保存为 storage-demo.yaml 后执行:
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预期输出:
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-okPV 名称、节点和等待时间由集群动态决定,实际值可能不同。只要 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 属于正常等待,不应误判为故障。