如何在GitLab流水线单个阶段中顺序执行多个隐藏作业

问题原因 #

你当前的配置无法实现顺序执行，核心原因是GitLab CI的extends机制是配置合并+后项覆盖：当一个作业继承多个模板时，同名配置项（比如before_script）会被最后一个模板的内容覆盖。你的.job:all同时继承.job1和.job2，最终before_script只会保留.job2的配置，自然只执行了job2的逻辑。

解决方法 #

方法一：合并脚本到单个作业（最简单直接） #

把多个作业的操作按顺序整合到一个作业中，用YAML锚点复用代码避免重复：

# 定义可复用的脚本片段
.job1:steps: &job1-steps
  - cd ${CI_PROJECT_DIR}/job1
  - ls

.job2:steps: &job2-steps
  - cd ${CI_PROJECT_DIR}/job2
  - ls

stages:
  - master

master:
  stage: master
  script:
    - *job1-steps
    - *job2-steps

这种方式适合不需要独立作业日志的场景，所有步骤在同一个作业中按顺序执行。

方法二：同一阶段内顺序执行独立作业 #

如果需要保留每个作业的独立性（比如单独查看每个作业的执行日志），可以在同一阶段定义多个隐藏作业，通过needs强制顺序执行：

stages:
  - master

# 核心模板，标记为隐藏作业（不自动触发）
.core:job:
  stage: master
  script:
    - ls
  rules:
    - when: never

.job1:
  extends: .core:job
  before_script:
    - cd ${CI_PROJECT_DIR}/job1
  rules:
    - when: always # 允许被触发
  needs: [] # 无依赖，作为第一个执行的作业

.job2:
  extends: .core:job
  before_script:
    - cd ${CI_PROJECT_DIR}/job2
  rules:
    - when: always
  needs: [.job1] # 必须等待.job1执行完成后再启动

# 可选：添加一个汇总作业，标记所有作业完成
master:summary:
  stage: master
  script:
    - echo "所有作业执行完成"
  needs: [.job2]

这种方式下，.job1和.job2都在master阶段，通过needs强制顺序执行，每个作业的日志独立可查。

方法三：使用trigger触发子流水线（复杂场景） #

如果作业逻辑复杂，可将多个作业定义为子流水线，在主作业中按顺序触发：

stages:
  - master

master:
  stage: master
  trigger:
    include:
      - local: .gitlab-ci-jobs.yml
    strategy: depend # 等待子流水线完成

然后在.gitlab-ci-jobs.yml中定义顺序执行的作业：

stages:
  - run-jobs

.job1:
  stage: run-jobs
  script:
    - cd ${CI_PROJECT_DIR}/job1
    - ls

.job2:
  stage: run-jobs
  script:
    - cd ${CI_PROJECT_DIR}/job2
    - ls
  needs: [.job1]

这种方式适合需要隔离作业环境或复用复杂作业逻辑的场景。

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