首页/云/Kubernetes 速查/revisionHistoryLimit 修订历史保留

revisionHistoryLimit 修订历史保留

控制保留多少个旧 ReplicaSet 供回滚;保留越多可回滚版本越多,也会占用 etcd 与集群对象数量。

Kubernetes 速查云更新于 2026-10-12
默认值10 个旧 ReplicaSet

调整与查看

调整与查看
kubectl patch deploy/web -p '{"spec":{"revisionHistoryLimit":5}}'
kubectl get rs -l app=web --sort-by=.metadata.creationTimestamp
kubectl rollout history deploy/web
被清理的旧 ReplicaSet 无法再作为回滚目标;高风险服务适当多留几个版本(如 10-20)。

易错点

  • 设为 0 表示不留旧 ReplicaSet,rollout undo 将无目标可用
  • 历史对象被 GC 后 rollout history 里对应 revision 消失,变更前记录 revision 号

数据来源与参考

  • Kubernetes 官方文档 · Deployment(revisionHistoryLimit)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌