GitLab父子流水线构建目录异常及子流水线路径传递问题咨询

背景配置 #

Runner配置（config.toml） #

[runners.custom_build_dir]
   enabled = true
builds_dir = "//opt/app/abc"

父流水线配置（.gitlab-ci.yml） #

variables:
  GIT_CLONE_PATH: $CI_BUILDS_DIR/$CI_PROJECT_PATH/project/pipeline

stages:
  - build
  - trigger-services

trigger_s1:
  interruptible: false
  stage: trigger-services
  needs: [build]
  trigger:
    include: s1.gitlab-ci.yml
    strategy: depend
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
      changes:
        paths:
          - abc/**/*          
      allow_failure: false

子流水线配置（s1.gitlab-ci.yml） #

variables:
  GIT_CLONE_PATH: $CI_BUILDS_DIR/$CI_PROJECT_PATH/project/pipeline

workflow:
  rules:
    - if: $CI_PIPELINE_SOURCE == "parent_pipeline"

stages:
  - test

test:
  stage: test
  script: 
    - echo "Running the Unit Test Cases!"

问题解答 #

1. 克隆目录随机切换为/home/abc或/opt/abc #

原因及解决：

• 共享Runner被其他项目/开发者使用，他们的作业用git strategy none自定义了检出目录，导致Runner的builds_dir被临时覆盖，作业环境残留了其他配置。
• 配置中builds_dir = "//opt/app/abc"的双斜杠写法存在解析歧义，部分系统会将其处理为相对路径或默认到用户home目录下的abc文件夹。
• 解决：将config.toml中的builds_dir改为单斜杠的绝对路径builds_dir = "/opt/app/abc"；给项目配置专属Runner标签，避免与其他项目共享Runner，从根源隔离环境。

2. 子流水线报错GIT_CLONE_PATH不在指定路径内，如何清理重置路径 #

GitLab Runner本身不会缓存克隆路径，但复用的作业环境（Shell executor未清理、Docker容器复用）会残留之前作业的环境变量或目录结构，导致路径校验失败。解决方法：

• 强制清理路径：在父、子作业的before_script中添加清理命令，确保路径纯净：

  - rm -rf $CI_BUILDS_DIR/$CI_PROJECT_PATH
  - mkdir -p $GIT_CLONE_PATH
  

• 隔离Runner环境：为项目配置专属Runner，添加标签后在流水线中指定tags，避免共享带来的冲突。
• 修复变量传递：在父流水线的trigger作业中显式传递GIT_CLONE_PATH，子流水线直接使用该变量，避免重新解析时出错。
• 检查Runner executor配置：如果用Shell executor，确保Runner用户对/opt/app/abc有读写权限；如果用Docker executor，设置pull_policy = "always"并禁用缓存，避免复用旧容器。

3. 如何将正确仓库传递给子作业 #

有三种可靠方式：

• 显式传递克隆路径变量：在父流水线的trigger作业中直接传递GIT_CLONE_PATH，子流水线无需重新定义，直接使用该变量：

  trigger_s1:
    interruptible: false
    stage: trigger-services
    needs: [build]
    trigger:
      include: s1.gitlab-ci.yml
      strategy: depend
    variables:
      GIT_CLONE_PATH: $GIT_CLONE_PATH
    rules:
      - if: $CI_PIPELINE_SOURCE == "merge_request_event"
        changes:
          paths:
            - abc/**/*          
        allow_failure: false
  

• 通过Artifact传递代码：父作业在build阶段完成后，将代码打包为artifact，子流水线通过needs下载后直接使用，无需重新克隆：
  父流水线添加build作业：

  build:
    stage: build
    script:
      # 你的构建逻辑
    artifacts:
      paths:
        - $GIT_CLONE_PATH/**/*
      expire_in: 1h
  

  子流水线test作业修改：

  test:
    stage: test
    needs: [build]
    variables:
      GIT_STRATEGY: none
    script: 
      - cd $GIT_CLONE_PATH
      - echo "Running the Unit Test Cases!"
  

• 直接复用父作业的克隆结果：子流水线设置GIT_STRATEGY: none，跳过克隆步骤，直接使用父作业已经克隆好的路径（需确保父、子作业在同一Runner上运行，且路径未被清理）：

  test:
    stage: test
    variables:
      GIT_STRATEGY: none
      GIT_CLONE_PATH: $GIT_CLONE_PATH
    script: 
      - cd $GIT_CLONE_PATH
      - echo "Running the Unit Test Cases!"
  

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