已安装Ruby环境时Gitlab CI Pipeline运行失败如何解决？

这个问题的核心是GitLab Runner运行时的环境变量与你本地登录用户的环境变量不一致，Windows系统下shell executor默认调用PowerShell运行脚本，你本地配置的Ruby路径只对当前登录用户生效，Runner运行时读不到对应的可执行文件路径。

排查步骤 #

• 确认Runner运行身份：打开Windows服务面板（按下Win+R输入services.msc回车），找到GitLab Runner服务，右键选择「属性」→「登录」，查看服务使用的运行账户：
  • 如果使用的是「本地系统账户」，你配置的当前用户的Ruby环境变量对该账户无效
  • 如果使用的是指定用户，确认该用户的环境变量里已经配置了Ruby的bin目录路径
• 验证运行时环境变量：在你的gitlab-ci.yml的script开头临时添加一行echo $env:PATH，运行Pipeline查看输出的PATH列表中是否包含Ruby的bin目录（例如C:\Ruby32\bin），确认路径是否缺失

解决方案 #

方案1：修改Runner运行账户（推荐） #

在GitLab Runner服务的「登录」标签页，选择「此账户」，填写你平时正常使用gem命令的本地用户名和密码，保存后重启Runner服务即可。

方案2：添加系统级环境变量 #

将Ruby的bin目录路径添加到Windows系统级的环境变量PATH中，修改完成后重启GitLab Runner服务生效。注意修改系统环境变量后必须重启Runner，否则服务会继续读取启动时缓存的旧环境变量。

方案3：脚本内临时添加路径 #

在CI脚本的开头手动添加Ruby路径到环境变量，修改你的.setup_bundler锚点内容：

.setup_bundler: &setup_bundler |
  # 替换为你本地实际的Ruby bin目录路径
  $env:PATH += ";C:\Ruby32\bin"
  gem install bundler
  bundle config
  bundle install

方案4：Runner配置文件全局注入环境变量 #

打开GitLab Runner的config.toml配置文件，在对应Runner的[[runners]]配置段添加如下内容，修改后重启Runner：

[[runners]]
  # 其他原有配置保留
  environment = ["PATH=C:\\Ruby32\\bin;$PATH"] # 替换为实际Ruby bin路径，注意反斜杠需要转义

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