# Przyspiesz monorepo z pnpm i Turborepo w GitHub Actions (astro: z 528 s do 30 s)

> W monorepo z pnpm i Turborepo w GitHub Actions większość czasu to pnpm install na nowej VM i turbo wykonujący zadania, których wyników na niej nie ma. Uruchamiaj tylko pakiety, których dotyczy zmiana, daj turbo cache i zachowaj magazyn pnpm. Albo uruchamiaj zadania na maszynie, która zachowuje jedno i drugie: CI projektu astro zeszło z 528 s w GitHubie do 30 s w Skipbox, za stałe $39 miesięcznie.

W monorepo z pnpm i Turborepo w GitHub Actions większość wolnego zadania to dwa kroki: `pnpm install` na nowej VM i `turbo run build test` wykonujący zadania, których wyników VM nie ma. Naprawiaj je w tej kolejności. Uruchamiaj tylko pakiety, których dotyczy zmiana (`turbo run build --affected`, z checkoutem, który ma historię). Daj turbo cache, który przetrwa zadanie, bo jego wyniki są w `.turbo/cache` na maszynie, którą GitHub usuwa po każdym zadaniu: Remote Caching albo `.turbo` przywracany przez `actions/cache`. I zachowaj magazyn pnpm. Na runnerach GitHuba każdy z tych cache to pobieranie w każdym zadaniu. Na maszynie, która zachowuje dysk, po prostu tam są: zadanie CI projektu astro trwało 528 s w GitHubie i 30 s na dedykowanej maszynie Skipbox, która odtworzyła wszystkie 40 zadań buildu z zachowanego cache turbo.

Skipbox uruchamia Twoje zadania na dedykowanej maszynie Twojego konta, która zachowuje magazyn pnpm, narzędzia i `.turbo` checkoutu między zadaniami, bez zdalnego cache i bez kluczy cache. Zmień jedną linię, `runs-on: skipbox`, za stałe $39 miesięcznie, z minutami bez limitu.

- CI projektu astro: 528 s w GitHubie, 30 s w Skipbox, z turbo odtwarzającym 40 zadań buildu i zadanie testów
- Magazyn pnpm i `.turbo` zostają na Twojej maszynie: bez zdalnego cache do konfigurowania, bez archiwum do pobierania
- 20 000 minut miesięcznie na 4 vCPU: $222 w GitHubie, $39 w Skipbox

**GitHub Actions w stałej cenie, minuty bez limitu** Skipbox uruchamia Twoje zadania GitHub Actions na Twojej własnej, dedykowanej maszynie: $39 miesięcznie, niezależnie od liczby minut. Warstwy Dockera i cache zależności zostają między zadaniami, więc kolejne zadanie startuje od razu.

Runner 4 vCPU, 20 000 minut miesięcznie: GitHub $222 → Skipbox $39. Oszczędzasz $183 co miesiąc.

Przejście to jedna linia: `runs-on: skipbox`.

[Rozpocznij 7-dniowy okres próbny](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-pl)

## Na co zadanie w monorepo traci czas

| Krok | Na nowej VM GitHuba |
|---|---|
| Checkout | Domyślnie płytki klon; `--affected` potrzebuje historii, więc pełny |
| Przygotowanie Node i pnpm | Pobierane, chyba że tool cache ma tę wersję |
| `pnpm install` | Magazyn przywracany z archiwum cache (albo pobierany z rejestru), potem `node_modules` linkowane dla każdego pakietu |
| `turbo run build` | Wykonuje się każde zadanie, chyba że przywrócono `.turbo/cache` albo odpowiada zdalny cache |
| `turbo run test` | To samo, na 2 CPU na `ubuntu-latest` repozytorium prywatnego |

## 1. Uruchamiaj tylko to, co się zmieniło

Według [przewodnika Turborepo o CI](https://turborepo.dev/docs/crafting-your-repository/constructing-ci) `turbo run build --affected` wykonuje zadania tylko w pakietach zmienionych względem gałęzi bazowej. W GitHub Actions czyta `GITHUB_BASE_REF` w pull requestach i `GITHUB_EVENT_PATH` przy pushach. Przy płytkim klonie każdy pakiet liczy się jako zmieniony, więc pobierz historię:

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

`turbo query affected --packages web` mówi zadaniu, czy w ogóle ma się wykonać, więc zadanie dla nietkniętej aplikacji może pominąć instalację.

## 2. Daj turbo cache, który przetrwa zadanie

Turborepo przechowuje wyniki zadań w `.turbo/cache` [na maszynie](https://turborepo.dev/docs/crafting-your-repository/caching). Maszyna zadania hostowanego przez GitHub jest usuwana, gdy zadanie się kończy, więc w CI ten cache za każdym razem startuje pusty. Dwa obejścia, według [przewodnika Turborepo dla GitHub Actions](https://turborepo.dev/docs/guides/ci-vendors/github-actions):

- **Remote Caching.** Ustaw `TURBO_TOKEN` i `TURBO_TEAM` (Vercel Remote Cache albo własny serwer). Każde trafienie to pobieranie z niego.
- **`actions/cache` na `.turbo`.** Klucz `${{ runner.os }}-turbo-${{ github.sha }}` z `restore-keys: ${{ runner.os }}-turbo-`. Zapisuje nowy wpis przy każdym uruchomieniu, w ramach 10 GB GitHuba na repozytorium, razem ze wszystkim innym, co repozytorium zapisuje w cache.

## 3. Zachowaj magazyn pnpm

`actions/setup-node` z `cache: pnpm` albo `actions/cache` na `pnpm store path` przywraca magazyn z kluczem z `pnpm-lock.yaml`. Nie przywraca `node_modules`, więc pnpm i tak linkuje każdy pakiet. [Dokumentacja pnpm o CI](https://pnpm.io/continuous-integration) mówi wprost, że zapisanie magazynu w cache nie gwarantuje szybszej instalacji. W CI pnpm sam przełącza się na `--frozen-lockfile`.

## 4. Wykorzystaj rdzenie

turbo uruchamia niezależne zadania równolegle, a każde narzędzie buildu czy testów startuje własne workery, więc monorepo wykorzystuje każdy rdzeń, jaki dostanie. `ubuntu-latest` repozytorium prywatnego ma 2.

## Ile kosztuje każda poprawka na runnerach GitHuba

- **Remote Caching** to kolejna usługa i kolejny token, a każde trafienie cache idzie przez sieć.
- **`actions/cache` dla `.turbo`** zapisuje wpis przy każdym uruchomieniu i rywalizuje o te same 10 GB z magazynem pnpm, warstwami Dockera i cache każdej gałęzi; wpisy nieużywane przez 7 dni znikają.
- **Większa maszyna** to większy runner w GitHub Team albo Enterprise Cloud, z naliczaniem za minutę.

## Gdy rozwiązaniem jest maszyna, która zachowuje dysk

Własne CI projektu astro, z niezmienionym workflow, według [naszych uruchomień prawdziwych projektów](https://skipbox.dev/pl/guides/rust-cache-slow-rust-ci):

| | GitHub (repozytorium publiczne, 4 vCPU, 16 GB) | Dedykowana maszyna Skipbox (4 vCPU) |
|---|---|---|
| Zadanie | 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)) |
| Zadania buildu | 40 wykonanych | 40 odtworzonych z cache turbo |
| Zadanie testów | wykonuje się | odtworzone z cache turbo |

Dedykowana maszyna zachowała `.turbo` checkoutu i magazyn pnpm z poprzedniego zadania, więc turbo znalazł wynik każdego zadania i nie musiał niczego pobierać. turbo odtwarza zadanie tylko wtedy, gdy hash jego wejść jest taki sam, więc prawdziwy commit uruchamia ponownie pakiety, których dotyczy, a resztę odtwarza.

## Skipbox zachowuje stan monorepo

Każdy plan ma dedykowaną maszynę Twojego konta, która zostaje między zadaniami:

- **Magazyn pnpm zostaje** w `~/.local/share/pnpm/store`, razem z cache npm i `~/.cache` każdego narzędzia. `pnpm install` linkuje z dysku, zamiast pobierać.
- **Cache turbo zostaje.** `.turbo` na najwyższym poziomie checkoutu jest zachowywany między zadaniami, gdy `turbo.json` jest w formacie turbo 2: klucz `tasks`, bez `pipeline` i bez `"envMode": "loose"`. Bez `TURBO_TOKEN`, bez kroku cache.
- **`node_modules` jest usuwany po każdym zadaniu**, więc macierz wersji Node korzystająca z jednego checkoutu nigdy nie wczyta natywnego dodatku zbudowanego dla innej wersji Node.
- **Narzędzia zostają:** wersje Node zainstalowane przez `setup-node`, sam pnpm, obrazy i warstwy Dockera.

Co najmniej 7× więcej miejsca na cache niż w GitHubie, już w S. Zadanie wybiera rozmiar etykietą:

| Etykieta | Maszyna | Plan |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 miesięcznie |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 miesięcznie |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 miesięcznie |

Minuty są bez limitu. Przy 20 000 minut miesięcznie na 4 vCPU GitHub nalicza $222; Skipbox S to $39, o $183 mniej.

## Przejście to jedna linia

```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. Zaloguj się do Skipbox przez GitHuba.
2. Zainstaluj aplikację Skipbox w GitHubie i wybierz repozytoria.
3. Zmień `runs-on` i zrób push.

Zostaw kroki cache bez zmian; to, co zapisują, zostaje obok maszyny.

## Bezpieczeństwo

- Maszyna należy tylko do Twojego konta. Nie działają na niej zadania żadnej innej firmy.
- Po każdym zadaniu usuwane są dane uwierzytelniające runnera, procesy i kontenery, a także dane uwierzytelniające gita, hooki i nieśledzone pliki w zachowanym checkoucie. Opcja **Nowa VM dla każdego zadania** daje zamiast tego każdemu zadaniu nową maszynę.
- Kod od osób bez uprawnień do zapisu (na przykład pull requesty z forków) działa na nowej VM, która czyta Twój cache, ale nie może go zmienić.

Szczegóły są w artykule [jak zadania są od siebie odizolowane](https://docs.skipbox.dev/pl/isolation).

## Wypróbuj na swoim monorepo

Okres próbny jest bezpłatny przez 7 dni lub 3000 minut zadań, zależnie od tego, co nastąpi wcześniej, i nie wymaga karty. Przenieś zadanie buildu na `runs-on: skipbox`, uruchom je dwa razy i porównaj linie instalacji i turbo drugiego uruchomienia (`cached` wobec `executing`) z GitHubem.

## FAQ

### Jak przyspieszyć duże monorepo z pnpm i Turborepo w GitHub Actions?

Trzy rzeczy, po kolei. Uruchamiaj tylko to, co się zmieniło: turbo run build --affected, z checkoutem, który ma historię (fetch-depth: 0 i filter: blob:none). Daj turbo cache, który przetrwa zadanie: Remote Cache Turborepo albo .turbo przywracany przez actions/cache. I zachowaj magazyn pnpm: cache: pnpm w setup-node albo actions/cache na ścieżce magazynu. Na nowych VM-ach GitHuba każda z tych rzeczy to pobieranie w każdym zadaniu; na maszynie, która zachowuje dysk, są już na miejscu. CI projektu astro trwało 528 s w GitHubie i 30 s na dedykowanej maszynie Skipbox, która zachowuje cache turbo i magazyn pnpm.

### Dlaczego pnpm install jest wolny w GitHub Actions nawet z magazynem w cache?

Bo przywrócony magazyn to wciąż archiwum pobrane i rozpakowane na nowej VM, a potem pnpm linkuje node_modules dla każdego pakietu workspace'u. Sama dokumentacja pnpm o CI mówi, że zapisanie magazynu w cache nie gwarantuje szybszej instalacji. Magazyn, który już jest na dysku maszyny, pomija pobieranie; zostaje tylko linkowanie.

### Czy cache Turborepo działa w GitHub Actions?

Tylko jeśli cache przeżyje zadanie. Turborepo trzyma wyniki zadań w .turbo/cache na maszynie, a maszyna zadania hostowanego przez GitHub znika, gdy zadanie się kończy. CI potrzebuje więc Remote Caching (TURBO_TOKEN i TURBO_TEAM, od Vercela albo self-hosted) albo kroku actions/cache dla .turbo. Na dedykowanej maszynie Skipbox .turbo checkoutu zostaje między zadaniami w projektach z turbo 2, więc turbo odtwarza niezmienione zadania bez zdalnego cache.

### Czy turbo --affected działa w GitHub Actions?

Tak. Turborepo czyta GITHUB_BASE_REF w pull requestach i GITHUB_EVENT_PATH przy pushach, żeby znaleźć bazę do porównania. Potrzebuje historii: przy płytkim klonie każdy pakiet liczy się jako zmieniony. Ustaw fetch-depth: 0 i filter: blob:none w actions/checkout.

### Co Skipbox zachowuje dla monorepo z Turborepo?

Magazyn pnpm, cache npm i każdego narzędzia, narzędzia instalowane przez setup-node, warstwy Dockera oraz checkout z jego .turbo na najwyższym poziomie, gdy turbo.json jest w formacie turbo 2 (klucz tasks, bez pipeline, bez envMode loose). node_modules jest usuwany po każdym zadaniu, więc instalacja się wykonuje, z magazynu na dysku. turbo odtwarza zadanie tylko wtedy, gdy hash jego wejść jest taki sam, więc commit uruchamia ponownie to, czego dotyczy.

### Ile kosztuje wypróbowanie?

Nic. Okres próbny trwa 7 dni lub 3000 minut zadań, zależnie od tego, co nastąpi wcześniej, bez karty. Przenieś zadanie buildu monorepo na runs-on: skipbox, uruchom je dwa razy i porównaj kroki instalacji i turbo drugiego uruchomienia z GitHubem.

Zaktualizowano 2026-11-19 · https://skipbox.dev/pl/guides/pnpm-turborepo-monorepo-github-actions
