Skipbox

Tăng tốc monorepo pnpm và Turborepo trên GitHub Actions (astro: 528 giây xuống 30 giây)

Trong một monorepo pnpm và Turborepo trên GitHub Actions, phần lớn thời gian của một job chậm nằm ở hai step: pnpm install trên một VM mới, và turbo run build test chạy các task mà VM không có kết quả. Hãy sửa theo thứ tự này. Chỉ chạy các package mà thay đổi chạm tới (turbo run build --affected, với một bản checkout có lịch sử). Cho turbo một cache sống lâu hơn job, vì kết quả của nó nằm trong .turbo/cache trên một cái máy mà GitHub xóa sau mỗi job: Remote Caching, hoặc .turbo được khôi phục bằng actions/cache. Và giữ pnpm store. Trên runner của GitHub, mỗi cache đó là một lần tải ở mỗi job. Trên một cái máy giữ ổ đĩa, chúng cứ thế nằm sẵn: job CI của astro mất 528 giây trên GitHub và 30 giây trên máy riêng của Skipbox, nơi phát lại cả 40 task build từ cache được giữ của turbo.

Skipbox chạy job của bạn trên máy riêng của tài khoản bạn, nơi giữ pnpm store, các tool và .turbo của bản checkout giữa các job, không cần remote cache, không cần cache key. Đổi một dòng, runs-on: skipbox, với giá cố định $39 một tháng, không giới hạn phút.

Job monorepo tiêu thời gian vào đâu

1. Chỉ chạy những gì đã thay đổi

Theo hướng dẫn CI của Turborepo: turbo run build --affected chỉ chạy task trong các package đã thay đổi so với nhánh base. Trong GitHub Actions, nó đọc GITHUB_BASE_REF ở pull request và GITHUB_EVENT_PATH ở các lần push. Với shallow clone, package nào cũng bị tính là đã thay đổi, nên hãy checkout cả lịch sử:

- uses: actions/checkout@v4
  with:
    fetch-depth: 0
    filter: blob:none

turbo query affected --packages web cho một job biết có cần chạy hay không, để job của một ứng dụng không bị đụng tới bỏ qua được bước install.

2. Cho turbo một cache sống lâu hơn job

Turborepo lưu kết quả task trong .turbo/cache trên máy. Máy của job do GitHub host bị xóa khi job kết thúc, nên trong CI cache đó lần nào cũng khởi đầu trống. Hai cách lách, theo hướng dẫn GitHub Actions của Turborepo:

  • Remote Caching. Đặt TURBO_TOKEN và TURBO_TEAM (Vercel Remote Cache, hoặc một server tự host). Mỗi hit là một lần tải từ đó.
  • actions/cache trên .turbo. Key là ${{ runner.os }}-turbo-${{ github.sha }} với restore-keys: ${{ runner.os }}-turbo-. Nó lưu một mục mới ở mỗi lần chạy, trong 10 GB mỗi repository của GitHub cùng mọi thứ khác repository cache.

3. Giữ pnpm store

actions/setup-node với cache: pnpm, hoặc actions/cache trên pnpm store path, khôi phục store theo key pnpm-lock.yaml. Nó không khôi phục node_modules, nên pnpm vẫn link mọi package. Tài liệu CI của pnpm nói thẳng: cache store không bảo đảm làm việc cài đặt nhanh hơn. Trong CI, pnpm tự chuyển sang --frozen-lockfile.

4. Dùng hết các nhân

turbo chạy song song các task độc lập và mỗi tool build hay test khởi động worker riêng, nên monorepo dùng hết mọi nhân nó có. ubuntu-latest của repository riêng tư có 2.

Mỗi cách sửa tốn gì trên runner của GitHub

  • Remote Caching là thêm một dịch vụ và một token nữa, và mỗi cache hit đều đi qua mạng.
  • actions/cache cho .turbo ghi một mục ở mỗi lần chạy và tranh cùng 10 GB với pnpm store, Docker layer và cache của mọi nhánh; mục không dùng trong 7 ngày bị xóa.
  • Runner lớn hơn là larger runner trên GitHub Team hoặc Enterprise Cloud, tính tiền theo phút.

Khi cách sửa là một cái máy giữ ổ đĩa

CI của chính astro, workflow không đổi, từ các lần chúng tôi chạy dự án thật:

Máy riêng giữ .turbo của bản checkout và pnpm store từ job trước, nên turbo tìm thấy kết quả của mọi task mà không phải tải gì. turbo chỉ phát lại một task khi hash input của nó giống hệt, nên một commit thật sẽ chạy lại các package nó chạm tới và phát lại phần còn lại.

Skipbox giữ trạng thái của monorepo

Mỗi gói đi kèm máy riêng của tài khoản bạn, được giữ lại giữa các job:

  • pnpm store được giữ trong ~/.local/share/pnpm/store, cùng cache của npm và ~/.cache của từng tool. pnpm install link từ ổ đĩa thay vì tải về.
  • Cache của turbo được giữ. .turbo cấp cao nhất của bản checkout được giữ giữa các job khi turbo.json theo kiểu turbo 2: có key tasks, không có pipeline, và không có "envMode": "loose". Không cần TURBO_TOKEN, không cần step cache.
  • node_modules bị xóa sau mỗi job, để một matrix nhiều phiên bản Node dùng chung một bản checkout không bao giờ nạp nhầm native addon được build cho Node khác.
  • Các tool được giữ: các phiên bản Node mà setup-node đã cài, chính pnpm, Docker image và layer.

Dung lượng cache ít nhất gấp 7 lần GitHub trên gói S. Job chọn kích thước bằng nhãn:

Không giới hạn phút. Ở mức 20.000 phút mỗi tháng trên 4 vCPU, GitHub tính $222; Skipbox S là $39, ít hơn $183.

Chuyển sang chỉ cần một dòng

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. Đăng nhập Skipbox bằng GitHub.
  2. Cài ứng dụng GitHub của Skipbox và chọn các repository.
  3. Đổi runs-on rồi push.

Giữ nguyên các step cache; những gì chúng lưu nằm cạnh máy.

Bảo mật

  • Máy chỉ thuộc về tài khoản của bạn. Không có job của công ty nào khác chạy trên đó.
  • Sau mỗi job, thông tin xác thực, tiến trình và container của runner bị xóa, cùng thông tin xác thực git, hook và các file không được track trong bản checkout được giữ lại. Bật VM mới cho mỗi job thì mỗi job chạy trên một máy mới.
  • Code từ người không có quyền ghi (chẳng hạn pull request từ fork) chạy trên một VM mới, đọc được cache của bạn nhưng không sửa được.

Chi tiết có trong cách các job được cách ly.

Thử trên monorepo của bạn

Dùng thử miễn phí trong 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Chuyển job build sang runs-on: skipbox, chạy hai lần, và đặt các dòng install và turbo của lần chạy thứ hai (cached so với executing) cạnh số liệu của GitHub.

Câu hỏi thường gặp

Tăng tốc một monorepo pnpm/Turborepo lớn trên GitHub Actions thế nào?

Ba việc, theo thứ tự. Chỉ chạy những gì đã thay đổi: turbo run build --affected, với một bản checkout có lịch sử (fetch-depth: 0 và filter: blob:none). Cho turbo một cache tồn tại sau job: Remote Cache của Turborepo, hoặc .turbo được khôi phục bằng actions/cache. Và giữ pnpm store: cache: pnpm của setup-node hoặc actions/cache trên đường dẫn store. Trên VM mới của GitHub, mỗi thứ đó là một lần tải ở mỗi job; trên một cái máy giữ ổ đĩa, chúng đã có sẵn. CI của astro mất 528 giây trên GitHub và 30 giây trên máy riêng của Skipbox, nơi giữ cache của turbo và pnpm store.

Vì sao pnpm install chậm trên GitHub Actions dù store đã được cache?

Vì store được khôi phục vẫn là một archive được tải về và giải nén trên VM mới, rồi pnpm còn phải link node_modules cho mọi package của workspace. Chính tài liệu CI của pnpm nói việc cache store không bảo đảm làm việc cài đặt nhanh hơn. Một store đã nằm sẵn trên ổ đĩa của máy bỏ qua được lần tải; chỉ còn lại việc link.

Cache của Turborepo có chạy trên GitHub Actions không?

Chỉ khi cache sống lâu hơn job. Turborepo giữ kết quả task trong .turbo/cache trên máy, và máy của job do GitHub host biến mất khi job kết thúc. Vì vậy CI cần Remote Caching (TURBO_TOKEN và TURBO_TEAM, của Vercel hoặc tự host) hoặc một step actions/cache cho .turbo. Trên máy riêng của Skipbox, .turbo của bản checkout được giữ giữa các job với dự án turbo 2, nên turbo phát lại các task không đổi mà không cần remote cache nào.

turbo --affected có chạy trên GitHub Actions không?

Có. Turborepo đọc GITHUB_BASE_REF ở pull request, và GITHUB_EVENT_PATH ở các lần push, để tìm base để so sánh. Nó cần lịch sử: với shallow clone, package nào cũng bị tính là đã thay đổi. Đặt fetch-depth: 0 và filter: blob:none cho actions/checkout.

Skipbox giữ gì cho một monorepo Turborepo?

pnpm store, cache của npm và từng tool, các tool mà setup-node cài, Docker layer, và bản checkout cùng .turbo cấp cao nhất của nó khi turbo.json theo kiểu turbo 2 (có key tasks, không có pipeline, không có envMode loose). node_modules bị xóa sau mỗi job, nên install vẫn chạy, từ store trên ổ đĩa. turbo chỉ phát lại một task khi hash input của nó giống hệt, nên một commit sẽ chạy lại những gì nó chạm tới.

Thử thì tốn bao nhiêu?

Không tốn gì. Dùng thử kéo dài 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Chuyển job build của monorepo sang runs-on: skipbox, chạy hai lần, rồi so các step install và turbo của lần chạy thứ hai với GitHub.

Cập nhật ngày 13 tháng 11, 2026

CI/CD nhanh hơn với cache luôn sẵn sàng

Runner luôn sẵn cache, giá cố định

Chúng tôi host. Bạn đổi một dòng. Chỉ bằng 1/12 chi phí GitHub khi chạy hết công suất. Giá cố định nên bạn chạy cả ngày cũng được. Dung lượng cache gấp 7 lần GitHub.

  • Không cần thẻ
  • Đăng nhập bằng GitHub
  • Hủy bất cứ lúc nào