GitLab流水线：如何实现仅在单元测试通过后推送正确构建镜像

核心问题分析 #

你遇到的问题本质是执行顺序控制和产物隔离没做好：

• 用needs会让推送任务与单元测试并行，跳过测试失败的阻断逻辑；
• 移除needs后默认拉取所有前置任务的产物，若单元测试任务生成了同名镜像文件，会覆盖构建任务的产物；
• dependencies本身用法没错，但需要配合阶段划分和产物路径隔离才能生效。

满足需求的配置方案 #

通过阶段划分控制执行顺序，产物路径隔离避免覆盖，精准依赖指定确保只拉取构建产物，同时保留测试失败时的结果文件。

stages:
  - build
  - test
  - deploy

# 构建镜像任务
build-image:
  stage: build
  script:
    # 示例构建命令：将镜像导出到独立路径，避免与测试产物冲突
    - docker build -t my-app .
    - mkdir -p ./build-artifacts
    - docker save -o ./build-artifacts/app-image.tar my-app
  artifacts:
    paths:
      - ./build-artifacts/ # 构建产物单独存放
    expire_in: 1h # 按需设置过期时间
  rules:
    - if: $CI_COMMIT_BRANCH == 'main' # 按需调整触发规则

# 单元测试任务
unit-test:
  stage: test
  script:
    # 示例测试命令：将测试结果输出到独立路径
    - npm test -- --reporter junit --output ./test-results/results.xml
  artifacts:
    paths:
      - ./test-results/ # 测试结果单独存放
    when: always # 无论测试成功/失败，都保留测试结果
    expire_in: 1d
  rules:
    - if: $CI_COMMIT_BRANCH == 'main'
  # 默认allow_failure: false，测试失败直接终止流水线

# 推送镜像任务
push-to-harbor:
  stage: deploy
  script:
    # 仅加载构建任务的镜像文件
    - docker load -i ./build-artifacts/app-image.tar
    - docker tag my-app harbor.example.com/my-app:$CI_COMMIT_SHA
    - docker push harbor.example.com/my-app:$CI_COMMIT_SHA
  dependencies:
    - build-image # 明确只拉取构建任务的产物，忽略测试任务的
  rules:
    - if: $CI_COMMIT_BRANCH == 'main'

配置逻辑说明 #

1. 阶段划分：通过stages定义build→test→deploy的顺序，确保只有前一阶段所有任务成功，才会执行下一阶段。这样单元测试失败时，推送任务会直接被阻断。
2. 产物隔离：构建产物和测试结果分别存放在./build-artifacts/和./test-results/两个独立路径，避免文件覆盖。
3. 依赖控制：推送任务通过dependencies: [build-image]仅拉取构建任务的产物，彻底避免获取到测试任务生成的文件。
4. 测试结果保留：单元测试任务的artifacts.when: always配置，确保无论测试成功或失败，都会上传测试结果文件。

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