runs-on 就知道这台机器什么脾气,并说清一个矩阵为什么会让作业数成倍增长。
| 写法 | 谁提供的机器 | 生命周期 | 什么时候用它 |
|---|---|---|---|
ubuntu-latest / windows-latest / macos-latest | 平台 | 这一次作业,跑完销毁 | 默认选择:绝大多数流程都用它 |
self-hosted | 你自己 | 长期在线,一直等着派活 | 要特定硬件、要连内网、要很大的缓存 |
| 更大的托管机型(按量付费) | 平台 | 同托管,只是规格更高 | 编译特别重、内存不够用的时候 |
托管机型的系统与预装软件由平台维护,所以「碰巧装好了」这件事不可依赖:
官方会随镜像更新换掉工具版本。要稳,就把版本显式写进流程里(比如用 setup-node 指定 node-version)。
同一段步骤要在几个组合上各跑一遍时,不需要复制粘贴 —— 用 strategy.matrix 声明变量,平台替你展开:
jobs:
test:
runs-on: ${{ matrix.os }}
strategy:
matrix:
os: [ubuntu-latest, windows-latest]
node: [20, 22]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node }}
- run: npm ci
- run: npm test
两个系统 × 两个版本 = 四个作业,各自开一台机器、各自完整地跑一遍。
${{ matrix.xxx }} 就是「这次该用哪个值」的占位符。
fail-fast: false;exclude 去掉不关心的搭配,include 追加特殊的一两条。自建 runner 就是在自己机器上跑一个代理程序,它向平台报到、等派活。需要它的场合通常只有三个:
代价也清楚:那台机器要你维护(更新、磁盘、安全补丁),而且它会记住上一次跑过的东西。 更要紧的是安全 —— 官方明确提醒:给公开仓库配自建 runner 有风险,因为外部提交的流程可能在那台机器上执行。
latest 意味着固定在某个版本。」它意味着「平台当前认为的最新」,会悄悄变。三题自测,每题只有一个正确选项;选完立刻看到解释。
1. 矩阵写了 3 个系统 × 2 个版本,会跑多少个作业?
对。维度之间是相乘的关系,3 × 2 = 6 个作业,各开一台机器;这就是矩阵会快速吃掉额度的原因。
2. 什么情况下最该考虑自建 runner?
对。内网可达、特殊硬件、大缓存是自建的三个正当理由;而它恰恰是更要维护、以及给公开仓库用时更有风险的那条路。
3. 自建 runner 与托管 runner 最关键的行为差别是什么?
对。托管 runner 每次都是干净机器;自建的那台会累积状态,上一次留下的文件和改动会影响这一次 —— 所以清理步骤要自己写。