GitLab流水线模板中Artifacts复用异常求助

我搭建了一个包含三个步骤与模板的GitLab流水线：

• prepare作业：拉取另一个仓库，配置Artifacts如下：

artifacts:
    paths:
      - $CI_PROJECT_DIR/ingo/tests/integration_tests/*

该步骤运行正常。

• deploy作业：通过needs: - prepare确保在prepare之后执行，用于向集群部署Pod。
• test作业：执行集成测试，配置如下：

test:
  extends: 
    - .test_step
  stage: test
  needs:
    - test_deploy  
  timeout: 20 minutes
  variables:
    BUILD_VERSION: $BUILD_TIME
    TESTING_STAGE: testtemp
    TEST_FOLDER: integration_tests  
    TEST_FILES: "test_simulation.py"

test作业继承的模板.test_step配置：

.test_step:
  tags:
    - docker
  image: harbor.xxx/cache_dockerhub/python:3.8.19-slim-bookworm 
  needs:
    - job: prepare
      artifacts: true
  script:
    - cd $CI_PROJECT_DIR
    - ls

遇到的问题 #

• GitLab运行模板时，始终无法获取prepare的Artifacts。
• 尝试使用dependencies关键字时，报错：

jobs:test dependencies the prepare should be part of needs

疑问 #

是否支持在模板中复用Artifacts？或是存在配置疏漏？

核心原因：needs配置的覆盖规则 #

GitLab中，当作业通过extends继承模板的needs配置时，如果当前作业自身也定义了needs，当前作业的needs会完全覆盖模板中的配置，不会进行合并。

你的test作业自己定义了needs: - test_deploy，这直接覆盖了模板里needs: - job: prepare的配置，导致test作业不会拉取prepare的Artifacts；同时因为dependencies指定的prepare不在当前作业的needs列表中，所以触发了报错。

修复方案 #

在test作业的needs中同时包含test_deploy和prepare，并明确指定需要获取prepare的Artifacts：

test:
  extends: 
    - .test_step
  stage: test
  needs:
    - test_deploy  
    - job: prepare
      artifacts: true
  timeout: 20 minutes
  variables:
    BUILD_VERSION: $BUILD_TIME
    TESTING_STAGE: testtemp
    TEST_FOLDER: integration_tests  
    TEST_FILES: "test_simulation.py"

关键说明 #

• GitLab支持在模板中复用Artifacts，但要注意needs的覆盖规则：子作业定义needs会完全替换模板中的needs配置。
• 若需依赖多个作业的Artifacts，必须在needs中逐个声明，并通过artifacts: true明确指定要拉取的Artifacts。
• 不要同时使用dependencies和needs：当作业使用needs时，dependencies会被忽略，且若dependencies指定的作业不在needs列表中，就会触发错误。

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