为何升级Helm Release修改GoCD Agent副本数后未生效？

GoCD官方Helm Chart默认部署1个Server Pod和0个Agent Pod。执行以下命令查看默认配置：

helm show values gocd/gocd

可看到Agent相关配置：

# agent.replicaCount is the GoCD Agent replicas Count. Specify the number of GoCD agents to run
replicaCount: 0

执行升级命令尝试启动1个Agent：

helm upgrade --install gocd gocd/gocd -n gocd --set replicaCount=1

命令输出显示发布成功：

Release "gocd" has been upgraded. Happy Helming!
NAME: gocd
LAST DEPLOYED: Fri Mar 21 14:30:47 2025
NAMESPACE: gocd
STATUS: deployed
REVISION: 2

但查看集群Pod状态时，Agent Pod仍未运行：

gocd-agent-65979fd7dc               0         0         0       9m48s
gocd-server-7b58d6ccd4              1         1         1       9m48s

原因分析 #

问题出在--set参数的层级错误。从默认配置的注释可知，replicaCount是agent节点下的子配置项，正确的参数路径应为agent.replicaCount，而非直接设置顶层的replicaCount。

直接设置replicaCount=1并未修改到Agent的副本数配置，Agent仍使用默认的0值，因此Pod无法启动。

解决方法 #

执行包含正确参数路径的升级命令：

helm upgrade --install gocd gocd/gocd -n gocd --set agent.replicaCount=1

执行完成后再次检查Pod状态，即可看到Agent Pod正常启动运行。

内容的提问来源于stack exchange，提问作者MikiBelavista