首页/云/Kubernetes 速查/StatefulSet 的 PVC 保留策略

StatefulSet 的 PVC 保留策略

persistentVolumeClaimRetentionPolicy 决定缩容或删除 StatefulSet 时自动删除还是保留 PVC:默认全部保留,防止误删数据。

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

策略配置

策略配置
spec:
  persistentVolumeClaimRetentionPolicy:
    whenDeleted: Retain     # 删除 STS 时:Retain | Delete
    whenScaled: Retain      # 缩容时:Retain | Delete

手动清理

手动清理
kubectl delete pvc data-db-2        # 确认不需要数据后再删
kubectl get pvc -l app=db
whenScaled=Delete 时缩容即删除对应 PVC,属于高风险管理动作,生产默认 Retain。

易错点

  • 升级/回滚操作触发缩容时也会受 whenScaled 影响,配置前想清楚缩容是否等价于删数据
  • 手动删除 PVC 后同名新 PVC 需要重新供应,数据不可逆,重要集群先做快照

数据来源与参考

  • Kubernetes 官方文档 · StatefulSet(PersistentVolumeClaim Retention)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌