容器与云原生 / 系统课时
处理副本数与百分比取整
处理副本数与百分比取整
maxSurge 和 maxUnavailable 都可以写成百分比,但 Kubernetes 最终必须把它们换算成整数 Pod 数。小规模 Deployment 中,一次向上或向下取整就可能明显改变发布行为,本课用实际副本数计算这些边界,并验证它们对容量策略的影响。
学习目标
- 正确计算百分比形式的
maxSurge与maxUnavailable - 识别小副本工作负载中百分比取整造成的容量差异
- 在发布前把百分比策略换算成真实的 Pod 上限和可用下限
两个参数的取整方向不同
对于 Deployment 的 RollingUpdate,maxUnavailable 百分比按期望副本数计算后向下取整,maxSurge 则向上取整。
设期望副本数为 ,百分比分别为 和 ,则可以理解为:
例如 3 个副本使用 25%:3 × 25% = 0.75。因此 maxUnavailable 得到 0,而 maxSurge 得到 1。这里的 0 和 1 是控制器计算出的整数量,不应理解成“始终严格按固定顺序执行删除和创建”,实际更新过程还会受到新 Pod 是否 Ready、旧 Pod 是否可用以及其他控制器状态影响。
把百分比换成真实容量
下面列出相同 25% 策略在不同副本规模下的换算结果:
| 期望副本数 | maxUnavailable: 25% |
maxSurge: 25% |
对应最低可用副本 | 对应额外 Pod 上限 |
|---|---|---|---|---|
| 1 | 0 | 1 | 1 | 1 |
| 2 | 0 | 1 | 2 | 1 |
| 3 | 0 | 1 | 3 | 1 |
| 4 | 1 | 1 | 3 | 1 |
| 5 | 1 | 2 | 4 | 2 |
| 10 | 2 | 3 | 8 | 3 |
这里的最低可用副本可按 replicas - maxUnavailable 理解,额外 Pod 上限可按 replicas + maxSurge 理解。它们表示策略允许的容量边界,不代表每次发布都会恰好达到这些数值;调度速度、镜像拉取、就绪探针和 Pod 终止过程都会影响瞬时状态。
小规模工作负载尤其值得注意:1~3 个副本配置 maxUnavailable: 25% 时,换算结果都是 0。此时策略不允许因为 maxUnavailable 主动减少可用副本,但具体是先创建新 Pod、等待可用,还是受到其他状态约束,仍取决于当前滚动更新条件。
用 Deployment 验证换算结果
创建一个 3 副本 Deployment,并显式设置两个百分比参数:
kubectl create deployment rounding-demo --image=nginx:1.27 --replicas=3
kubectl patch deployment rounding-demo --type merge -p '{"spec":{"strategy":{"type":"RollingUpdate","rollingUpdate":{"maxSurge":"25%","maxUnavailable":"25%"}}}}'
kubectl describe deployment rounding-demo预期输出
Name: rounding-demo
Replicas: 3 desired | <VALUE> updated | <VALUE> total | <VALUE> available | <VALUE> unavailable
StrategyType: RollingUpdate
RollingUpdateStrategy: 25% max unavailable, 25% max surgedescribe 保留的是用户配置的百分比,不会直接替你显示“0 和 1”的换算结果。对于 3 个副本,需要根据规则自行得到:maxUnavailable = floor(0.75) = 0,maxSurge = ceil(0.75) = 1。
接着触发一次更新并观察发布是否完成:
kubectl set image deployment/rounding-demo nginx=nginx:1.28
kubectl rollout status deployment/rounding-demo预期输出
deployment.apps/rounding-demo image updated
deployment "rounding-demo" successfully rolled out在资源充足且新 Pod 能正常 Ready 的情况下,控制器可以在允许的容量边界内创建新 Pod 并逐步替换旧 Pod。具体瞬时 Pod 数会受调度速度、镜像拉取、就绪探针和终止宽限期影响,因此不要把某一次 kubectl get pods 的瞬时结果误认为固定更新序列。
小副本场景最容易出现误判
如果一个 2 副本 Deployment 配置 maxUnavailable: 30%,计算结果是 floor(2 × 0.3) = 0,并不是“最多可以少一个 Pod”。若同时配置 maxSurge: 0,两个参数都会换算为 0;而 Deployment 不允许 maxUnavailable 和 maxSurge 同时为 0,因为更新将无法向前推进。
如果目标就是允许 2 副本服务在发布期间最多损失 1 个副本,直接写绝对值往往更清楚:
apiVersion: apps/v1
kind: Deployment
metadata:
name: small-api
spec:
replicas: 2
strategy:
type: RollingUpdate
rollingUpdate:
maxUnavailable: 1
maxSurge: 0
selector:
matchLabels:
app: small-api
template:
metadata:
labels:
app: small-api
spec:
containers:
- name: api
image: nginx:1.28这段配置的生效行为是:期望副本数为 2 时,滚动更新允许最多 1 个副本不可用,并且不额外增加超过期望副本数的 Pod。可以应用配置后检查策略:
kubectl apply -f <PATH>
kubectl describe deployment small-api预期输出
deployment.apps/small-api created
StrategyType: RollingUpdate
RollingUpdateStrategy: 1 max unavailable, 0 max surge实际文件路径会替换 <PATH>;如果资源已经存在,kubectl apply 的第一行会显示为 configured 或其他实际状态。对于 1~3 个副本这类小规模工作负载,如果团队关心的是明确的“允许少几个”和“最多多几个”,绝对值通常比百分比更容易审查;百分比更适合副本数会明显伸缩、希望滚动策略随规模一起变化的 Deployment。发布前先完成取整计算,才能知道 YAML 中的百分比最终代表多少真实 Pod。