GitLab Shell Runner为何调用su命令？CI任务提示su不存在

为什么会触发su调用？ #

GitLab Shell Runner执行su命令主要有两种场景：

• Runner配置指定切换用户：如果你的Runner配置文件（通常是/etc/gitlab-runner/config.toml）中设置了user字段，指定了非Runner进程当前运行的用户，Runner会在准备环境阶段自动调用su切换到该用户执行CI任务。比如Runner以root启动，但配置里写了user = "gitlab-runner"，就会触发su完成用户切换操作。
• CI任务脚本显式调用：如果你的.gitlab-ci.yml或任务脚本里有手动切换用户的命令（比如su - someuser），也会触发su调用，但你这个报错出现在准备环境阶段，所以大概率是前者的配置问题。

解决思路 #

1. 检查Runner配置
   打开/etc/gitlab-runner/config.toml，查找user配置项：
   • 如果存在该字段，要么确保系统中su命令存在且在Runner的$PATH中（部分最小化安装的Linux系统可能未预装su，需要安装coreutils包）；
   • 要么删除user字段，或者将其改为Runner当前运行的用户，让Runner直接以自身用户执行任务，避免切换操作。
2. 验证su命令路径
   手动执行which su确认命令位置（通常是/bin/su或/usr/bin/su），然后检查Runner运行用户的$PATH是否包含该目录。可以通过echo $PATH查看当前用户的PATH，或者在Runner启动脚本中添加该路径到环境变量。

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