Skipbox

Ein pnpm- und Turborepo-Monorepo in GitHub Actions beschleunigen (astro: 528 s auf 30 s)

In einem pnpm- und Turborepo-Monorepo auf GitHub Actions besteht der Großteil eines langsamen Jobs aus zwei Steps: pnpm install auf einer frischen VM und turbo run build test, das Tasks ausführt, deren Ergebnisse die VM nicht hat. Behebe sie in dieser Reihenfolge. Führ nur die Pakete aus, die eine Änderung berührt (turbo run build --affected, mit einem Checkout, der die Historie hat). Gib turbo einen Cache, der den Job überlebt, denn seine Ergebnisse liegen in .turbo/cache auf einer Maschine, die GitHub nach jedem Job löscht: Remote Caching oder .turbo, wiederhergestellt mit actions/cache. Und behalte den pnpm-Store. Auf den Runnern von GitHub ist jeder dieser Caches bei jedem Job ein Download. Auf einer Maschine, die ihre Festplatte behält, sind sie einfach da: Der CI-Job von astro brauchte auf GitHub 528 s und 30 s auf einer dedizierten Skipbox-Maschine, die alle 40 Build-Tasks aus dem behaltenen Cache von turbo wieder abspielte.

Skipbox führt deine Jobs auf der dedizierten Maschine deines Kontos aus, die den pnpm-Store, die Tools und das .turbo des Checkouts zwischen den Jobs behält, ohne Remote Cache und ohne Cache-Keys. Ändere eine Zeile, runs-on: skipbox, pauschal für $39 im Monat mit unbegrenzten Minuten.

Wo ein Monorepo-Job seine Zeit verbringt

1. Nur ausführen, was sich geändert hat

Aus der CI-Anleitung von Turborepo: turbo run build --affected führt Tasks nur in Paketen aus, die sich gegenüber dem Basis-Branch geändert haben. In GitHub Actions liest es bei Pull Requests GITHUB_BASE_REF und bei Pushes GITHUB_EVENT_PATH. Bei einem flachen Klon gilt jedes Paket als geändert, also checke die Historie aus:

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

turbo query affected --packages web sagt einem Job, ob er überhaupt laufen soll, also kann ein Job für eine unberührte App seine Installation überspringen.

2. Turbo einen Cache geben, der den Job überlebt

Turborepo speichert Task-Ergebnisse in .turbo/cache auf der Maschine. Die Maschine eines von GitHub gehosteten Jobs wird gelöscht, wenn er endet, also startet dieser Cache in der CI jedes Mal leer. Zwei Wege drumherum, aus der Anleitung von Turborepo für GitHub Actions:

  • Remote Caching. Setz TURBO_TOKEN und TURBO_TEAM (Vercel Remote Cache oder ein selbst gehosteter Server). Jeder Treffer ist ein Download von dort.
  • actions/cache auf .turbo. Key auf ${{ runner.os }}-turbo-${{ github.sha }} mit restore-keys: ${{ runner.os }}-turbo-. Er speichert bei jedem Lauf einen neuen Eintrag, innerhalb der 10 GB von GitHub pro Repository, zusammen mit allem anderen, was das Repository cacht.

3. Den pnpm-Store behalten

actions/setup-node mit cache: pnpm oder actions/cache auf pnpm store path stellt den Store mit einem Key aus pnpm-lock.yaml wieder her. Es stellt node_modules nicht wieder her, also verlinkt pnpm trotzdem jedes Paket. Die CI-Doku von pnpm sagt es klar: Das Cachen des Stores „is not guaranteed“, macht die Installation also nicht garantiert schneller. In der CI schaltet pnpm von selbst auf --frozen-lockfile.

4. Die Kerne nutzen

turbo führt unabhängige Tasks parallel aus, und jedes Build- oder Test-Tool startet seine eigenen Worker, also nutzt ein Monorepo jeden Kern, den es bekommt. Das ubuntu-latest eines privaten Repositorys hat 2.

Was jeder Fix auf den Runnern von GitHub kostet

  • Remote Caching ist ein weiterer Dienst und ein weiteres Token, und jeder Cache-Treffer geht über das Netzwerk.
  • actions/cache für .turbo schreibt bei jedem Lauf einen Eintrag und konkurriert um dieselben 10 GB wie der pnpm-Store, die Layer von Docker und die Caches jedes Branches; Einträge, die 7 Tage ungenutzt sind, fliegen raus.
  • Ein größerer Runner ist ein größerer Runner auf GitHub Team oder Enterprise Cloud, pro Minute berechnet.

Wenn der Fix eine Maschine ist, die ihre Festplatte behält

Die eigene CI von astro, ihr Workflow unverändert, aus unseren Läufen echter Projekte:

Die dedizierte Maschine behielt das .turbo des Checkouts und den pnpm-Store vom letzten Job, also fand turbo das Ergebnis jeder Task, ohne etwas herunterzuladen. turbo spielt eine Task nur wieder ab, wenn der Hash ihrer Eingaben gleich ist, also führt ein echter Commit die Pakete, die er berührt, erneut aus und spielt den Rest wieder ab.

Skipbox behält den Zustand des Monorepos

Zu jedem Tarif gehört die dedizierte Maschine deines Kontos, die zwischen den Jobs bestehen bleibt:

  • Der pnpm-Store bleibt in ~/.local/share/pnpm/store, mit dem Cache von npm und dem ~/.cache jedes Tools. pnpm install verlinkt von der Festplatte, statt herunterzuladen.
  • Der Cache von turbo bleibt. Das .turbo des Checkouts auf oberster Ebene bleibt zwischen den Jobs erhalten, wenn die turbo.json die von turbo 2 ist: ein tasks-Key, kein pipeline und kein "envMode": "loose". Kein TURBO_TOKEN, kein Cache-Step.
  • node_modules wird nach jedem Job gelöscht, damit eine Node-Versions-Matrix, die sich einen Checkout teilt, nie ein natives Addon lädt, das für eine andere Node-Version gebaut wurde.
  • Die Tools bleiben: die Node-Versionen, die setup-node installiert hat, pnpm selbst, die Images und Layer von Docker.

Mindestens 7× so viel Cache-Speicher wie bei GitHub auf S. Ein Job wählt seine Größe per Label:

Die Minuten sind unbegrenzt. Bei 20.000 Minuten im Monat auf 4 vCPU berechnet GitHub $222; Skipbox S kostet $39, $183 weniger.

Der Wechsel ist eine Zeile

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. Melde dich bei Skipbox mit GitHub an.
  2. Installiere die GitHub-App von Skipbox und wähle die Repositorys.
  3. Ändere runs-on und pushe.

Lass die Cache-Steps, wie sie sind; was sie speichern, bleibt neben der Maschine.

Sicherheit

  • Die Maschine gehört nur deinem Konto. Keine Jobs eines anderen Unternehmens laufen darauf.
  • Nach jedem Job werden die Zugangsdaten, Prozesse und Container des Runners gelöscht, ebenso die Git-Zugangsdaten, Hooks und nicht versionierten Dateien im behaltenen Checkout. „Frische VM für jeden Job“ gibt stattdessen jedem Job eine frische Maschine.
  • Code von Personen ohne Schreibzugriff (etwa Pull Requests aus Forks) läuft auf einer frischen VM, die deine Caches liest, aber nicht ändern kann.

Die Einzelheiten stehen unter Wie Jobs isoliert werden.

Probier es mit dem Monorepo

Die Testphase ist kostenlos für 7 Tage oder 3.000 Job-Minuten, je nachdem, was zuerst erreicht ist, und braucht keine Karte. Verschieb den Build-Job auf runs-on: skipbox, führe ihn zweimal aus und leg die Install- und turbo-Zeilen des zweiten Laufs (cached gegenüber executing) neben die von GitHub.

FAQ

Wie beschleunige ich ein großes pnpm/Turborepo-Monorepo in GitHub Actions?

Drei Dinge, der Reihe nach. Nur ausführen, was sich geändert hat: turbo run build --affected, mit einem Checkout, der die Historie hat (fetch-depth: 0 und filter: blob:none). Turbo einen Cache geben, der den Job überlebt: den Remote Cache von Turborepo oder .turbo, wiederhergestellt mit actions/cache. Und den pnpm-Store behalten: cache: pnpm von setup-node oder actions/cache auf dem Store-Pfad. Auf den frischen VMs von GitHub ist jedes davon bei jedem Job ein Download; auf einer Maschine, die ihre Festplatte behält, sind sie schon da. Die CI von astro brauchte auf GitHub 528 s und 30 s auf einer dedizierten Skipbox-Maschine, die den Cache von turbo und den pnpm-Store behält.

Warum ist pnpm install in GitHub Actions langsam, obwohl der Store gecacht ist?

Weil ein wiederhergestellter Store immer noch ein Archiv ist, das auf einer neuen VM heruntergeladen und entpackt wird, und pnpm danach node_modules für jedes Paket des Workspaces verlinkt. Die eigene CI-Doku von pnpm sagt, dass das Cachen des Stores die Installation nicht garantiert schneller macht. Ein Store, der schon auf der Festplatte der Maschine liegt, überspringt den Download; übrig bleibt nur das Verlinken.

Funktioniert der Turborepo-Cache in GitHub Actions?

Nur, wenn der Cache den Job überlebt. Turborepo hält Task-Ergebnisse in .turbo/cache auf der Maschine, und die Maschine eines von GitHub gehosteten Jobs ist weg, wenn er endet. Also braucht die CI Remote Caching (TURBO_TOKEN und TURBO_TEAM, von Vercel oder selbst gehostet) oder einen actions/cache-Step für .turbo. Auf einer dedizierten Skipbox-Maschine bleibt das .turbo des Checkouts bei Projekten mit turbo 2 zwischen den Jobs erhalten, also spielt turbo unveränderte Tasks ohne Remote Cache wieder ab.

Funktioniert turbo --affected in GitHub Actions?

Ja. Turborepo liest bei Pull Requests GITHUB_BASE_REF und bei Pushes GITHUB_EVENT_PATH, um die Basis für den Vergleich zu finden. Es braucht die Historie: Bei einem flachen Klon gilt jedes Paket als geändert. Setz fetch-depth: 0 und filter: blob:none in actions/checkout.

Was behält Skipbox für ein Turborepo-Monorepo?

Den pnpm-Store, die Caches von npm und jedem Tool, die Tools, die setup-node installiert, die Layer von Docker und den Checkout mit seinem .turbo auf oberster Ebene, wenn die turbo.json die von turbo 2 ist (ein tasks-Key, kein pipeline, nicht envMode loose). node_modules wird nach jedem Job gelöscht, also läuft die Installation, aus dem Store auf der Festplatte. turbo spielt eine Task nur wieder ab, wenn der Hash ihrer Eingaben gleich ist, also führt ein Commit erneut aus, was er berührt.

Was kostet es, das auszuprobieren?

Nichts. Die Testphase dauert 7 Tage oder 3.000 Job-Minuten, je nachdem, was zuerst erreicht ist, ohne Karte. Verschieb den Build-Job des Monorepos auf runs-on: skipbox, führe ihn zweimal aus und vergleich die Install- und turbo-Steps des zweiten Laufs mit denen von GitHub.

Aktualisiert am 19. November 2026

Schnellere CI/CD mit immer warmem Cache

Dein warmer Runner zum Festpreis

Wir hosten sie. Du änderst eine Zeile. 1/12 der Kosten von GitHub bei voller Auslastung. Zum Festpreis den ganzen Tag laufen lassen. 7× so viel Cache-Speicher wie bei GitHub.

  • Keine Karte
  • Mit GitHub anmelden
  • Jederzeit kündbar