GitLab Job中Docker Compose无法找到指定文件问题求助

我来帮你梳理排查这个问题——在GitLab CI使用Docker执行器、挂载了docker.sock的场景下，官方run.sh脚本找不到docker-compose.lint.yml，大概率和文件拉取状态、工作目录匹配或者脚本路径引用有关，下面是具体的排查和解决步骤：

1. 先确认：项目文件真的被克隆到Runner容器了吗？ #

GitLab CI默认会在任务启动时克隆整个仓库，但偶尔会因为配置规则导致文件缺失：

• 先在任务中加前置命令，验证文件是否存在：

  before_script:
    # 查看当前目录结构
    - ls -la
    # 全局搜索目标文件
    - find . -name "docker-compose.lint.yml"
  

• 检查Runner的GIT_STRATEGY配置：如果设置为none或者fetch且缓存异常，会导致仓库未完整克隆。确保该配置为clone（默认值），或者在gitlab-ci.yml中显式声明：

  variables:
    GIT_STRATEGY: clone
  

2. 检查run.sh脚本的路径引用逻辑 #

官方run.sh默认会从当前工作目录加载docker-compose配置文件，如果你的docker-compose.lint.yml不在脚本执行时的工作目录下，就会找不到：

• 显式指定配置文件路径调用run.sh，避免路径歧义：

  # 假设yml文件在项目根目录，run.sh在script/run/下
  ./script/run/run.sh -f ./docker-compose.lint.yml [你的lint命令]
  

• 本地模拟测试：用任务镜像启动容器，挂载你的项目目录，手动执行run.sh命令，验证是否能找到文件——这能快速排除脚本本身的逻辑问题。

3. 确认Docker执行器的工作目录 #

GitLab CI Docker执行器的默认工作目录是/builds/<你的群组>/<你的项目>，但如果你的任务镜像中设置了WORKDIR，可能会导致路径混乱：

• 在脚本中加入pwd命令，确认当前工作目录：

  script:
    - pwd
    - ./script/run/run.sh ...
  

• 如果工作目录和yml文件所在目录不一致，要么调整脚本调用时的路径，要么在gitlab-ci.yml中用cd命令切换到正确目录后再执行run.sh。

4. 关于docker.sock挂载的额外排查 #

挂载docker.sock是让Runner容器调用宿主机的Docker daemon，一般不会影响文件查找，但如果run.sh脚本是通过启动新的Docker容器来执行lint，需要确保docker-compose.lint.yml所在目录被正确挂载到那个临时容器中——不过官方run.sh默认是直接在Runner容器内读取配置，这个场景概率较低，但可以检查yml文件中的volumes配置是否正确。

额外提醒：任务镜像不要包含项目文件 #

如果你的任务镜像Dockerfile中用COPY命令把项目文件打包进去，会和GitLab CI克隆的仓库文件冲突，导致路径混乱。任务镜像应该只包含运行环境（比如Docker、docker-compose等依赖），项目文件由CI自动克隆到Runner容器中。

举个修正后的gitlab-ci.yml片段示例：

lint-docker-compose:
  stage: lint
  image: your-task-environment-image:latest
  variables:
    GIT_STRATEGY: clone
  before_script:
    - pwd
    - find . -name "docker-compose.lint.yml"
  script:
    - ./script/run/run.sh -f ./docker-compose.lint.yml lint
  tags:
    - docker-executor-runner

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