容器与云原生 / 系统课时
理解 maxSurge 与 maxUnavailable
理解 maxSurge 与 maxUnavailable
滚动更新并不是简单地“删一个旧 Pod,再起一个新 Pod”。maxSurge 决定发布期间最多可以额外创建多少副本,maxUnavailable 决定最多允许多少期望副本暂时不可用。理解两者的共同约束,才能判断一次 Deployment 更新的容量上限、可用下限和推进速度。
学习目标
- 解释
maxSurge与maxUnavailable分别约束什么 - 根据副本数计算滚动更新期间的最大 Pod 数和最低可用副本数
- 通过 Deployment 状态观察两个参数对更新过程的实际影响
两个参数控制的是两条容量边界
假设 Deployment 的期望副本数为 。滚动更新时,控制器需要同时维护“最多能创建多少 Pod”和“最少要保持多少 Pod 可用”两条边界。
maxSurge 控制超出期望副本数的额外 Pod 数,因此发布期间 Pod 总数上限可以近似写成:
maxUnavailable 控制期望副本中最多有多少可以处于不可用状态,因此更新期间需要维持的可用副本下限为:
例如 10 个副本配置 maxSurge: 2、maxUnavailable: 1,更新期间最多可以存在 12 个 Pod,同时通常需要至少保持 9 个期望副本可用。这里的“可用”由 Deployment 的可用性判定决定,而不是只看 Pod 是否已经创建。

百分比会先转换成整数
两个字段既可以写整数,也可以写百分比。百分比转换时采用不同的取整方向:maxSurge 向上取整,maxUnavailable 向下取整。
例如期望副本为 7:
maxSurge: 25%:,向上取整得到 2maxUnavailable: 25%:,向下取整得到 1
这种规则避免百分比配置在小副本 Deployment 上意外突破不可用预算,同时仍允许控制器获得一定的新增容量。
用一个 Deployment 观察更新过程
下面创建 4 副本 Deployment,并设置 maxSurge: 1、maxUnavailable: 1。更新镜像时,控制器可以临时创建第 5 个 Pod,同时允许最多 1 个期望副本不可用。
apiVersion: apps/v1
kind: Deployment
metadata:
name: rollout-demo
spec:
replicas: 4
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 1
selector:
matchLabels:
app: rollout-demo
template:
metadata:
labels:
app: rollout-demo
spec:
containers:
- name: web
image: nginx:1.26
ports:
- containerPort: 80将配置保存为 <PATH> 后执行:
kubectl apply -f <PATH>
kubectl set image deployment/rollout-demo web=nginx:1.27
kubectl rollout status deployment/rollout-demo预期输出
deployment.apps/rollout-demo created
deployment.apps/rollout-demo image updated
deployment "rollout-demo" successfully rolled out实际滚动期间的瞬时副本数会随镜像拉取、就绪探针和调度速度变化,因此不要期待固定的中间状态。可以在另一个终端持续查看 Deployment:
kubectl get deployment rollout-demo --watch预期结果
NAME READY UP-TO-DATE AVAILABLE AGE
rollout-demo 4/4 4 4 <TIME>更新过程中可能短暂看到 UP-TO-DATE、READY、AVAILABLE 逐步变化;最终应重新稳定为 4 个期望副本全部就绪。
参数不是发布速度的唯一决定因素
更大的 maxSurge 通常能让更多新 Pod 并行启动,更大的 maxUnavailable 也会给控制器更多替换空间,但二者都不能保证发布一定更快。新 Pod 的调度、镜像拉取、启动耗时、Readiness Probe、minReadySeconds 以及集群剩余资源都会限制推进速度。
因此设计滚动更新策略时,应把 maxSurge 看成额外资源预算,把 maxUnavailable 看成可用性损失预算。前者越大越需要集群预留资源,后者越大则越可能在更新期间降低业务承载能力。