📚 课程目录第4章 HPA核心参数详解（上）

4. HPA 核心参数详解（上）：minReplicas、maxReplicas、targetCPUUtilizationPercentage 的配置与影响

HPA（Horizontal Pod Autoscaler）的弹性伸缩行为由一组核心参数直接控制。本章聚焦于最基础的三个参数：minReplicas、maxReplicas 和 targetCPUUtilizationPercentage。理解它们的配置逻辑与相互影响，是后续调优与压测验证的基石。

4.1 参数定义与作用域

这三个参数共同定义了 HPA 的伸缩边界与触发条件。下表从配置位置、数据类型、默认值及核心作用四个维度进行对比：

参数名	配置位置（YAML 路径）	数据类型	默认值	核心作用
minReplicas	`spec.minReplicas`	int32	1（未显式设置时）	定义 Pod 副本数的下限，防止缩得过低导致服务容量不足
maxReplicas	`spec.maxReplicas`	int32	无默认值（必须显式设置）	定义 Pod 副本数的上限，防止无限扩容耗尽集群资源
targetCPUUtilizationPercentage	`spec.targetCPUUtilizationPercentage`	int32	80（Kubernetes 1.18+ 推荐使用 `metrics` 字段替代）	触发伸缩的目标 CPU 利用率百分比，HPA 通过当前利用率与目标值的比值计算期望副本数

版本提示：在 Kubernetes 1.18 及更高版本中，推荐使用 spec.metrics[*].resource.target.averageUtilization 替代 targetCPUUtilizationPercentage。但后者在旧版本及大量生产环境中仍广泛使用，且其计算逻辑与新版一致，理解它有助于掌握 HPA 的核心算法。

4.2 参数配置示例与 YAML 结构

以下是一个典型的 HPA 配置清单，展示了三个参数的实际位置：

apiVersion: autoscaling/v1
kind: HorizontalPodAutoscaler
metadata:
  name: web-app-hpa
  namespace: production
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: web-app
  minReplicas: 3
  maxReplicas: 20
  targetCPUUtilizationPercentage: 70

  配置要点：
  minReplicas 建议 ≥ 2：单副本场景下，Pod 故障会导致服务完全中断。生产环境至少保留 2 个副本以保证基础容灾。
maxReplicas 需结合资源配额设置：上限过高可能导致集群资源被单个应用耗尽，建议不超过集群节点可分配 CPU 总量的 50%。
targetCPUUtilizationPercentage 不宜过低或过高：过低（如 30%）会导致频繁扩容，浪费资源；过高（如 95%）则留给突发流量的缓冲空间不足，容易触发限流。

4.3 参数间的联动关系与影响

这三个参数并非独立工作，它们通过 HPA 的期望副本数计算公式产生联动。公式如下：

期望副本数 = ceil( 当前副本数 × ( 当前 CPU 利用率 / 目标 CPU 利用率 ) )

最终副本数会被 minReplicas 和 maxReplicas 钳制：

最终副本数 = max( minReplicas, min( maxReplicas, 期望副本数 ) )

下图直观展示了参数间的约束关系与伸缩决策流程：

4.4 参数配置不当的典型场景与影响

错误的参数配置可能导致伸缩行为异常。下表总结了三种常见问题场景及其后果：

问题场景	参数配置	实际影响	推荐调整
缩容过度	`minReplicas: 1`，且目标利用率设置过高	流量低谷时副本数降至 1，一旦流量突增，HPA 扩容响应延迟，导致请求超时或错误率上升	将 `minReplicas` 提升至 2~3，预留基础冗余
扩容无度	`maxReplicas` 设置过大（如 100），且未配合资源配额	突发流量时副本数急剧膨胀，耗尽集群节点资源，导致其他服务被驱逐或节点过载	根据集群总资源设定 `maxReplicas`，建议单应用不超过集群 CPU 总量的 30%~50%
频繁震荡	`targetCPUUtilizationPercentage` 设置过低（如 30%）	CPU 利用率轻微波动即可触发扩容/缩容，Pod 频繁创建和销毁，影响应用稳定性并增加 API Server 负载	将目标利用率提升至 50%~80%，并结合 `--horizontal-pod-autoscaler-downscale-stabilization` 参数增加缩容稳定窗口

生产环境警告：切勿在生产集群中直接使用默认值而不加验证。默认的 minReplicas: 1 在单点故障场景下会导致服务完全不可用；默认的 targetCPUUtilizationPercentage: 80 对于延迟敏感型应用可能过高，建议从 50%~70% 开始压测验证。

4.5 参数调优的初始建议值

基于生产环境经验，以下是一组适用于大多数 Web 服务和微服务的初始参数建议：

minReplicas：2~3（根据服务重要性调整，关键服务建议 3 以上）
maxReplicas：集群节点数 × 每节点可分配 Pod 数的 50%（例如 10 节点集群，每节点 10 Pod，则上限设为 50）
targetCPUUtilizationPercentage：50%~70%（根据应用 CPU 密集程度调整，IO 密集型可适当降低，计算密集型可适当提高）