GitHub-Actions-Cache · Artefakte · Turborepo

Ihr CI-Cache in Ihrem eigenen Cloudflare-Konto

Die Standard-Actions actions/cache und upload-artifact cachen ohne Workflow-Änderungen über CacheFlow, Turborepo mit einem einzigen Setup-Schritt. Fügen Sie eine Trusted-Consumer-Richtlinie hinzu, und Ihre Release-Jobs stellen nur wieder her, was ein vertrauenswürdiger Build erzeugt hat.

Ein Cache, der Ihnen gehört, dem Sie vertrauen und in den Sie hineinsehen können

Besitzen

Ihr Konto, Ihre Bytes

CacheFlow läuft in Ihrem Cloudflare-Konto: Cache- und Artefakt-Bytes liegen nie bei Dritten, und die Ressourcen erscheinen auf Ihrer eigenen Cloudflare-Rechnung.

  • Artefakt-Bytes in R2, ohne Egress-Gebühren
  • Schlüsselbesitz in D1, ein schneller Lesepfad in KV, laufende Sessions in Durable Objects
  • Ein Deployment bedient den Actions-Cache, Actions-Artefakte und den Turborepo-Remote-Cache

Vertrauen

Nur wiederherstellen, was ein vertrauenswürdiger Build gespeichert hat

Einträge, die mit einem GitHub-OIDC-Token gespeichert werden, wie es die CacheFlow-Actions tun, halten Event, Ref, Commit und Workflow ihrer Herkunft fest. Fügen Sie eine Trusted-Consumer-Richtlinie hinzu, und Ihre Release-Jobs stellen nur Einträge wieder her, die ein Push, ein geplanter oder ein manueller Lauf auf Ihrem geschützten Branch gespeichert hat.

  • Nur kurzlebige Credentials: GitHub OIDC für die CacheFlow-Actions, GitHubs eigenes Runtime-Token für Jobs mit Standard-Actions
  • Jeder Branch schreibt nur in seinen eigenen Scope und liest über seinen Basis-Branch und den Default-Branch
  • Bei OIDC-Jobs werden Speichervorgänge aus Events, die Außenstehende auf einem geschützten Branch auslösen können, etwa pull_request_target, unter Quarantäne gestellt; Jobs mit Standard-Actions folgen der Cache-Berechtigung, die GitHub selbst erteilt

Durchblicken

Kennen Sie Ihre Trefferquote

Jede Wiederherstellung, jeder Fehltreffer und jeder Speichervorgang im Actions-Cache und bei Artefakten wird mit seinen Bytes erfasst, ebenso Turborepo-Downloads und -Uploads, einschließlich der Angabe, ob eine Wiederherstellung ihren exakten Schlüssel getroffen hat oder auf ein Präfix zurückgefallen ist.

  • Actions-Cache-Schlüssel und Artefaktnamen werden nur als Keyed Hash erfasst, nie im Wortlaut
  • Sessions puffern Schreibvorgänge paralleler Matrix-Jobs und committen sie atomar
  • Veraltete Sessions werden bereinigt, wenn Builds enden oder in ein Timeout laufen

Starten Sie dort, wo Sie schon sind

Vier Einstiege, von null Änderungen bis zur vollen Kontrolle. Die meisten Teams beginnen mit dem ersten und fassen nie einen Workflow an.

  1. Null Änderungen

    Behalten Sie Ihre bestehenden Workflows

    Richten Sie Ihre Runner einmalig auf CacheFlow aus. Die Standard-Actions actions/cache, setup-node, Swatinem/rust-cache und upload-artifact cachen dann unverändert darüber. Auf GitHub-gehosteten Runnern greift derselbe Workflow auf den Cache von GitHub zurück.

    # runner environment: set once, per runner pool
    ACTIONS_RESULTS_URL=https://cache.cacheflow.sh/
    
    # your workflows: unchanged
    - uses: actions/cache@v4
    - uses: Swatinem/rust-cache@v2
    - uses: actions/upload-artifact@v4
  2. Ein Schritt

    Nichts neu bauen, was Turborepo schon gebaut hat

    Fügen Sie setup-cacheflow hinzu, und jeder Task mit unveränderten Eingaben spielt seine Ausgaben wieder ein, statt erneut zu laufen — über Jobs, Branches und Repositories hinweg.

    Den vollständigen Workflow ansehen ↓
  3. Release-tauglich

    Nur ausliefern, was ein vertrauenswürdiger Build erzeugt hat

    Speichern Sie Release- und Deploy-Caches über die CacheFlow-Actions. Jeder Eintrag hält Event, Ref, Commit und Workflow seiner Herkunft fest. Mit einer Trusted-Consumer-Richtlinie stellen Ihre Release-Jobs nur Einträge wieder her, die ein Push, ein geplanter oder ein manueller Lauf auf Ihrem geschützten Branch gespeichert hat.

    # the job needs permissions: { contents: read, id-token: write }
    - uses: CaptainEmpower/cacheflow/.github/actions/cache/save@v1
      with:
        path: dist
        key: release-${{ github.sha }}
        cache-url: ${{ vars.CACHEFLOW_CACHE_URL }}
    
    # Rust: the rust-cache fork, same attestation
    - uses: CaptainEmpower/rust-cache@v2-cacheflow
      with:
        cache-provider: cacheflow
  4. Jedes Tool

    Alles über die Kommandozeile cachen

    Die cacheflow CLI und das Python SDK speichern beliebige Artefakte aus jedem Build-Tool und stellen sie wieder her. Sessions puffern Schreibvorgänge paralleler Matrix-Jobs und committen sie atomar, sodass kein Job einen anderen überschreibt.

    # In a GitHub Actions step after setup-cacheflow, which exports
    # CACHEFLOW_CACHE_URL, CACHEFLOW_TOKEN, CACHEFLOW_TENANT,
    # CACHEFLOW_REPOSITORY and CACHEFLOW_BRANCH (export them yourself
    # elsewhere). GITHUB_SHA is set by Actions.
    cacheflow cache namespace ci-build   # idempotent
    SESSION=$(cacheflow session start --namespace ci-build)
    cacheflow cache put ci-build "dist-$GITHUB_SHA" dist.tar.gz \
      --session "$SESSION"
    cacheflow session commit --namespace ci-build \
      --session "$SESSION" --status success
    cacheflow cache get ci-build "dist-$GITHUB_SHA" --out dist.tar.gz

Turborepo-Remote-Cache in einem Schritt

setup-cacheflow stellt ein kurzlebiges OIDC-Credential aus und exportiert TURBO_API, TURBO_TOKEN und TURBO_TEAM. Keine gespeicherten Secrets:

permissions:
  contents: read
  id-token: write

jobs:
  build:
    runs-on: ${{ vars.CI_RUNNER_LARGE || vars.CI_RUNNER_DEFAULT }}
    steps:
      - uses: actions/checkout@v4
      # exports TURBO_API, TURBO_TOKEN and TURBO_TEAM
      - uses: CaptainEmpower/cacheflow/.github/actions/setup-cacheflow@v1
        with:
          api-url: ${{ vars.CACHEFLOW_TURBO_API }}
          install-cli: 'false'
      - run: pnpm install --frozen-lockfile
      - run: pnpm turbo run build

Was Teams zuerst fragen

Müssen wir unsere Workflows ändern?
Nicht für den Actions-Cache und Artefakte. Richten Sie die Umgebung Ihrer Runner einmalig auf CacheFlow aus, und die Standard-Actions actions/cache, setup-node, Swatinem/rust-cache und upload-artifact nutzen es unverändert. Auf GitHub-gehosteten Runnern verwenden dieselben Workflows weiterhin den Cache von GitHub. Der Turborepo-Remote-Cache erfordert einen setup-cacheflow-Schritt pro Workflow.
Wo liegen unsere Daten?
In Ihrem Cloudflare-Konto: Bytes in R2, Schlüsselbesitz in D1, ein Lesepfad in KV und laufende Sessions in Durable Objects. Die Telemetrie erfasst Actions-Cache-Schlüssel und Artefaktnamen nur als Keyed Hash. Außerdem planen wir einen Managed-Tarif, den CacheFlow für Sie betreibt.
Was kostet es?
Die Cloudflare-Ressourcen, die CacheFlow nutzt, werden Ihrem eigenen Cloudflare-Konto in Rechnung gestellt, und R2 erhebt keine Egress-Gebühren. Die Preise für CacheFlow selbst teilen wir Teams im Frühzugang mit.
Ist es schneller als der Cache von GitHub?
Wir machen keine Aussage zur Geschwindigkeit. Die Bytes kommen über das Internet aus Cloudflare R2, und wir haben keinen Geschwindigkeitsvorteil beim Wiederherstellen gemessen. Wenn Sie einen Cache direkt neben dem Runner brauchen, passt der Cache eines Runner-Anbieters womöglich besser zu Ihnen.
Wie authentifizieren sich Jobs?
Jobs, die die CacheFlow-Actions oder setup-cacheflow nutzen, tauschen ein kurzlebiges GitHub-OIDC-Token ein. Jobs, die direkt die Standard-Actions nutzen, verwenden das Runtime-Token, das GitHub ohnehin jedem Job mitgibt. In beiden Fällen wird in Ihren Pipelines kein langlebiges Secret gespeichert. Andere CI-Systeme und Entwickler-Laptops nutzen ein Token, das Ihr Operator ausstellt.
Können wir zurückwechseln?
Ja. CacheFlow spricht die Protokolle, die Ihre Tools bereits verwenden: die Cache- und Artefakt-Dienste von Actions und den Turborepo-Remote-Cache. Entfernen Sie die Runner-Einstellung oder den setup-cacheflow-Schritt, und Ihre Workflows kehren zu dem Cache zurück, den sie vorher genutzt haben.

Frühzugang sichern

Tragen Sie sich auf die Warteliste ein — wir melden uns, sobald Ihr Team starten kann.