如何在docker-compose的GitLab Runner服务中为$DOCKER_VOLUMES配置多卷挂载

要通过$DOCKER_VOLUMES环境变量绑定多个卷，只需将多个卷挂载规则用空格分隔，每个规则的格式和--docker-volumes参数的取值完全一致（比如卷名:容器内路径或主机绝对路径:容器内路径）。

具体操作示例 #

1. 先设置环境变量（Bash/Zsh 环境）

将所有需要挂载的卷规则用空格拼接后赋值给DOCKER_VOLUMES：

export DOCKER_VOLUMES="test0:/test0 test1:/test1 /host/local/path:/container/target/path"

2. 执行GitLab Runner注册命令

直接运行注册命令即可，Runner会自动读取DOCKER_VOLUMES环境变量中的配置，无需手动添加--docker-volumes参数：

gitlab-runner register \
  --url "https://gitlab.example.com/" \
  --registration-token "YOUR_REGISTRATION_TOKEN" \
  --executor "docker" \
  --docker-image "ubuntu:latest"

也可以在注册命令中直接临时设置环境变量

如果不想全局设置环境变量，可在注册命令前直接指定：

DOCKER_VOLUMES="test0:/test0 test1:/test1" gitlab-runner register \
  --url "https://gitlab.example.com/" \
  --registration-token "YOUR_REGISTRATION_TOKEN" \
  --executor "docker" \
  --docker-image "ubuntu:latest"

处理包含空格的路径 #

如果主机挂载路径包含空格，需确保规则格式正确：

• 可以用引号包裹单个路径规则：

export DOCKER_VOLUMES="/host/my folder:/container/my folder test0:/test0"

• 或用转义符处理空格：

export DOCKER_VOLUMES="/host/my\ folder:/container/my\ folder test0:/test0"

验证配置 #

注册完成后，可查看Runner的配置文件（默认路径为/etc/gitlab-runner/config.toml），对应的[[runners]]段下会生成类似以下的配置：

[[runners]]
  # 其他配置...
  executor = "docker"
  [runners.docker]
    image = "ubuntu:latest"
    volumes = ["/host/my folder:/container/my folder", "test0:/test0", "test1:/test1"]
    # 其他Docker配置...

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