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 才会启动。
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"预期结果
build
├─ test ─┐
└─ lint ─┴─ deploy这里的文本仅表示依赖关系,实际运行日志中的 Job 开始时间和 Runner 分配信息会不同。test 与 lint 都只依赖 build,因此 build 成功后它们可以并行;deploy 同时依赖二者,所以必须等待两项完成。

依赖决定执行条件
默认情况下,被 needs 引用的前置 Job 如果失败或被跳过,依赖它的下游 Job 也会被跳过。这个行为非常适合生产流水线:测试没有通过时,不应该继续部署。
needs 可以接收单个 Job ID,也可以接收数组。单个依赖写成 needs: build;必须等待多个 Job 时写成 needs: [test, lint]。这里引用的是 jobs 下的 Job ID,而不是 name 显示名称。
串行和并行应该混合使用
把所有 Job 串成一条长链虽然容易理解,却会增加流水线总耗时。更合适的方式是只为真实的数据或质量门禁建立依赖:构建完成后,让互不依赖的单元测试、静态检查并行执行,再由部署 Job 等待这些检查汇合。
判断是否应该添加 needs 时,可以问一个简单问题:当前 Job 是否必须依赖另一个 Job 的成功结果才能安全开始? 如果答案是否定的,就没有必要人为建立串行关系。这样既能保证部署顺序,又能充分利用 GitHub Actions 的并行执行能力。