GitLab Runner Docker执行器拉取Helper镜像授权失败求助

核心问题 #

你遇到的错误是GitLab Runner在拉取官方gitlab-runner-helper镜像时认证失败，这个过程和你job里的before_script中的docker登录无关——拉取helper镜像是Runner自身的操作，不属于job执行阶段的步骤，job里的登录仅影响你私有仓库镜像的拉取。

具体解决方法 #

• 检查Runner的注册配置：
  确保Runner注册时用的令牌有效；如果是用个人访问令牌配置Runner权限，令牌必须具备read_registry权限。若账号开启了2FA，必须使用个人访问令牌而非密码，且令牌权限要覆盖镜像拉取需求。
• 排查Runner所在环境的网络：
  自托管Runner的机器需能正常访问GitLab容器仓库，检查是否有防火墙、代理阻断请求，或DNS解析是否正常。
• 调整Runner的镜像拉取策略（临时缓解）：
  编辑Runner的config.toml文件，将pull_policy从always改为if-not-present，Runner只会在本地无镜像时尝试拉取，可避免重复触发认证问题，但这只是临时方案，仍需解决根本的认证问题。
• 配置Runner自身的认证：
  如果Runner需要通过特定认证访问GitLab容器仓库，要在config.toml的[[runners.docker]]节点下配置registry_auth相关参数，而非依赖job里的登录命令。

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