CI/CD / 系统课时

看懂 Job、Step 与 Action

看懂 Job、Step 与 Action

阅读或修改 GitHub Actions 工作流时,最容易混淆的是 Job、Step 与 Action 的边界。本篇用一条可运行的 CI 流水线拆开三者:Job 决定独立运行单元,Step 表示顺序执行的步骤,Action 则把常用操作封装成可复用能力。

学习目标

  • 区分 Job、Step 与 Action 各自负责的执行边界
  • 看懂 jobs、steps、run 与 uses 的层级关系
  • 能根据任务粒度判断应该增加 Job、Step 还是复用 Action

三层结构分别解决什么问题

一个 workflow 可以包含多个 Job;一个 Job 在指定 Runner 上执行,并包含一组按顺序运行的 Step;Step 又可以直接执行 Shell 命令,也可以通过 uses 调用 Action。

Workflow、Job、Step 与 Action 的层级和执行关系

Job 是调度和运行环境层面的边界。每个 Job 都通过 runs-on 选择 Runner;多个 Job 默认可以并行,需要先后关系时可使用 needs 建立依赖。

Step 是 Job 内部的执行单元。同一个 Job 中的 Step 默认按声明顺序执行,并共享该 Job 的工作目录和 Runner 环境,因此前一步生成的工作区文件可以被后一步读取。

Action 不是比 Step 更高的一层,而是 Step 可以调用的一种可复用实现。常见形式是 uses: owner/repository@ref。例如检出仓库通常不需要自己编写 Git 命令,而是调用 actions/checkout。

从一份工作流看执行边界

下面的工作流在推送代码时运行。test 是 Job;它包含三个 Step,其中第一个和第二个调用 Action,第三个直接执行命令。

yaml
name: job-step-action-demo

on:
  push:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Print runtime
        run: node --version

actions/checkout@v4 与 actions/setup-node@v4 都是 Action,通过 uses 被 Step 调用;node --version 则通过 run 直接交给 Runner 执行。配置提交到仓库的 .github/workflows/demo.yml 后,可在对应 workflow run 中查看三个 Step 的执行记录。

预期结果

text
v20.<ID>

其中补丁版本 <ID> 会随 Runner 上实际安装和 Action 解析到的 Node.js 20 版本变化。关键验证点不是具体补丁号,而是该 Step 成功输出 v20 开头的版本号。

Job 为什么不能简单理解成步骤组

Job 还决定运行环境、权限和调度关系。例如测试 Linux 与 Windows 兼容性时,应使用不同 Job,因为它们需要不同 Runner;如果只是依次执行安装依赖、测试、构建,则通常放在同一个 Job 的多个 Step 中即可。

把所有事情拆成 Job 会增加 Runner 启动和跨 Job 传递数据的成本;反过来,把独立任务全部塞进一个 Job,又会失去并行执行和故障隔离能力。判断依据应是是否需要独立的运行环境或调度边界,而不是命令数量。

什么时候选哪一种

需要独立 Runner、不同操作系统、独立权限或并行执行时,拆成 Job。只需要在同一环境中按顺序完成一项操作时,增加 Step。某项操作需要跨项目重复使用,或者已有可靠的现成实现时,再优先考虑 Action。

因此,阅读工作流可以先找 jobs 确认运行边界,再沿 steps 看执行顺序,最后根据 run 与 uses 判断每一步究竟是直接执行命令还是调用封装好的 Action。

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

目录与阅读设置

阅读设置

17

记录一个想法

看懂 Job、Step 与 Action

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

登录哪都通