GitLab触发子流水线时如何避免重触发父流水线并复用现有镜像？

完全可以实现外部触发子流水线时直接复用已有的Docker镜像，无需重新执行父流水线的构建任务，核心思路是传递已构建完成的镜像标识给子流水线，具体步骤如下：

• 第一步：在父流水线的镜像构建任务中，输出并留存镜像标签
  构建镜像后，把镜像的完整标签（比如包含提交哈希或流水线ID的唯一标识）保存下来，推荐用GitLab的工件（Artifacts）存储，或者直接写入CI/CD变量。示例配置：

  build-docker-image:
    stage: build
    script:
      # 生成唯一镜像标签，比如用提交短哈希
      - IMAGE_TAG="registry.example.com/my-project:${CI_COMMIT_SHA:0:8}"
      - docker build -t $IMAGE_TAG .
      - docker push $IMAGE_TAG
      # 将标签写入文件，作为工件留存
      - echo $IMAGE_TAG > .image-tag
    artifacts:
      paths:
        - .image-tag
      expire_in: 7 days
  

• 第二步：外部触发子流水线时传递镜像标签
  当需要触发子流水线时，通过GitLab的API调用，把之前留存的镜像标签作为自定义变量传入。示例API请求：

  curl --request POST \
    --header "PRIVATE-TOKEN: YOUR_ACCESS_TOKEN" \
    --form "variables[IMAGE_TAG]=registry.example.com/my-project:abc12345" \
    "https://your-gitlab-instance/api/v4/projects/YOUR_PROJECT_ID/pipeline"
  

• 第三步：子流水线直接使用传入的镜像
  在子流水线的.gitlab-ci.yml中，直接引用传入的IMAGE_TAG变量来拉取已有镜像执行任务，无需重新构建：

  run-post-process:
    stage: execute
    image: $IMAGE_TAG
    script:
      - echo "复用已构建镜像执行后续流程"
      - # 这里写你的后续业务命令
  

• 关键注意事项

  • 确保子流水线的Runner有权限访问镜像所在的仓库（比如GitLab Container Registry需要配置Runner的拉取权限）
  • 镜像标签建议使用唯一标识（如提交哈希、流水线ID），避免不同版本镜像混淆
  • 外部触发时要做好权限校验，使用有权限的个人访问令牌（PAT）发起请求

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