如何持久化设置GitLab Runner标签？values.yaml配置失效排查

一、values.yaml中标签不生效的原因 #

1. 注册覆盖策略默认关闭：GitLab Runner Helm Chart默认不会覆盖已注册Runner在GitLab服务器端的配置。若你之前通过GitLab UI手动修改过标签，后续即使在values.yaml中配置了tags，Runner重启或Helm升级时，默认不会用本地配置覆盖服务器端已有的标签设置——这是因为默认runners.registrationOverride参数为false，仅首次注册时会将values中的标签同步到GitLab。
2. 配置层级错误：需确认values.yaml中的标签配置是否在正确层级下。GitLab Runner Helm Chart的正确标签配置路径是runners.tags，若写错层级（比如写成runner.tags），配置将无法被识别。
3. Runner未重新注册：若Runner已完成注册，后续启动时默认不会重新执行注册流程，values.yaml中的新标签配置也就无法同步到GitLab服务器。

二、标签持久化的解决方法 #

1. 开启注册覆盖功能 #

在values.yaml中添加或修改以下配置，让Runner每次重启/Helm升级时，强制用本地配置覆盖GitLab服务器端的标签设置：

runners:
  registrationOverride: true
  tags: "testing" # 多个标签用逗号分隔，示例："testing,ci,build"

修改后执行Helm升级命令：

helm upgrade gitlab-runner gitlab/gitlab-runner -n gitlab-runner -f values.yaml

这样即使服务器重启，Runner重新注册时会自动同步values中的标签，覆盖UI端的修改。

2. 锁定Runner防止手动修改 #

若不需要在UI端修改标签，可以设置runners.locked: true，此时GitLab UI中将无法修改该Runner的标签，避免手动操作导致配置不一致：

runners:
  locked: true
  tags: "testing"
  registrationOverride: true

3. 确保首次注册配置正确 #

若是新部署的Runner，首次部署时就配置好正确的tags和registrationOverride: true，从根源上避免后续手动修改的需求，防止标签被重置。

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