GitHub Workflow中Docker-Compose卷映射失效问题求助

核心问题分析 #

你遇到的问题本质是GitHub Actions的运行环境层级导致路径映射混乱：

• 如果job使用了container选项，docker-compose是在这个job容器内部执行的，容器内的相对路径和runner主机的代码目录（/home/runner/work/<reponame>/<reponame>）不是同一个上下文
• 直接用相对路径或$PWD，只会指向job容器内的路径，而非实际的代码目录

解决方案一：放弃job级container，直接在runner主机运行docker-compose #

这是最简洁的方案，直接在ubuntu-latest runner上部署docker环境，让docker-compose和runner主机的Docker daemon交互，路径映射自然匹配：

修改后的Workflow配置 #

jobs:
  run-tests:
    name: RUN TESTS
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
      packages: read
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
      - name: 配置Docker Buildx
        uses: docker/setup-buildx-action@v3
      - name: 登录私有镜像仓库
        uses: docker/login-action@v3
        with:
          registry: <你的私有镜像仓库地址>
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}
      - name: 用docker-compose运行测试
        run: docker-compose run test-ci

保持原有docker-compose.yml不变 #

services:
  test-ci:
    build:
      context: .
      dockerfile: Dockerfile-test
    volumes:
      - ./coverage:/app/coverage
      - ./src:/app/src

此时./就是runner主机上拉取代码的目录（/home/runner/work/<reponame>/<reponame>），卷映射会正常生效。

解决方案二：必须使用job级container时的路径调整 #

如果依赖私有镜像里的环境，不能放弃job级container，需要调整多层路径映射：

步骤1：修改Workflow的container配置 #

把runner主机的代码目录挂载到job容器内的固定路径（比如/workspace），并指定工作目录：

jobs:
  run-tests:
    name: RUN TESTS
    runs-on: ubuntu-latest
    container:
      image: <our private image>
      options: -v /home/runner/work/<reponame>/<reponame>:/workspace:rw
      credentials:
        username: ${{ github.actor }}
        password: ${{ secrets.GITHUB_TOKEN }}
    permissions:
      id-token: write
      contents: read
      packages: read
    steps:
      - name: 用docker-compose运行测试
        working-directory: /workspace
        run: docker-compose run test-ci

步骤2：修改docker-compose.yml的路径 #

所有路径都使用job容器内的/workspace作为根路径：

services:
  test-ci:
    build:
      context: /workspace
      dockerfile: Dockerfile-test
    volumes:
      - /workspace/coverage:/app/coverage
      - /workspace/src:/app/src

这样docker-compose在job容器内执行时，挂载的是已经映射到runner代码目录的/workspace下的文件，就能正确找到/app/src了。

额外检查点 #

• 确认Dockerfile-test中是否有COPY src /app/src的步骤：如果有，挂载卷会覆盖容器内的目录，但如果挂载失败就会导致/app/src不存在，确保挂载路径正确的同时，可以保留该步骤作为 fallback。

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