# 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 timpului înseamnă pnpm install pe un VM nou și turbo rulând taskuri ale căror rezultate nu sunt pe el. Rulează doar pachetele afectate, dă-i lui turbo un cache și păstrează store-ul pnpm. Sau rulează pe o mașină care le păstrează pe amândouă: CI-ul astro a coborât de la 528 s pe GitHub la 30 s pe Skipbox, la un preț fix de $39 pe lună.

Î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.

- CI-ul astro: 528 s pe GitHub, 30 s pe Skipbox, cu turbo reluând 40 de taskuri de build și taskul de test
- Store-ul pnpm și `.turbo` al turbo rămân pe mașina ta: niciun cache la distanță de configurat, nicio arhivă de descărcat
- 20.000 de minute pe lună pe 4 vCPU: $222 pe GitHub, $39 pe Skipbox

**GitHub Actions la preț fix, cu minute nelimitate** Skipbox rulează joburile tale GitHub Actions pe propria ta mașină dedicată: $39 pe lună, oricâte minute ai rula. Layerele Docker și cache-urile de dependențe rămân între joburi, așa că jobul următor pornește imediat.

Un runner de 4 vCPU, 20.000 de minute pe lună: GitHub $222 → Skipbox $39. Economisești $183 în fiecare lună.

E nevoie de o singură linie: `runs-on: skipbox`.

[Încearcă gratuit 7 zile](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-ro)

## 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](https://turborepo.dev/docs/crafting-your-repository/constructing-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:

```yaml
- 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ă](https://turborepo.dev/docs/crafting-your-repository/caching). 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](https://turborepo.dev/docs/guides/ci-vendors/github-actions):

- **Remote Caching.** Setează `TURBO_TOKEN` și `TURBO_TEAM` (Vercel Remote Cache sau un server self-hosted). Fiecare potrivire e o descărcare de acolo.
- **`actions/cache` pe `.turbo`.** Cheia `${{ runner.os }}-turbo-${{ github.sha }}` cu `restore-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](https://pnpm.io/continuous-integration) 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/cache` pentru `.turbo`** scrie 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](https://skipbox.dev/ro/guides/rust-cache-slow-rust-ci):

| | GitHub (repository public, 4 vCPU, 16 GB) | Mașina dedicată Skipbox (4 vCPU) |
|---|---|---|
| Job | 528 s | **30 s** ([31 s](https://github.com/skipbox-dev/astro/actions/runs/43351547473), [28 s](https://github.com/skipbox-dev/astro/actions/runs/43351638436)) |
| 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 `~/.cache` al fiecărui instrument. `pnpm install` leagă de pe disc în loc să descarce.
- **Cache-ul turbo rămâne.** `.turbo` de la rădăcina checkoutului e păstrat între joburi când `turbo.json` e de turbo 2: o cheie `tasks`, fără `pipeline` și fără `"envMode": "loose"`. Fără `TURBO_TOKEN`, fără pas de cache.
- **`node_modules` e ș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

```yaml
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. Conectează-te la Skipbox cu GitHub.
2. Instalează aplicația GitHub Skipbox și alege repository-urile.
3. 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](https://docs.skipbox.dev/ro/isolation).

## Î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 2026-11-13 · https://skipbox.dev/ro/guides/pnpm-turborepo-monorepo-github-actions
