Skipbox

在 GitHub Actions 上加速 pnpm 和 Turborepo monorepo(astro:528 秒變 30 秒)

在 GitHub Actions 上的 pnpm 和 Turborepo monorepo 中,慢的作業大部分時間花在兩個步驟:全新 VM 上的 pnpm install,以及 turbo run build test 執行那些結果不在這台 VM 上的任務。請依這個順序修正。只執行變更動到的套件(turbo run build --affected,搭配有歷史紀錄的 checkout)。給 turbo 一個比作業活得久的快取,因為它的結果存在 .turbo/cache,而那台機器在每個作業後都會被 GitHub 刪除:Remote Caching,或用 actions/cache 還原 .turbo。再保留 pnpm store。在 GitHub 的 Runner 上,這些快取每一個都是每個作業一次下載。在保留磁碟的機器上,它們就在那裡:astro 的 CI 作業在 GitHub 上花 528 秒,在 Skipbox 專屬機器上花 30 秒,它從 turbo 保留下來的快取重播了全部 40 個建置任務。

Skipbox 在你帳號的專屬機器上執行作業,這台機器在作業之間保留 pnpm store、工具和 checkout 的 .turbo,不需要遠端快取,也不需要快取 key。改一行 runs-on: skipbox,每月固定 $39,分鐘數不限。

monorepo 作業把時間花在哪裡

1. 只執行有變動的部分

依 Turborepo 的 CI 指南:turbo run build --affected 只在相對於基礎分支有變動的套件中執行任務。在 GitHub Actions 中,它在 Pull Request 上讀取 GITHUB_BASE_REF,在推送時讀取 GITHUB_EVENT_PATH。用淺層複製的話,每個套件都會被當成有變動,所以要 checkout 歷史紀錄:

- 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 指南,有兩種繞過的方法:

  • Remote Caching。 設定 TURBO_TOKEN 和 TURBO_TEAM(Vercel Remote Cache,或自架的伺服器)。每次命中都是從它下載。
  • 對 .turbo 使用 actions/cache。 以 ${{ runner.os }}-turbo-${{ github.sha }} 為 key,加上 restore-keys: ${{ runner.os }}-turbo-。它每次執行都會儲存一個新項目,和儲存庫快取的其他所有東西一起,擠在 GitHub 每個儲存庫 10 GB 的額度裡。

3. 保留 pnpm store

actions/setup-node 加上 cache: pnpm,或對 pnpm store path 使用 actions/cache,會以 pnpm-lock.yaml 為 key 還原 store。它不會還原 node_modules,所以 pnpm 還是要連結每個套件。pnpm 的 CI 文件說得很直白:快取 store 不保證能讓安裝變快。在 CI 上,pnpm 會自動切換成 --frozen-lockfile。

4. 用上所有核心

turbo 會平行執行彼此獨立的任務,而每個建置或測試工具都會啟動自己的 worker,所以 monorepo 拿到多少核心就用多少。私有儲存庫的 ubuntu-latest 只有 2 顆。

每項修正在 GitHub 的 Runner 上的代價

  • Remote Caching 是另一個服務、另一個權杖,而每次快取命中都要經過網路。
  • 為 .turbo 用 actions/cache 每次執行都會寫入一個項目,和 pnpm store、Docker 的層以及每個分支的快取,搶同一個 10 GB;7 天沒用到的項目會被移除。
  • 更大的 Runner 就是 GitHub Team 或 Enterprise Cloud 上的大型 Runner,按分鐘計費。

解法就是一台保留磁碟的機器

astro 自己的 CI,工作流程沒有任何修改,依我們對真實專案的執行結果:

專屬機器保留了上一個作業的 checkout 中的 .turbo 和 pnpm store,所以 turbo 找到了每個任務的結果,沒有任何東西要下載。只有任務的輸入雜湊相同時,turbo 才會重播它,所以真正的 commit 會重新執行它動到的套件,其餘的則重播。

Skipbox 保留 monorepo 的狀態

每個方案都附有一台你帳號專屬、在作業之間保留下來的機器:

  • pnpm store 會留下來,位於 ~/.local/share/pnpm/store,還有 npm 的快取和每個工具的 ~/.cache。pnpm install 從磁碟連結,而不是下載。
  • turbo 的快取會留下來。 當 turbo.json 是 turbo 2 的格式時:有 tasks key、沒有 pipeline,也沒有 "envMode": "loose",checkout 最上層的 .turbo 會在作業之間保留下來。不需要 TURBO_TOKEN,也不需要快取步驟。
  • node_modules 會在每個作業後被刪除,所以共用同一個 checkout 的 Node 版本矩陣,絕不會載入為另一個 Node 建置的原生擴充模組。
  • 工具會留下來: setup-node 安裝的 Node 版本、pnpm 本身、Docker 的映像檔和層。

S 方案的快取空間至少是 GitHub 的 7 倍。作業依標籤選擇規格:

分鐘數不限。4 vCPU 每月 20,000 分鐘,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 App,並選擇儲存庫。
  3. 修改 runs-on 並推送。

快取步驟維持原樣就好;它們儲存的東西會留在機器旁邊。

安全性

  • 機器只屬於你的帳號。其他公司的作業不會在上面執行。
  • 每個作業結束後,Runner 的憑證、程序和容器都會被清除,保留下來的 checkout 中的 Git 憑證、hook 和未追蹤的檔案也是。開啟「每個作業都用新 VM」,每個作業就會改用一台全新的機器。
  • 沒有寫入權限的人提交的程式碼(例如來自 fork 的 Pull Request),會在全新的 VM 上執行,可以讀取你的快取但不能修改。

詳情請見作業如何隔離。

用 monorepo 試試看

試用免費,為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。把建置作業改成 runs-on: skipbox,執行兩次,再把第二次執行的 install 和 turbo 那幾行(cached 對 executing)和 GitHub 上的並排比較。

常見問題

怎麼在 GitHub Actions 上加速大型 pnpm/Turborepo monorepo?

依序做三件事。只執行有變動的部分:turbo run build --affected,搭配有歷史紀錄的 checkout(fetch-depth: 0 和 filter: blob:none)。給 turbo 一個撐得過作業的快取:Turborepo 的 Remote Cache,或用 actions/cache 還原的 .turbo。再保留 pnpm store:setup-node 的 cache: pnpm,或對 store 路徑使用 actions/cache。在 GitHub 全新的 VM 上,這些每一項都是每個作業一次下載;在保留磁碟的機器上,它們本來就在。astro 的 CI 在 GitHub 上花 528 秒,在保留 turbo 快取和 pnpm store 的 Skipbox 專屬機器上花 30 秒。

為什麼就算快取了 store,pnpm install 在 GitHub Actions 上還是很慢?

因為還原的 store 仍然是一個在新 VM 上下載並解開的封存檔,之後 pnpm 還要為 workspace 的每個套件連結 node_modules。pnpm 自己的 CI 文件說,快取 store 不保證能讓安裝變快。已經在機器磁碟上的 store 能跳過下載;只剩下連結。

Turborepo 的快取在 GitHub Actions 上有用嗎?

只有在快取比作業活得久時才有用。Turborepo 把任務結果存在機器上的 .turbo/cache,而 GitHub 託管作業的機器在作業結束時就消失了。所以 CI 需要 Remote Caching(TURBO_TOKEN 和 TURBO_TEAM,Vercel 的或自架的),或為 .turbo 加一個 actions/cache 步驟。在 Skipbox 的專屬機器上,turbo 2 專案的 checkout 中的 .turbo 會在作業之間保留下來,所以 turbo 不需要遠端快取就能重播沒有變動的任務。

turbo --affected 在 GitHub Actions 上能用嗎?

能。Turborepo 在 Pull Request 上讀取 GITHUB_BASE_REF,在推送時讀取 GITHUB_EVENT_PATH,來找出要比較的基準。它需要歷史紀錄:用淺層複製的話,每個套件都會被當成有變動。在 actions/checkout 上設定 fetch-depth: 0 和 filter: blob:none。

Skipbox 會為 Turborepo monorepo 保留什麼?

pnpm store、npm 和每個工具的快取、setup-node 安裝的工具、Docker 的層,以及當 turbo.json 是 turbo 2 格式時(有 tasks key、沒有 pipeline、不是 envMode loose),連同最上層 .turbo 的 checkout。node_modules 會在每個作業後被刪除,所以 install 會執行,但是從磁碟上的 store 安裝。只有任務的輸入雜湊相同時,turbo 才會重播它,所以一個 commit 會重新執行它動到的部分。

試用要花多少錢?

不用錢。試用為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。把 monorepo 的建置作業改成 runs-on: skipbox,執行兩次,再把第二次執行的 install 和 turbo 步驟與 GitHub 上的比較。

更新於 2026年11月13日

快取隨時熱機,CI/CD 更快

固定價格的專屬熱機 Runner

機器由 Skipbox 代管。你只要改一行。滿載使用時只要 GitHub 的 1/12。價格固定,可以整天跑。快取空間是 GitHub 的 7 倍。

  • 不需信用卡
  • 使用 GitHub 登入
  • 隨時可取消