GitLab CI流水线中挂载Docker卷始终为空的问题求助

核心原因 #

你用的独立Docker实例和GitLab Runner的运行环境属于完全隔离的文件系统空间：

• GitLab Runner运行在Kubernetes Pod中，/builds目录是Pod本地存储（或绑定的集群PVC）；
• 你指定的DOCKER_HOST对应的独立Docker服务，其宿主环境（无论是单独的K8s Pod还是物理节点）和Runner Pod的文件系统不共享，所以当你在Runner里执行docker run -v /builds/xxx:/mnt时，这个/builds/xxx是独立Docker宿主环境里的路径，而非Runner Pod内的路径，自然显示为空。

可行解决方案 #

方案1：用共享PVC打通存储

通过集群共享存储（如NFS、EBS、Ceph等）让Runner和独立Docker能访问同一份代码：

1. 在Kubernetes中创建一个共享PVC；
2. 同时将该PVC挂载到GitLab Runner Pod和独立Docker实例的Pod中，挂载路径保持一致（比如都挂到/shared-builds）；
3. 修改流水线脚本，先把代码从Runner的/builds复制到共享路径：

   script:
     - cp -r /builds/$CI_PROJECT_PATH/* /shared-builds/
     - export DOCKER_COMPOSE_CMD="docker-compose -f docker-compose-test.yml"
     - $DOCKER_COMPOSE_CMD down --volumes --remove-orphans
     - $DOCKER_COMPOSE_CMD build
     - $DOCKER_COMPOSE_CMD --env-file .env.pipeline up -d
     - $DOCKER_COMPOSE_CMD exec -T -e APP_ENV=testing laravel-api-test sh -c "ls /var/www/html"
   

4. 同步修改docker-compose-test.yml的卷配置：

   volumes:
     - /shared-builds:/var/www/html
   

方案2：切换GitLab Runner的Docker Executor

如果可以调整Runner类型，改用Docker Executor而非Kubernetes Executor，配置Runner和DinD容器共享卷：

1. 修改Runner的配置文件：

   volumes = ["/cache", "/builds:/builds", "/var/run/docker.sock:/var/run/docker.sock"]
   

2. 这样Runner执行docker命令时，挂载的/builds路径和DinD容器内的路径完全一致，文件就能正常被访问。

方案3：容器内动态拉取代码（替代挂载）

如果挂载卷只是为了获取最新代码，可以在测试容器启动时直接拉取仓库内容：

services:
  laravel-api-test:
    build:
      context: .
      dockerfile: docker/development/Dockerfile
    command: sh -c "git clone $CI_REPOSITORY_URL /var/www/html && cd /var/www/html && git checkout $CI_COMMIT_SHA && ls"
    environment:
    - COMPOSER_MEMORY_LIMIT=-1
    - CI_REPOSITORY_URL=${CI_REPOSITORY_URL}
    - CI_COMMIT_SHA=${CI_COMMIT_SHA}

注意：需要确保容器内安装了Git，并且能通过SSH密钥或HTTPS访问GitLab仓库（可挂载Runner的~/.ssh密钥文件）。

快速验证方法 #

不管用哪种方案，都可以先跑以下测试脚本验证路径连通性：

script:
  - echo "test content" > /shared-builds/test.txt
  - docker run -v /shared-builds:/mnt ubuntu cat /mnt/test.txt

如果能输出test content，说明存储挂载正常。

内容的提问来源于stack exchange，提问作者A. Vreeswijk