如何配置gitlab-runner使用指定路径的git二进制文件

你的配置报错根源是GitLab Runner的environment配置项默认不会解析$PATH这类Shell动态变量，你写的$PATH会被当成普通字符串处理，最终PATH里没有系统命令路径，才会出现mkdir找不到的问题。以下是3种可行的配置方法：

方案1：配置pre_clone_script（推荐，Shell执行器适配最佳） #

该方案只会修改代码拉取阶段的PATH，不会污染后续任务的环境变量，兼容性最好：

• 打开/etc/gitlab-runner/config.toml，找到对应Shell执行器的[[runners]]配置块
• 删除之前添加的错误environment配置行
• 新增如下配置：

pre_clone_script = "export PATH=/opt/gitlab/embedded/bin:$PATH"

• 重启服务生效：gitlab-runner restart

方案2：直接拼接完整PATH（适合需要全局生效的场景） #

如果要让整个Runner任务生命周期都优先用GitLab自带的工具链，可以直接把系统完整PATH拼在配置里：

• 先在服务器执行echo $PATH获取当前系统完整PATH，示例输出为/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin
• 在[[runners]]块中配置：

environment = ["PATH=/opt/gitlab/embedded/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin"]

• 重启Runner服务生效

方案3：软链高版本git（无需修改Runner配置） #

直接将高版本git软链到系统PATH优先级更高的路径，全局生效：

• 执行命令：ln -s /opt/gitlab/embedded/bin/git /usr/local/bin/git
• 验证配置：git --version确认输出为2.32.0即可，不需要修改任何Runner配置，流水线会自动调用高版本git。

配置完成后重新运行流水线即可解决git拉取报错问题，同时不会丢失系统基础命令路径。

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