Gitlab Runner配置问题：docker+machine执行器无法挂载Docker卷

核心问题分析 #

你当前的配置逻辑存在两处关键错误：

• [runners.docker] 下的 volumes：作用是让子Runner实例上运行的CI Job容器挂载子Runner本地的目录，而非挂载Runner管理器的目录。
• [runners.machine] 下的 volumes：GitLab Runner 的 machine 配置段不存在该参数，此配置完全无效，不会对Docker Machine创建的EC2实例产生任何作用。

Docker Machine创建的是独立的EC2云实例，和Runner管理器是完全分离的主机，无法通过简单的volumes配置直接挂载管理器的本地目录。

解决方案 #

根据你的需求（将管理器/root/.docker/下的文件同步到子Runner实例），提供两种可行方案：

方案1：通过Cloud-Init（User Data）同步文件 #

在MachineOptions中添加自定义用户数据，让EC2实例启动时自动从管理器拉取目标目录内容：

1. 在Runner管理器上创建userdata.sh脚本：

   #!/bin/bash
   mkdir -p /root/.docker/
   # 从管理器拉取文件（需确保EC2实例能访问管理器IP）
   curl -o /root/.docker/newfile.txt http://[你的管理器IP]/newfile.txt
   # 若使用S3存储该目录内容，也可替换为：
   # aws s3 cp s3://your-bucket/.docker/ /root/.docker/ --recursive
   

2. 修改config.toml的MachineOptions，添加用户数据配置：

   [[runners]]
     # 其他原有配置保持不变
     [runners.machine]
       # 其他原有配置保持不变
       MachineOptions = [
         # 原有选项保持不变
         "amazonec2-userdata=file:///root/userdata.sh" # 添加此行
       ]
   

3. 重启GitLab Runner服务：gitlab-runner restart，之后重新创建子Runner实例。

方案2：预配置自定义AMI #

将/root/.docker/的内容预装到EC2 AMI中，让Docker Machine创建的所有子Runner实例自带该目录内容：

1. 启动临时EC2实例，基于你当前使用的amazonec2-ami镜像
2. 在实例中配置/root/.docker/目录及所需文件
3. 创建该实例的自定义AMI
4. 修改config.toml中的amazonec2-ami参数为新的AMI ID

配置修正 #

请删除[runners.machine]下无效的volumes配置项，避免后续混淆。

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