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
| Step | Trên một VM GitHub mới |
|---|---|
| Checkout | Mặc định là shallow clone; --affected cần lịch sử, nên phải clone đầy đủ |
| Cài Node và pnpm | Tải về, trừ khi tool cache có sẵn phiên bản đó |
pnpm install | Store được khôi phục từ archive cache (hoặc tải từ registry), rồi link node_modules cho mọi package |
turbo run build | Task nào cũng chạy, trừ khi .turbo/cache đã được khôi phục hoặc một remote cache trả lời |
turbo run test | Như trên, trên 2 CPU của ubuntu-latest trên repository riêng tư |
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_TOKENvàTURBO_TEAM(Vercel Remote Cache, hoặc một server tự host). Mỗi hit là một lần tải từ đó. actions/cachetrên.turbo. Key là${{ runner.os }}-turbo-${{ github.sha }}vớirestore-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/cachecho.turboghi 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:
| GitHub (repository công khai, 4 vCPU, 16 GB) | Máy riêng của Skipbox (4 vCPU) | |
|---|---|---|
| Job | 528 giây | 30 giây (31 giây, 28 giây) |
| Task build | 40 task chạy | 40 task phát lại từ cache của turbo |
| Task test | chạy | phát lại từ cache của turbo |
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à~/.cachecủa từng tool.pnpm installlink từ ổ đĩa thay vì tải về. - Cache của turbo được giữ.
.turbocấp cao nhất của bản checkout được giữ giữa các job khiturbo.jsontheo kiểu turbo 2: có keytasks, không cópipeline, và không có"envMode": "loose". Không cầnTURBO_TOKEN, không cần step cache. node_modulesbị 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:
| Nhãn | Máy | Gói |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S, $39 một tháng |
skipbox-8x16 | 8 vCPU · 16 GB | M, $79 một tháng |
skipbox-16x32 | 16 vCPU · 32 GB | L, $149 một tháng |
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
- Đăng nhập Skipbox bằng GitHub.
- Cài ứng dụng GitHub của Skipbox và chọn các repository.
- Đổi
runs-onrồ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