.github/workflows/*.yml,逐段说出它什么时候跑、跑在哪台机器上、每一步干什么。
workflow(工作流):一个写在 .github/workflows/ 下的 YAML 文件,描述「什么事件发生时、在什么机器上、按什么顺序做什么」。一个仓库可以有多个。
像一张菜谱:写着什么时候做、用哪个灶、先下什么后下什么。
| 零件 | 它是什么 | 在 YAML 里长什么样 |
|---|---|---|
| on | 触发条件:什么事件发生时启动 | on: [push] / on: schedule |
| jobs | 作业:一段独立的任务,跑在自己的一台机器上 | jobs: build: |
| runs-on | 这个作业要哪种机器 | runs-on: ubuntu-latest |
| steps | 步骤:作业里按顺序执行的若干动作 | steps: 下面的一串 - |
| uses / run | 一步要么调用别人写好的 Action,要么直接跑一条命令 | - uses: actions/checkout@v4 / - run: npm ci |
这五个词的关系是包含关系:workflow 里有若干 job,一个 job 跑在一台机器上,机器里依次跑若干 step,每个 step 不是 uses 就是 run。
文件放在仓库根的 .github/workflows/check.yml:
name: check # 流程的名字,只影响界面与徽章上显示什么
on: [push] # 触发条件:每次 push 都跑
jobs:
test: # 作业名,自己起
runs-on: ubuntu-latest # 用哪种机器
steps:
- uses: actions/checkout@v4 # 第 1 步:把仓库代码取到这台机器上
- uses: actions/setup-node@v4 # 第 2 步:把 Node 装好
with:
node-version: 22
- run: npm ci # 第 3 步:按锁文件装依赖
- run: npm test # 第 4 步:跑测试
逐段读一遍:名字是 check;每次推送触发;一个叫 test 的作业;跑在 Ubuntu 最新版上;
四步依次是「取代码 → 装 Node → 装依赖 → 跑测试」。这就是绝大多数 workflow 的样子。
actions/checkout —— 不取代码,机器上什么都没有。
上一步生成的文件下一条 run 还能用,但换到另一个 job 就用不了了:那是另一台机器。continue-on-error);
一个 job 红了,别的 job 默认照旧跑完,不会自动取消。on: —— 它什么时候会跑?是推送、合并请求,还是定时?jobs: 下面有几个作业名 —— 有几个就代表会开出几台机器(用矩阵的话更多,那是 0003 的事)。runs-on —— 系统是什么?这决定了后面能写哪些命令。outputs。.github/workflows/ 下,扩展名 .yml 或 .yaml,否则平台根本不会看它。三题自测,每题只有一个正确选项;选完立刻看到解释。
1. 一个 workflow 里有两个 job,它们在什么上面跑?
对。一个 job 对应一台机器,这是硬规定:所以在 A 里生成的文件,B 默认看不到;要传就得上传产物或用缓存。
2. 为什么几乎每条流程的第一步都是取出代码?
对。托管 runner 每次都是全新机器,仓库内容不会自动出现;不取代码,后面的 npm ci 连 package.json 都找不到。
3. 一个 job 的第 3 步失败了,接下来会发生什么?
对。默认行为是「失败即中断这个作业」;想让它继续得显式写 continue-on-error。其它 job 不受影响,会照旧跑完。