首页/云/Kubernetes 速查/volumeClaimTemplates 存储申领模板

volumeClaimTemplates 存储申领模板

StatefulSet 按模板为每个副本生成独立 PVC(data-db-0、data-db-1…),Pod 重建或迁移后仍挂回同一份数据。

Kubernetes 速查云更新于 2026-10-12

模板与查看

模板与查看
volumeClaimTemplates:
  - metadata:
      name: data
    spec:
      accessModes: ["ReadWriteOnce"]
      storageClassName: fast-ssd
      resources:
        requests:
          storage: 50Gi

命令

命令
kubectl get pvc -l app=db
kubectl get pvc data-db-0 -o jsonpath='{.spec.storageClassName} {.status.capacity.storage}'
kubectl describe pvc data-db-1 | grep -A4 Events
PVC 命名规则:<模板名>-<sts名>-<序号>;扩容需 StorageClass 支持 allowVolumeExpansion,且改模板不会追溯已有 PVC。

易错点

  • 编辑模板只影响之后新建的副本;给已有副本扩容要单独 patch 对应 PVC
  • 缩容/删除 STS 默认保留 PVC(数据安全设计),要清理需显式删除 pvc

数据来源与参考

  • Kubernetes 官方文档 · StatefulSet(Volume Claim Templates)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌