如何在GitLab CI中通过dind将测试分支Git仓库挂载到Docker容器？

核心原因 #

在GitLab CI的DIND（Docker-in-Docker）环境中，直接使用- .:/opt/repo:rw挂载失败的本质是：DIND内部的Docker守护进程无法直接访问GitLab Runner容器的工作目录。Runner的工作目录属于Runner容器的文件系统，而DIND的Docker守护进程运行在独立的dind服务容器中，两者文件系统默认不共享，因此相对路径.对DIND内的容器无效。

解决方案步骤 #

1. 配置GitLab CI的DIND服务挂载 #

在gitlab-ci.yml中，修改DIND服务配置，将Runner的工作目录挂载到dind容器内的固定路径：

services:
  - name: docker:dind
    command: ["--storage-driver=overlay2"]
    volumes:
      - ./:/opt/repo-host:rw  # 将Runner的代码目录挂载到dind容器内的/opt/repo-host

variables:
  DOCKER_HOST: tcp://docker:2375/
  DOCKER_DRIVER: overlay2
  DOCKER_TLS_CERTDIR: ""  # 禁用TLS简化配置，生产环境可按需开启

2. 修改docker-compose.yml的挂载路径 #

将原来的相对路径.替换为dind容器内的挂载路径/opt/repo-host，让DIND内的容器能识别到该目录：

services:
  # 替换为你的服务名称
  your-target-service:
    build: .
    volumes:
      - /opt/repo-host:/opt/repo:rw

3. 权限问题处理（可选） #

如果容器内访问挂载目录时出现权限报错，可在GitLab CI的job步骤中提前调整目录权限：

test-job:
  stage: test
  script:
    - chmod -R 755 ./
    - docker-compose up -d
    # 后续测试命令

验证方式 #

容器启动后，进入容器执行ls /opt/repo，若能看到Git仓库的完整文件列表，说明挂载成功。

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