CI/CD / 系统课时

让多个 Job 按依赖顺序运行

让多个 Job 按依赖顺序运行

一个工作流里的 Job 默认可以并行执行,但构建、测试、部署往往存在先后约束。本节使用 needs 显式建立依赖关系,让 GitHub Actions 在保留可并行任务的同时,只在前置 Job 成功后启动下游任务。

学习目标

  • 理解 Job 默认并行执行与 needs 依赖执行的区别
  • 使用 needs 组织串行、并行和汇合式执行关系
  • 根据 Job 状态判断下游任务为什么执行或被跳过

Job 默认彼此独立

同一工作流中没有声明依赖关系的 Job,会被 GitHub Actions 视为相互独立。只要有可用 Runner,它们就可能同时开始,而不会按照 YAML 中从上到下的书写顺序等待。

因此,把 build 写在 deploy 前面并不能保证先构建后部署。真正决定 Job 依赖的是 needs。

用 needs 建立依赖

下面的工作流让 build 先运行,成功后再执行 test 和 lint;二者都成功后,deploy 才会启动。

yaml
name: job-dependencies

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Build
        run: echo "build complete"

  test:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Test
        run: echo "tests passed"

  lint:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Lint
        run: echo "lint passed"

  deploy:
    needs: [test, lint]
    runs-on: ubuntu-latest
    steps:
      - name: Deploy
        run: echo "deploy complete"

预期结果

text
build
  ├─ test ─┐
  └─ lint ─┴─ deploy

这里的文本仅表示依赖关系,实际运行日志中的 Job 开始时间和 Runner 分配信息会不同。test 与 lint 都只依赖 build,因此 build 成功后它们可以并行;deploy 同时依赖二者,所以必须等待两项完成。

needs 形成的 Job 依赖与并行关系

依赖决定执行条件

默认情况下,被 needs 引用的前置 Job 如果失败或被跳过,依赖它的下游 Job 也会被跳过。这个行为非常适合生产流水线:测试没有通过时,不应该继续部署。

needs 可以接收单个 Job ID,也可以接收数组。单个依赖写成 needs: build;必须等待多个 Job 时写成 needs: [test, lint]。这里引用的是 jobs 下的 Job ID,而不是 name 显示名称。

串行和并行应该混合使用

把所有 Job 串成一条长链虽然容易理解,却会增加流水线总耗时。更合适的方式是只为真实的数据或质量门禁建立依赖:构建完成后,让互不依赖的单元测试、静态检查并行执行,再由部署 Job 等待这些检查汇合。

判断是否应该添加 needs 时,可以问一个简单问题:当前 Job 是否必须依赖另一个 Job 的成功结果才能安全开始? 如果答案是否定的,就没有必要人为建立串行关系。这样既能保证部署顺序,又能充分利用 GitHub Actions 的并行执行能力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让多个 Job 按依赖顺序运行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通