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ść 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.
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 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ę:
- 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. 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:
- Remote Caching. Ustaw
TURBO_TOKENiTURBO_TEAM(Vercel Remote Cache albo własny serwer). Każde trafienie to pobieranie z niego. actions/cachena.turbo. Klucz${{ runner.os }}-turbo-${{ github.sha }}zrestore-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 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/cachedla.turbozapisuje 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:
| GitHub (repozytorium publiczne, 4 vCPU, 16 GB) | Dedykowana maszyna Skipbox (4 vCPU) | |
|---|---|---|
| Zadanie | 528 s | 30 s (31 s, 28 s) |
| 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~/.cachekażdego narzędzia.pnpm installlinkuje z dysku, zamiast pobierać. - Cache turbo zostaje.
.turbona najwyższym poziomie checkoutu jest zachowywany między zadaniami, gdyturbo.jsonjest w formacie turbo 2: klucztasks, bezpipelinei bez"envMode": "loose". BezTURBO_TOKEN, bez kroku cache. node_modulesjest 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
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
- Zaloguj się do Skipbox przez GitHuba.
- Zainstaluj aplikację Skipbox w GitHubie i wybierz repozytoria.
- Zmień
runs-oni 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.
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 19 listopada 2026