GitLab中config.toml存放位置是哪里？需放在项目根目录还是Runner服务端？

首先明确：你提到的config.toml是 GitLab Runner 专属的实例级配置文件，不能放在项目仓库根目录，放在项目根目录的话流水线完全不会识别读取。

正确存放路径说明 #

• 如果你使用Linux系统部署GitLab Runner，默认配置文件路径就是/etc/gitlab-runner/config.toml，你不需要手动新建路径，GitLab Runner安装完成后该路径和文件会自动生成，直接修改该文件即可。
• 如果你是其他操作系统部署的Runner，对应默认路径如下：
  • macOS：~/.gitlab-runner/config.toml
  • Windows：C:\GitLab-Runner\config.toml
  • Docker部署的Runner：配置文件在容器内部的/etc/gitlab-runner/config.toml路径，你可以在启动容器时通过挂载卷的方式将本地配置映射到该路径，避免容器重建后配置丢失。

额外注意事项 #

• 修改完config.toml后需要重启GitLab Runner服务才能生效，Linux下重启命令为gitlab-runner restart
• 项目级的流水线配置只需要存放在仓库根目录的.gitlab-ci.yml中即可，和Runner的config.toml是完全独立的两类配置，不要混淆。

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