容器与云原生 / 系统课时

处理副本数与百分比取整

处理副本数与百分比取整

maxSurge 和 maxUnavailable 都可以写成百分比,但 Kubernetes 最终必须把它们换算成整数 Pod 数。小规模 Deployment 中,一次向上或向下取整就可能明显改变发布行为,本课用实际副本数计算这些边界,并验证它们对容量策略的影响。

学习目标

  • 正确计算百分比形式的 maxSurge 与 maxUnavailable
  • 识别小副本工作负载中百分比取整造成的容量差异
  • 在发布前把百分比策略换算成真实的 Pod 上限和可用下限

两个参数的取整方向不同

对于 Deployment 的 RollingUpdate,maxUnavailable 百分比按期望副本数计算后向下取整,maxSurge 则向上取整。

设期望副本数为 RR,百分比分别为 UU 和 SS,则可以理解为:

maxUnavailable=⌊R×U⌋maxUnavailable = \lfloor R \times U \rfloor
maxSurge=⌈R×S⌉maxSurge = \lceil R \times S \rceil

例如 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,并显式设置两个百分比参数:

bash
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

预期输出

text
Name:                   rounding-demo
Replicas:               3 desired | <VALUE> updated | <VALUE> total | <VALUE> available | <VALUE> unavailable
StrategyType:           RollingUpdate
RollingUpdateStrategy:  25% max unavailable, 25% max surge

describe 保留的是用户配置的百分比,不会直接替你显示“0 和 1”的换算结果。对于 3 个副本,需要根据规则自行得到:maxUnavailable = floor(0.75) = 0,maxSurge = ceil(0.75) = 1。

接着触发一次更新并观察发布是否完成:

bash
kubectl set image deployment/rounding-demo nginx=nginx:1.28
kubectl rollout status deployment/rounding-demo

预期输出

text
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 个副本,直接写绝对值往往更清楚:

yaml
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。可以应用配置后检查策略:

bash
kubectl apply -f <PATH>
kubectl describe deployment small-api

预期输出

text
deployment.apps/small-api created
StrategyType:           RollingUpdate
RollingUpdateStrategy:  1 max unavailable, 0 max surge

实际文件路径会替换 <PATH>;如果资源已经存在,kubectl apply 的第一行会显示为 configured 或其他实际状态。对于 1~3 个副本这类小规模工作负载,如果团队关心的是明确的“允许少几个”和“最多多几个”,绝对值通常比百分比更容易审查;百分比更适合副本数会明显伸缩、希望滚动策略随规模一起变化的 Deployment。发布前先完成取整计算,才能知道 YAML 中的百分比最终代表多少真实 Pod。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理副本数与百分比取整

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通