Skipbox

在 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,分钟数不限。

单体仓库的作业把时间花在哪里

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,工作流不变,出自真实项目的实测:

专属机器保留了上一个作业留下的检出目录中的 .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 倍。作业按标签选规格:

分钟数不限。在 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
  1. 使用 GitHub 登录 Skipbox。
  2. 安装 Skipbox GitHub 应用,并选择仓库。
  3. 修改 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日

缓存始终预热,CI/CD 更快

固定价格的预热运行器

机器由 Skipbox 托管。你只需改一行。满负荷使用时,费用是 GitHub 的 1/12。价格固定,全天运行也不加钱。缓存空间是 GitHub 的 7 倍。

  • 无需绑卡
  • 使用 GitHub 登录
  • 随时取消