如何让GitLab Runner Exec Shell读取config.toml中的自定义配置？

问题场景 #

在WSL2的Ubuntu 18.04环境下，用gitlab-runner exec shell <job>本地测试GitLab CI任务时，默认的源码检出目录结构会导致IDE无法识别父Git仓库。自定义config.toml配置了builds_dir和cache_dir后，执行命令时依然走默认配置，自定义目录设置完全没生效。

解决步骤 #

1. 显式指定配置文件路径
   gitlab-runner exec不会自动加载自定义的config.toml，必须通过--config参数明确指定配置文件的位置。修改执行命令如下：

gitlab-runner exec shell --config ./config.toml my-job

如果你的config.toml不在当前目录，替换./config.toml为实际的绝对路径或相对路径即可。

2. 确认配置生效
   重新执行命令后，查看输出里的仓库初始化路径，如果显示为你在config.toml中设置的builds_dir目录（比如/home/myuser/dev/gitlab-runner-files/builds/0/project-0/.git/），就说明自定义配置已经生效了。

3. 额外注意点

• 提前创建config.toml里指定的builds_dir和cache_dir目录，并且确保当前用户有读写权限，否则会抛出权限相关的错误。
• 如果你的GitLab Runner版本偏旧（比如示例中的15.10.1），可能存在参数兼容问题，建议升级到最新稳定版（如16.x系列）规避潜在问题。

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