Accelerează un monorepo pnpm și Turborepo în GitHub Actions (astro: de la 528 s la 30 s)
Într-un monorepo pnpm și Turborepo pe GitHub Actions, cea mai mare parte a unui job lent înseamnă doi pași: pnpm install pe un VM nou și turbo run build test rulând taskuri ale căror rezultate VM-ul nu le are. Rezolvă-i în această ordine. Rulează doar pachetele atinse de o schimbare (turbo run build --affected, cu un checkout care are istoric). Dă-i lui turbo un cache care supraviețuiește jobului, pentru că rezultatele lui stau în .turbo/cache pe o mașină pe care GitHub o șterge după fiecare job: Remote Caching sau .turbo restaurat cu actions/cache. Și păstrează store-ul pnpm. Pe runnerele GitHub, fiecare dintre aceste cache-uri e o descărcare la fiecare job. Pe o mașină care își păstrează discul, pur și simplu sunt acolo: jobul de CI al astro a durat 528 s pe GitHub și 30 s pe o mașină dedicată Skipbox, care a reluat toate cele 40 de taskuri de build din cache-ul păstrat al turbo.
Skipbox îți rulează joburile pe mașina dedicată a contului tău, care păstrează între joburi store-ul pnpm, instrumentele și .turbo din checkout, fără cache la distanță și fără chei de cache. Schimbi o singură linie, runs-on: skipbox, la un preț fix de $39 pe lună, cu minute nelimitate.
Unde își petrece timpul un job de monorepo
| Pasul | Pe un VM GitHub nou |
|---|---|
| Checkout | Implicit o clonă superficială; --affected are nevoie de istoric, deci de una completă |
| Configurarea Node și pnpm | Descărcate, dacă tool cache-ul nu are versiunea |
pnpm install | Store-ul restaurat din arhiva de cache (sau descărcat din registry), apoi node_modules legat pentru fiecare pachet |
turbo run build | Rulează fiecare task, dacă nu s-a restaurat .turbo/cache sau nu răspunde un cache la distanță |
turbo run test | La fel, pe cele 2 CPU ale ubuntu-latest dintr-un repository privat |
1. Rulează doar ce s-a schimbat
Din ghidul Turborepo pentru CI: turbo run build --affected rulează taskuri doar în pachetele schimbate față de branchul de bază. În GitHub Actions citește GITHUB_BASE_REF la pull request-uri și GITHUB_EVENT_PATH la push-uri. Cu o clonă superficială, fiecare pachet contează ca schimbat, așa că fă checkout cu istoric:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
turbo query affected --packages web îi spune unui job dacă să ruleze deloc, așa că jobul unei aplicații neatinse poate sări peste instalare.
2. Dă-i lui turbo un cache care supraviețuiește jobului
Turborepo stochează rezultatele taskurilor în .turbo/cache pe mașină. Mașina unui job găzduit de GitHub e ștearsă când jobul se termină, așa că în CI acel cache pornește gol de fiecare dată. Două ocolișuri, din ghidul Turborepo pentru GitHub Actions:
- Remote Caching. Setează
TURBO_TOKENșiTURBO_TEAM(Vercel Remote Cache sau un server self-hosted). Fiecare potrivire e o descărcare de acolo. actions/cachepe.turbo. Cheia${{ runner.os }}-turbo-${{ github.sha }}curestore-keys: ${{ runner.os }}-turbo-. Salvează o intrare nouă la fiecare rulare, în cei 10 GB per repository de la GitHub, împreună cu tot ce mai pune repository-ul în cache.
3. Păstrează store-ul pnpm
actions/setup-node cu cache: pnpm sau actions/cache pe pnpm store path restaurează store-ul cu cheia legată de pnpm-lock.yaml. Nu restaurează node_modules, așa că pnpm tot leagă fiecare pachet. Documentația pnpm pentru CI o spune direct: nu e garantat că punerea store-ului în cache face instalarea mai rapidă. În CI, pnpm trece singur pe --frozen-lockfile.
4. Folosește nucleele
turbo rulează în paralel taskurile independente, iar fiecare instrument de build sau test își pornește propriii workeri, așa că un monorepo folosește fiecare nucleu pe care îl primește. ubuntu-latest dintr-un repository privat are 2.
Cât costă fiecare soluție pe runnerele GitHub
- Remote Caching înseamnă încă un serviciu și încă un token, iar fiecare potrivire de cache trece prin rețea.
actions/cachepentru.turboscrie o intrare la fiecare rulare și concurează pentru aceiași 10 GB cu store-ul pnpm, layerele Docker și cache-urile fiecărui branch; intrările nefolosite de 7 zile dispar.- Un runner mai puternic înseamnă un runner mare pe GitHub Team sau Enterprise Cloud, facturat la minut.
Când soluția e o mașină care își păstrează discul
CI-ul propriu al astro, cu workflow-ul neschimbat, din rulările noastre ale unor proiecte reale:
| GitHub (repository public, 4 vCPU, 16 GB) | Mașina dedicată Skipbox (4 vCPU) | |
|---|---|---|
| Job | 528 s | 30 s (31 s, 28 s) |
| Taskuri de build | 40 rulate | 40 reluate din cache-ul turbo |
| Taskul de test | rulează | reluat din cache-ul turbo |
Mașina dedicată a păstrat .turbo din checkout și store-ul pnpm de la jobul anterior, așa că turbo a găsit rezultatul fiecărui task fără să descarce nimic. turbo reia un task doar când inputurile lui au același hash, așa că un commit real rulează din nou pachetele pe care le atinge și le reia pe celelalte.
Skipbox păstrează starea monorepo-ului
Fiecare plan vine cu mașina dedicată a contului tău, păstrată între joburi:
- Store-ul pnpm rămâne în
~/.local/share/pnpm/store, împreună cu cache-ul npm și~/.cacheal fiecărui instrument.pnpm installleagă de pe disc în loc să descarce. - Cache-ul turbo rămâne.
.turbode la rădăcina checkoutului e păstrat între joburi cândturbo.jsone de turbo 2: o cheietasks, fărăpipelineși fără"envMode": "loose". FărăTURBO_TOKEN, fără pas de cache. node_modulese șters după fiecare job, așa că o matrice de versiuni Node care împarte un checkout nu încarcă niciodată un addon nativ compilat pentru alt Node.- Instrumentele rămân: versiunile de Node instalate de
setup-node, pnpm însuși, imaginile și layerele Docker.
Cel puțin de 7× spațiul de cache de la GitHub, pe S. Un job își alege mărimea prin etichetă:
| Etichetă | Mașină | Plan |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S, $39 pe lună |
skipbox-8x16 | 8 vCPU · 16 GB | M, $79 pe lună |
skipbox-16x32 | 16 vCPU · 32 GB | L, $149 pe lună |
Minutele sunt nelimitate. La 20.000 de minute pe lună pe 4 vCPU, GitHub facturează $222; Skipbox S costă $39, cu $183 mai puțin.
Mutarea înseamnă o singură linie
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
- Conectează-te la Skipbox cu GitHub.
- Instalează aplicația GitHub Skipbox și alege repository-urile.
- Schimbă
runs-onși fă push.
Păstrează pașii de cache așa cum sunt; ce salvează ei rămâne lângă mașină.
Securitate
- Mașina este doar a contului tău. Niciun job al altei companii nu rulează pe ea.
- După fiecare job, credențialele runnerului, procesele și containerele sunt șterse, la fel și credențialele git, hookurile și fișierele neurmărite din checkoutul păstrat. „Curățare la fiecare job” îi dă în schimb fiecărui job o mașină nouă.
- Codul de la persoane fără acces de scriere (cum ar fi pull request-urile din forkuri) rulează pe un VM nou, care îți citește cache-urile, dar nu le poate modifica.
Detaliile sunt în cum sunt izolate joburile.
Încearcă pe monorepo
Perioada de probă este gratuită timp de 7 zile sau 3.000 de minute de job, oricare se termină mai întâi, și nu cere card. Mută jobul de build pe runs-on: skipbox, rulează-l de două ori și pune liniile de instalare și turbo de la a doua rulare (cached față de executing) lângă cele de pe GitHub.
Întrebări frecvente
Cum accelerez un monorepo mare pnpm/Turborepo în GitHub Actions?
Trei lucruri, în ordine. Rulează doar ce s-a schimbat: turbo run build --affected, cu un checkout care are istoric (fetch-depth: 0 și filter: blob:none). Dă-i lui turbo un cache care supraviețuiește jobului: Remote Cache de la Turborepo sau .turbo restaurat cu actions/cache. Și păstrează store-ul pnpm: cache: pnpm din setup-node sau actions/cache pe calea store-ului. Pe VM-urile noi ale GitHub, fiecare dintre ele e o descărcare la fiecare job; pe o mașină care își păstrează discul, sunt deja acolo. CI-ul astro a durat 528 s pe GitHub și 30 s pe o mașină dedicată Skipbox care păstrează cache-ul turbo și store-ul pnpm.
De ce e lent pnpm install în GitHub Actions, chiar cu store-ul în cache?
Pentru că un store restaurat tot e o arhivă descărcată și dezarhivată pe un VM nou, iar pnpm leagă apoi node_modules pentru fiecare pachet din workspace. Chiar documentația pnpm pentru CI spune că nu e garantat că punerea store-ului în cache face instalarea mai rapidă. Un store aflat deja pe discul mașinii sare peste descărcare; rămâne doar legarea.
Funcționează cache-ul Turborepo în GitHub Actions?
Doar dacă cache-ul supraviețuiește jobului. Turborepo ține rezultatele taskurilor în .turbo/cache pe mașină, iar mașina unui job găzduit de GitHub dispare când jobul se termină. Așa că CI-ul are nevoie de Remote Caching (TURBO_TOKEN și TURBO_TEAM, de la Vercel sau self-hosted) sau de un pas actions/cache pentru .turbo. Pe o mașină dedicată Skipbox, .turbo din checkout rămâne între joburi pentru proiectele turbo 2, așa că turbo reia taskurile neschimbate fără niciun cache la distanță.
Funcționează turbo --affected în GitHub Actions?
Da. Turborepo citește GITHUB_BASE_REF la pull request-uri și GITHUB_EVENT_PATH la push-uri ca să găsească baza cu care compară. Are nevoie de istoric: cu o clonă superficială, fiecare pachet contează ca schimbat. Setează fetch-depth: 0 și filter: blob:none pe actions/checkout.
Ce păstrează Skipbox pentru un monorepo Turborepo?
Store-ul pnpm, cache-ul npm și cache-urile fiecărui instrument, instrumentele instalate de setup-node, layerele Docker și checkoutul cu .turbo de la rădăcină, când turbo.json e de turbo 2 (o cheie tasks, fără pipeline, fără envMode loose). node_modules e șters după fiecare job, așa că instalarea rulează, din store-ul aflat pe disc. turbo reia un task doar când inputurile lui au același hash, așa că un commit rulează din nou ce atinge.
Cât costă să încerc?
Nimic. Perioada de probă durează 7 zile sau 3.000 de minute de job, oricare se termină mai întâi, fără card. Mută jobul de build al monorepo-ului pe runs-on: skipbox, rulează-l de două ori și compară pașii de instalare și turbo de la a doua rulare cu cei de pe GitHub.
Actualizat pe 13 noiembrie 2026