GitHub Actions-cache · artefacten · Turborepo

Je CI-cache, in je eigen Cloudflare-account

Standaard actions/cache en upload-artifact cachen via CacheFlow zonder workflowwijzigingen, en Turborepo met één setupstap. Voeg een trusted-consumer-policy toe, en je releasejobs herstellen alleen wat een vertrouwde build heeft gemaakt.

Een cache die van jou is, die je vertrouwt en waar je in kunt kijken

Van jou

Jouw account, jouw bytes

CacheFlow draait op je Cloudflare-account, dus cache- en artefactbytes liggen nooit bij een derde partij en de resources verschijnen op je eigen Cloudflare-rekening.

  • Artefactbytes in R2, zonder egresskosten
  • Sleuteleigendom in D1, een snel leespad in KV, lopende sessies in Durable Objects
  • Eén deployment bedient de Actions-cache, Actions-artefacten en de Turborepo remote cache

Te vertrouwen

Herstel alleen wat een vertrouwde build heeft opgeslagen

Entries die met een GitHub OIDC-token zijn opgeslagen, zoals de CacheFlow-actions doen, leggen het event, de ref, de commit en de workflow erachter vast. Voeg een trusted-consumer-policy toe, en je releasejobs herstellen alleen entries die een push, een geplande of een handmatige run op je beschermde branch heeft opgeslagen.

  • Alleen kortlevende credentials: GitHub OIDC voor de CacheFlow-actions, het eigen runtimetoken van GitHub voor jobs met standaard actions
  • Elke branch schrijft alleen naar zijn eigen scope en leest via zijn basisbranch en de standaardbranch
  • Bij OIDC-jobs worden opslagacties van events die buitenstaanders op een beschermde branch kunnen triggeren, zoals pull_request_target, in quarantaine geplaatst; jobs met standaard actions volgen de cachetoegang die GitHub zelf verleent

Inzichtelijk

Ken je hitrate

Elke restore, miss en save van de Actions-cache en artefacten wordt met de bijbehorende bytes vastgelegd, net als Turborepo-downloads en -uploads, inclusief of een restore de exacte sleutel trof of terugviel op een prefix.

  • Actions-cachesleutels en artefactnamen worden alleen als keyed hash vastgelegd, nooit zoals ze geschreven zijn
  • Sessies bufferen schrijfacties van parallelle matrixjobs en committen ze atomair
  • Verouderde sessies worden opgeruimd wanneer builds klaar zijn of een time-out krijgen

Begin waar je nu al staat

Vier instappunten, van nul wijzigingen tot volledige controle. De meeste teams beginnen met de eerste en passen nooit een workflow aan.

  1. Nul wijzigingen

    Houd je bestaande workflows

    Richt je runners één keer op CacheFlow. Standaard actions/cache, setup-node, Swatinem/rust-cache en upload-artifact cachen daarna via CacheFlow, zonder aanpassingen. Op door GitHub gehoste runners valt dezelfde workflow terug op de cache van GitHub.

    # 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. Eén stap

    Bouw niet opnieuw wat Turborepo al heeft gebouwd

    Voeg setup-cacheflow toe en elke taak waarvan de inputs niet zijn veranderd, speelt zijn outputs opnieuw af in plaats van opnieuw te draaien — over jobs, branches en repositories heen.

    Bekijk de volledige workflow ↓
  3. Releaseklaar

    Ship alleen wat een vertrouwde build heeft gemaakt

    Sla release- en deploycaches op via de CacheFlow-actions. Elke entry legt het event, de ref, de commit en de workflow erachter vast. Voeg een trusted-consumer-policy toe, en je releasejobs herstellen alleen entries die een push, een geplande of een handmatige run op je beschermde branch heeft opgeslagen.

    # 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. Elke tool

    Cache alles vanaf de command line

    De cacheflow CLI en Python SDK slaan elk artefact van elke buildtool op en herstellen het. Sessies bufferen schrijfacties van parallelle matrixjobs en committen ze atomair, zodat geen enkele job een andere overschrijft.

    # 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 één stap

setup-cacheflow maakt een kortlevende OIDC-credential aan en exporteert TURBO_API, TURBO_TOKEN en TURBO_TEAM. Geen opgeslagen 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

Vragen die teams als eerste stellen

Moeten we onze workflows aanpassen?
Niet voor de Actions-cache en artefacten. Richt de omgeving van je runners één keer op CacheFlow, en standaard actions/cache, setup-node, Swatinem/rust-cache en upload-artifact gebruiken het zonder aanpassingen. Op door GitHub gehoste runners blijven dezelfde workflows de cache van GitHub gebruiken. De Turborepo remote cache vereist één setup-cacheflow-stap per workflow.
Waar staan onze gegevens?
In je Cloudflare-account: bytes in R2, sleuteleigendom in D1, een leespad in KV en lopende sessies in Durable Objects. Telemetrie legt Actions-cachesleutels en artefactnamen alleen vast als keyed hash. We plannen ook een beheerd abonnement dat CacheFlow voor je draait.
Wat kost het?
De Cloudflare-resources die CacheFlow gebruikt, worden gefactureerd aan je eigen Cloudflare-account, en R2 rekent geen egresskosten. De prijzen van CacheFlow zelf delen we met teams met vroege toegang.
Is het sneller dan de cache van GitHub?
We doen geen uitspraak over snelheid. Bytes komen via het internet uit Cloudflare R2, en we hebben geen snelheidsvoordeel bij restores gemeten. Heb je een cache naast de runner nodig, dan past de cache van een runnerleverancier misschien beter bij je.
Hoe authenticeren jobs zich?
Jobs die de CacheFlow-actions of setup-cacheflow gebruiken, wisselen een kortlevend GitHub OIDC-token in. Jobs die rechtstreeks op standaard actions draaien, gebruiken het runtimetoken dat GitHub al aan elke job geeft. Hoe dan ook wordt er geen langlevend secret in je pipelines opgeslagen. Andere CI-systemen en laptops van developers gebruiken een token dat je operator uitgeeft.
Kunnen we terugschakelen?
Ja. CacheFlow spreekt de protocollen die je tools al gebruiken: de cache- en artefactservices van Actions en de Turborepo remote cache. Verwijder de runnerinstelling of de setup-cacheflow-stap, en je workflows gaan terug naar de cache die ze eerder gebruikten.

Krijg vroege toegang

Zet je op de wachtlijst en we nemen contact op zodra je team kan starten.