Was ist ein Remote-Build-Cache?
Zuletzt aktualisiert am
Ein Remote-Build-Cache ist ein gemeinsamer Speicher für Build- und Testergebnisse, die über einen Hash der Eingaben jeder Task zugeordnet werden. Wenn eine Maschine, in der CI oder auf dem Laptop eines Entwicklers, dieselbe Task mit denselben Eingaben benötigt, lädt sie das gespeicherte Ergebnis herunter, statt die Task erneut auszuführen.
So funktioniert es
Build-Tools wie Nx, Turborepo, Gradle und Bazel zerlegen die Arbeit in Tasks (Kompilieren, Linting, Testen, Bundling). Für jede Task berechnet das Tool einen Hash aus den Quelldateien, Abhängigkeiten, Umgebungsvariablen und dem Befehl. Vor der Ausführung fragt es den Cache mit diesem Hash an. Ein Treffer stellt die Ausgabedateien wieder her und spielt die Logs ab. Ein Fehlschlag führt die Task aus und lädt das Ergebnis hoch.
Das ist feinkörniger als ein Abhängigkeits-Cache. Ein actions/cache-Eintrag stellt einen Ordner für den gesamten Job wieder her. Ein Remote-Cache überspringt einzelne Tasks, sodass eine Änderung an einem Paket in einem Monorepo nur dieses Paket und seine abhängigen Pakete neu baut.
Da der Hash alle Eingaben umfasst, hängt die Korrektheit davon ab, dass sie sauber deklariert sind. Eine Task, die eine nicht deklarierte Datei liest, kann veraltete Ausgaben liefern.
Beispiel
Turborepo mit einem Remote-Cache, Zugangsdaten über Umgebungsvariablen:
jobs:
build:
runs-on: ubuntu-latest
env:
TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
TURBO_TEAM: ${{ vars.TURBO_TEAM }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npx turbo run build test lint
Nx funktioniert auf die gleiche Weise mit eigenen Cache-Einstellungen. Siehe den Leitfaden zu Monorepo-CI für Nx und Turborepo. compiler.dev unterstützt Remote-Caches für Nx und Turborepo sowie lokale Caches für Abhängigkeiten, Git und Docker-Layer. Details zu den Preisen.
Remote- versus lokaler Cache
- Der lokale Cache liegt auf der Festplatte einer einzelnen Maschine. Er ist kostenlos, aber jeder neue CI-Runner startet leer.
- Der Remote-Cache wird von Runnern und Personen gemeinsam genutzt, und genau das macht ihn für kurzlebige CI-Umgebungen nützlich.
Häufige Fehler
- Nicht deklarierte Eingaben. Umgebungsvariablen oder Dateien, die die Ausgabe beeinflussen, aber nicht im Hash enthalten sind, führen zu falschen Cache-Treffern.
- Nicht deterministische Ausgaben. Zeitstempel oder zufällige IDs in der Build-Ausgabe lassen jeden Lauf anders aussehen.
- Tests mit Netzwerkzugriff cachen. Ein gecachter Erfolg verdeckt eine fehlschlagende Abhängigkeit.
- Schreibzugriff aus Pull Requests von Forks. Cache-Poisoning ist ein reales Risiko. Gewähren Sie nicht vertrauenswürdigem Code nur Lesezugriff.
- Als Ersatz für das Cachen von Abhängigkeiten betrachten. Sie brauchen weiterhin eine schnelle Installation der Abhängigkeiten. Siehe Caching in GitHub Actions.
Verwandte Begriffe
FAQ
Ist ein Remote-Build-Cache sicher?
Behandeln Sie ihn wie ein Deployment-Ziel. Beschränken Sie den Schreibzugriff auf vertrauenswürdige Branches und bewahren Sie Tokens in Secrets auf.
Funktioniert er mit Docker-Builds?
Docker hat einen eigenen Layer-Cache. Siehe Docker-Layer-Caching in CI.
Wie viel spart er ein?
Das hängt davon ab, wie oft Tasks zwischen den Läufen unverändert bleiben. Monorepos mit kleinen Änderungen profitieren am meisten.
Verwandt
- Cargo- und Rust-Builds in GitHub Actions cachenCargo-Registry, Git-Abhängigkeiten und Target-Verzeichnis in GitHub Actions mit Swatinem/rust-cache oder actions/cache cachen, ohne aufgeblähte Caches.
- Go-Module und Build-Cache in GitHub Actions cachenGo-Module (GOMODCACHE) und Build-Cache (GOCACHE) in GitHub Actions mit setup-go oder actions/cache cachen. Keys, go.sum und Cache-Treffer prüfen.
- Gradle-Builds in GitHub Actions cachenGradle-Abhängigkeiten und Build-Cache in GitHub Actions mit gradle/actions/setup-gradle oder actions/cache cachen. Keys, PRs, Bereinigung, Checks.
- npm-Abhängigkeiten in GitHub Actions cachennpm-Abhängigkeiten in GitHub Actions cachen, mit setup-node oder actions/cache. Funktionierendes YAML, der richtige Key, warum nicht node_modules, und Treffer prüfen.