在 GitHub Actions 中给 pnpm 和 Turborepo 单体仓库提速(astro:528 秒到 30 秒)
在 GitHub Actions 上的 pnpm 和 Turborepo 单体仓库中,一个慢作业的大部分时间花在两个步骤上:新虚拟机上的 pnpm install,以及 turbo run build test 运行那些结果不在这台虚拟机上的任务。按这个顺序解决。只运行改动涉及的包(turbo run build --affected,检出时带上历史)。给 turbo 一个比作业活得久的缓存,因为它的结果放在 .turbo/cache 里,而那台机器在每个作业后都会被 GitHub 删除:用远程缓存,或者用 actions/cache 恢复 .turbo。并保留 pnpm store。在 GitHub 的运行器上,这些缓存每个作业都是一次下载。在一台保留磁盘的机器上,它们就在那里:astro 的 CI 作业在 GitHub 上要 528 秒,在 Skipbox 的专属机器上只要 30 秒,40 个构建任务全部从 turbo 保留的缓存中重放。
Skipbox 在你账号的专属机器上运行你的作业,这台机器在作业之间保留 pnpm store、工具和检出目录中的 .turbo,不需要远程缓存,也不需要缓存键。只改一行,runs-on: skipbox,每月固定 $39,分钟数不限。
单体仓库的作业把时间花在哪里
| 步骤 | 在一台新的 GitHub 虚拟机上 |
|---|---|
| 检出 | 默认是浅克隆;--affected 需要历史,所以要完整克隆 |
| 设置 Node 和 pnpm | 要下载,除非工具缓存里有这个版本 |
pnpm install | 从缓存归档恢复 store(或者从注册表下载),然后为每个包链接 node_modules |
turbo run build | 每个任务都要运行,除非恢复了 .turbo/cache,或者远程缓存命中 |
turbo run test | 一样,在私有仓库 ubuntu-latest 的 2 个 CPU 上 |
1. 只运行改动的部分
根据 Turborepo 的 CI 指南:turbo run build --affected 只在相对于基准分支有改动的包中运行任务。在 GitHub Actions 中,它在拉取请求上读取 GITHUB_BASE_REF,在推送上读取 GITHUB_EVENT_PATH。浅克隆时,每个包都算作改动了,所以要检出历史:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
turbo query affected --packages web 告诉一个作业要不要运行,所以没被改动的应用对应的作业可以跳过安装。
2. 给 turbo 一个比作业活得久的缓存
Turborepo 把任务结果保存在机器上的 .turbo/cache 里。GitHub 托管作业的机器在作业结束时被删除,所以在 CI 中,这个缓存每次都是空的。Turborepo 的 GitHub Actions 指南给出了两种办法:
- 远程缓存:设置
TURBO_TOKEN和TURBO_TEAM(Vercel 远程缓存,或者自托管的服务器)。每次命中都是从它那里下载。 - 对
.turbo用actions/cache:以${{ runner.os }}-turbo-${{ github.sha }}为键,设置restore-keys: ${{ runner.os }}-turbo-。每次运行都保存一个新条目,和仓库缓存的其他所有东西一起,占用 GitHub 每个仓库 10 GB 的空间。
3. 保留 pnpm store
actions/setup-node 设置 cache: pnpm,或者对 pnpm store path 用 actions/cache,会以 pnpm-lock.yaml 为键恢复 store。它不恢复 node_modules,所以 pnpm 仍然要链接每个包。pnpm 的 CI 文档说得很直白:缓存 store 并不一定能让安装更快。在 CI 中,pnpm 会自动切换到 --frozen-lockfile。
4. 用上所有核心
turbo 并行运行相互独立的任务,每个构建或测试工具也会启动自己的工作进程,所以单体仓库会用上它能拿到的每一个核心。私有仓库的 ubuntu-latest 只有 2 个。
在 GitHub 的运行器上,每种办法的代价
- 远程缓存:又一个服务、又一个令牌,每次缓存命中都要走网络。
- 对
.turbo用actions/cache:每次运行都写一个条目,和 pnpm store、Docker 的层以及每个分支的缓存争夺同一个 10 GB;7 天没用到的条目会被删掉。 - 更大的运行器:就是 GitHub Team 或 Enterprise Cloud 上的大型运行器,按分钟计费。
解决办法是一台保留磁盘的机器时
astro 自己的 CI,工作流不变,出自真实项目的实测:
| GitHub(公开仓库,4 vCPU,16 GB) | Skipbox 专属机器(4 vCPU) | |
|---|---|---|
| 作业 | 528 秒 | 30 秒(31 秒,28 秒) |
| 构建任务 | 运行 40 个 | 40 个从 turbo 的缓存中重放 |
| 测试任务 | 运行 | 从 turbo 的缓存中重放 |
专属机器保留了上一个作业留下的检出目录中的 .turbo 和 pnpm store,所以 turbo 找到了每个任务的结果,什么都不用下载。turbo 只在任务的输入哈希相同时才重放它,所以一次真实的提交会重新运行它改动到的包,其余的重放。
Skipbox 保留单体仓库的状态
每个套餐都附带你账号的专属机器,在作业之间一直保留:
- pnpm store 保留在
~/.local/share/pnpm/store中,还有 npm 的缓存和各个工具的~/.cache。pnpm install从磁盘链接,而不是下载。 - turbo 的缓存保留:当
turbo.json是 turbo 2 格式时,检出目录顶层的.turbo在作业之间保留:有tasks键,没有pipeline,也没有"envMode": "loose"。不需要TURBO_TOKEN,也不需要缓存步骤。 node_modules在每个作业后删除,所以共用一个检出目录的 Node 版本矩阵,永远不会加载为另一个 Node 版本构建的原生插件。- 工具保留:
setup-node安装的 Node 版本、pnpm 本身、Docker 的镜像和层。
在 S 上,缓存空间至少是 GitHub 的 7 倍。作业按标签选规格:
| 标签 | 机器 | 套餐 |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S,每月 $39 |
skipbox-8x16 | 8 vCPU · 16 GB | M,每月 $79 |
skipbox-16x32 | 16 vCPU · 32 GB | L,每月 $149 |
分钟数不限。在 4 vCPU 上每月 2万分钟,GitHub 收 $222;Skipbox S 是 $39,少花 $183。
切换只需改一行
jobs:
build:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
- uses: pnpm/action-setup@v3
- uses: actions/setup-node@v4
with:
node-version: 22
cache: pnpm
- run: pnpm install
- run: pnpm turbo run build test --affected
- 使用 GitHub 登录 Skipbox。
- 安装 Skipbox GitHub 应用,并选择仓库。
- 修改
runs-on并推送。
缓存步骤保持原样;它们保存的东西就放在机器旁边。
安全
- 这台机器只属于你的账号。不会运行其他公司的作业。
- 每个作业结束后,运行器的凭据、进程和容器都会被清除,保留的检出目录中的 git 凭据、钩子和未跟踪文件也一样。开启“每个作业用新虚拟机”后,每个作业改在一台新机器上运行。
- 没有写入权限的人提交的代码(例如来自复刻的拉取请求)在一台新的虚拟机上运行,它能读取你的缓存,但不能修改。
详情见作业如何隔离。
用单体仓库试试
试用免费,为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡。把构建作业改为 runs-on: skipbox,运行两次,再把第二次运行的 install 和 turbo 输出(cached 对比 executing)和 GitHub 上的放在一起看。
常见问题
怎样在 GitHub Actions 中给大型 pnpm/Turborepo 单体仓库提速?
按顺序做三件事。只运行改动的部分:turbo run build --affected,检出时带上历史(fetch-depth: 0 和 filter: blob:none)。给 turbo 一个作业结束后还在的缓存:Turborepo 的远程缓存,或者用 actions/cache 恢复 .turbo。并保留 pnpm store:setup-node 的 cache: pnpm,或者对 store 路径用 actions/cache。在 GitHub 每次都是新的虚拟机上,这些每个作业都是一次下载;在一台保留磁盘的机器上,它们早就在那里了。astro 的 CI 在 GitHub 上要 528 秒,在保留 turbo 缓存和 pnpm store 的 Skipbox 专属机器上只要 30 秒。
为什么即使缓存了 store,pnpm install 在 GitHub Actions 中还是很慢?
因为恢复的 store 仍然是一个要在新虚拟机上下载、解压的归档,之后 pnpm 还要为工作区的每个包链接 node_modules。pnpm 自己的 CI 文档说,缓存 store 并不一定能让安装更快。已经在机器磁盘上的 store 省掉了下载;只剩下链接。
Turborepo 缓存在 GitHub Actions 中有效吗?
只有缓存比作业活得久才有效。Turborepo 把任务结果放在机器上的 .turbo/cache 里,而 GitHub 托管作业的机器在作业结束时就没了。所以 CI 需要远程缓存(TURBO_TOKEN 和 TURBO_TEAM,用 Vercel 的或自托管的),或者一个针对 .turbo 的 actions/cache 步骤。在 Skipbox 的专属机器上,对于 turbo 2 项目,检出目录中的 .turbo 在作业之间保留,所以 turbo 不用远程缓存就能重放没有改动的任务。
turbo --affected 在 GitHub Actions 中能用吗?
能。Turborepo 在拉取请求上读取 GITHUB_BASE_REF,在推送上读取 GITHUB_EVENT_PATH,找出要比较的基准。它需要历史:浅克隆时,每个包都算作改动了。在 actions/checkout 上设置 fetch-depth: 0 和 filter: blob:none。
Skipbox 为 Turborepo 单体仓库保留什么?
pnpm store、npm 和各个工具的缓存、setup-node 安装的工具、Docker 的层,以及当 turbo.json 是 turbo 2 格式时(有 tasks 键,没有 pipeline,也不是 envMode loose),检出目录及其顶层的 .turbo。node_modules 在每个作业后删除,所以 install 会运行,从磁盘上的 store 安装。turbo 只在任务的输入哈希相同时才重放它,所以一次提交会重新运行它改动到的部分。
试用要花多少钱?
不花钱。试用为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡。把单体仓库的构建作业改为 runs-on: skipbox,运行两次,再把第二次运行的 install 和 turbo 步骤与 GitHub 上的比一比。
更新于 2026年11月13日