如何修改GitLab Runner的冗长构建路径

我完全懂你遇到的麻烦——默认的GitLab Runner构建路径确实冗余又不直观，一堆token字符和层级目录看着就闹心。要改成你想要的/home/gitlab-runner/customName/my_project_name，得结合Runner全局配置和项目CI脚本一起调整，具体步骤如下：

1. 准备自定义目录并调整Runner权限 #

先创建目标目录，确保GitLab Runner用户能读写：

sudo mkdir -p /home/gitlab-runner/customName
sudo chown gitlab-runner:gitlab-runner /home/gitlab-runner/customName

2. 修改GitLab Runner的全局配置文件 #

编辑/etc/gitlab-runner/config.toml，找到对应Runner的[[runners]]段落，添加或修改builds_dir字段（如果用缓存的话也可以同步调整cache_dir）：

[[runners]]
  name = "你的DigitalOcean Runner名称"
  url = "https://gitlab.com/" # 替换成你的GitLab实例地址
  token = "你的Runner授权Token"
  executor = "shell" # 如果你用的是shell执行器，其他执行器逻辑类似
  builds_dir = "/home/gitlab-runner/customName"
  cache_dir = "/home/gitlab-runner/customName/cache" # 可选，按需添加

修改完成后重启Runner服务生效：

sudo gitlab-runner restart

3. 在项目CI脚本中指定克隆路径 #

光改Runner配置还不够，因为默认情况下Runner会在builds_dir下自动创建带token和项目ID的子目录。要跳过这一层，在项目根目录的.gitlab-ci.yml里添加GIT_CLONE_PATH变量，直接指定项目的克隆路径：

variables:
  GIT_CLONE_PATH: $CI_BUILDS_DIR/my_project_name

这样一来，Runner执行流水线时就会直接把项目拉取到/home/gitlab-runner/customName/my_project_name下，完全符合你的需求。

额外注意点 #

• 如果你的项目有多分支并行构建，建议在GIT_CLONE_PATH里加上分支名（比如$CI_BUILDS_DIR/my_project_name/$CI_COMMIT_BRANCH），避免不同分支的构建文件互相覆盖。
• 确认gitlab-runner用户对自定义目录有完整的读写权限，不然会出现克隆失败或构建报错的情况。

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