4、滚动升级策略：maxSurge、maxUnavailable、minReadySeconds 参数配置

Kubernetes 节点滚动升级的核心控制参数包括 maxSurge、maxUnavailable 和 minReadySeconds。这三个参数共同决定了升级的速率、可用性容忍度以及新节点的健康准入条件。在 Policy as Code 场景中，这些参数是策略引擎（如 OPA/Gatekeeper）重点校验的字段，用于确保集群升级行为符合运维规范。

4.1 参数定义与作用

4.2 参数协同工作流程

下图展示了三个参数在节点滚动升级过程中的协同关系：

4.3 参数配置示例

以下是一个典型的节点池滚动升级配置（以 Cluster API 的 MachineDeployment 为例）：

apiVersion: cluster.x-k8s.io/v1beta1
kind: MachineDeployment
metadata:
  name: worker-pool-v1
spec:
  replicas: 5
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1          # 最多允许额外创建 1 个节点
      maxUnavailable: 1    # 最多允许 1 个节点不可用
  template:
    spec:
      version: v1.27.3
      minReadySeconds: 60  # 新节点就绪后等待 60 秒再继续升级

4.4 参数组合策略对比

4.5 Policy as Code 校验规则

在 OPA/Gatekeeper 策略中，通常对这三个参数做如下约束：

# 约束 maxSurge 和 maxUnavailable 不超过 1 或 33%
deny[msg] {
  input.spec.strategy.rollingUpdate.maxSurge > 1
  input.spec.strategy.rollingUpdate.maxSurge != "25%"
  msg := "maxSurge 必须 ≤ 1 或 ≤ 25%"
}

deny[msg] {
  input.spec.strategy.rollingUpdate.maxUnavailable > 1
  input.spec.strategy.rollingUpdate.maxUnavailable != "25%"
  msg := "maxUnavailable 必须 ≤ 1 或 ≤ 25%"
}

# 约束 minReadySeconds 至少 30 秒
deny[msg] {
  input.spec.template.spec.minReadySeconds < 30
  msg := "minReadySeconds 必须 ≥ 30 秒"
}

4.6 参数配置决策树

以下决策树帮助运维人员根据集群规模选择参数：

4.7 常见配置错误与避坑

• maxSurge 与 maxUnavailable 同时为 0：导致升级无法启动，因为既不能创建新节点也不能删除旧节点。
• minReadySeconds 设置过短（<10 秒）：节点可能尚未完成 CNI 插件初始化就被标记为就绪，导致 Pod 调度到未完全准备好的节点。
• 百分比计算向下取整：当节点数较少时（如 3 个节点，25% 向下取整为 0），可能导致升级阻塞。建议小集群使用值。
• 忽略节点池扩缩容冲突：如果同时配置了自动扩缩容（Cluster Autoscaler），滚动升级期间的节点数量变化可能触发不必要的扩容或缩容。