Go应用实现HPA自动扩缩容需满足三大前提:显式配置resources.requests(如cpu: 100m)、暴露Prometheus格式/metrics端点、正确设置readinessProbe(避免检查外部依赖),缺一即导致HPA失效,CURRENT显示。

Go语言本身不设置HPA策略,Kubernetes的HorizontalPodAutoscaler是独立控制器,Go应用只需满足几个硬性前提,HPA才能正常工作。你写的Go代码里不需要写“扩缩容逻辑”,重点是让HPA能采集到指标、算得清利用率、等得到就绪状态。
必须显式配置 resources.requests
这是HPA能工作的底线。没设requests,HPA直接跳过该Pod,CURRENT列永远显示,DESIRED也不会变。
-
requests必须写在Deployment.spec.template.spec.containers[].resources.requests下,例如:cpu: 100m、memory: 128Mi - 只设
limits不设requests会报错:failed to get cpu utilization: missing request for cpu - HPA计算利用率时,分母是
requests,不是节点总资源,也不是limits;设太高会导致扩不及时,设太低可能被调度器拒绝
暴露/metrics端点才能用自定义指标
仅靠CPU/内存扩缩,对IO密集或异步处理型Go服务容易失真。想按QPS、延迟或队列长度伸缩,就得让Prometheus能采集到指标。
- 用
prometheus/client_golang注册/metricshandler,确保它在容器内可访问(比如监听:8080) -
Service的targetPort必须和容器实际监听端口一致,否则metrics-server或prometheus-adapter拉不到数据 - 若用external metrics(如Kafka Lag),需额外部署
prometheus-adapter或keda,并确认其能连通你的指标源
readinessProbe和livenessProbe配置不当会卡住扩缩容
HPA扩容后,新Pod必须通过readinessProbe才能收流量;缩容前,Kubernetes会等livenessProbe失败或收到SIGTERM再优雅退出。探针配错,扩缩容就卡住或误杀。
-
readinessProbe.httpGet.path建议指向/healthz,且只检查本地依赖(DB连接池、Redis客户端),不要调下游服务 -
initialDelaySeconds要≥ Go服务冷启动耗时(比如建连接池、加载配置),否则Pod反复重启 -
livenessProbe不宜太激进(如initialDelaySeconds: 5),低负载下可能误重启
创建HorizontalPodAutoscaler时字段不能漏
用kubectl apply或client-go创建HPA时,v2版本(推荐)要求显式声明所有关键字段,漏一个就创建失败或不生效。
-
scaleTargetRef.kind必须是Deployment(不能写deployment或deploy),name必须和目标Deployment完全一致 - 若用
type: External,必须同时提供external.metricName和external.target.averageValue,漏任一字段报Invalid value: "null" - HPA默认每15秒同步一次状态,首次生效可能有延迟;用
kubectl get hpa看CURRENT是否从变成具体数值
最容易被忽略的是:resources.requests没设、/metrics端点没暴露、readinessProbe检查了外部依赖——这三个点只要一个出问题,HPA就形同虚设,而且错误日志往往藏在kubectl describe hpa的Events里,不主动查就一直卡着不动。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











