Cache di GitHub Actions · artefatti · Turborepo

La tua cache CI, nel tuo account Cloudflare

actions/cache e upload-artifact, così come sono, passano dalla cache di CacheFlow senza modifiche ai workflow, e Turborepo con un solo step di configurazione. Aggiungi una policy di consumer affidabili e i tuoi job di rilascio ripristinano solo ciò che ha prodotto una build affidabile.

Una cache che possiedi, di cui ti fidi e che puoi vedere dall'interno

Possiedila

Il tuo account, i tuoi byte

CacheFlow gira sul tuo account Cloudflare: i byte della cache e degli artefatti non restano mai presso terzi e le risorse compaiono nella tua fattura Cloudflare.

  • Byte degli artefatti in R2, senza costi di egress
  • Proprietà delle chiavi in D1, un percorso di lettura veloce in KV, sessioni in corso nei Durable Objects
  • Un solo deployment serve la cache di Actions, gli artefatti di Actions e la cache remota di Turborepo

Fidati

Ripristina solo ciò che ha salvato una build affidabile

Le voci salvate con un token GitHub OIDC, come fanno le action di CacheFlow, registrano l'evento, il ref, il commit e il workflow da cui provengono. Aggiungi una policy di consumer affidabili e i tuoi job di rilascio ripristinano solo le voci salvate sul tuo branch protetto da un push, un'esecuzione pianificata o un'esecuzione manuale.

  • Solo credenziali di breve durata: GitHub OIDC per le action di CacheFlow, il token di runtime di GitHub stesso per i job con le action standard
  • Ogni branch scrive solo nel proprio scope e legge attraverso il proprio branch di base e il branch predefinito
  • Nei job OIDC, i salvataggi provenienti da eventi che utenti esterni possono attivare su un branch protetto, come pull_request_target, vengono messi in quarantena; i job con le action standard seguono i permessi di cache concessi da GitHub stesso

Guardaci dentro

Conosci il tuo hit rate

Ogni ripristino, miss e salvataggio della cache di Actions e degli artefatti viene registrato con i relativi byte, così come i download e gli upload di Turborepo, indicando anche se un ripristino ha trovato la chiave esatta o è ripiegato su un prefisso.

  • Le chiavi della cache di Actions e i nomi degli artefatti vengono registrati solo come hash con chiave, mai così come sono scritti
  • Le sessioni accumulano le scritture dei job paralleli di una matrice e le confermano in modo atomico
  • Le sessioni obsolete vengono ripulite quando le build terminano o vanno in timeout

Parti da dove sei già

Quattro modi per iniziare, da zero modifiche al pieno controllo. La maggior parte dei team parte dal primo e non tocca mai un workflow.

  1. Zero modifiche

    Tieni i workflow che hai già

    Punta i tuoi runner su CacheFlow una volta sola. Da quel momento actions/cache, setup-node, Swatinem/rust-cache e upload-artifact passano dalla sua cache così come sono, senza modifiche. Sui runner ospitati da GitHub lo stesso workflow torna automaticamente alla cache di 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. Un solo step

    Smetti di ricompilare ciò che Turborepo ha già compilato

    Aggiungi setup-cacheflow e ogni task con input invariati riproduce i propri output invece di essere rieseguito, tra job, branch e repository.

    Guarda il workflow completo ↓
  3. Pronto per il rilascio

    Rilascia solo ciò che ha prodotto una build affidabile

    Salva le cache di rilascio e di deploy tramite le action di CacheFlow. Ogni voce registra l'evento, il ref, il commit e il workflow da cui proviene. Aggiungi una policy di consumer affidabili e i tuoi job di rilascio ripristinano solo le voci salvate sul tuo branch protetto da un push, un'esecuzione pianificata o un'esecuzione manuale.

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

    Metti in cache qualsiasi cosa dalla riga di comando

    La cacheflow CLI e il Python SDK salvano e ripristinano qualsiasi artefatto da qualsiasi tool di build. Le sessioni accumulano le scritture dei job paralleli di una matrice e le confermano in modo atomico, così nessun job sovrascrive quello di un altro.

    # 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

La cache remota di Turborepo in un solo step

setup-cacheflow genera una credenziale OIDC di breve durata ed esporta TURBO_API, TURBO_TOKEN e TURBO_TEAM. Nessun segreto memorizzato:

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

Le prime domande dei team

Dobbiamo modificare i nostri workflow?
Non per la cache e gli artefatti di Actions. Punta una volta sola l'ambiente dei tuoi runner su CacheFlow, e actions/cache, setup-node, Swatinem/rust-cache e upload-artifact lo usano così come sono. Sui runner ospitati da GitHub gli stessi workflow continuano a usare la cache di GitHub. La cache remota di Turborepo richiede uno step setup-cacheflow per workflow.
Dove risiedono i nostri dati?
Nel tuo account Cloudflare: i byte in R2, la proprietà delle chiavi in D1, un percorso di lettura in KV e le sessioni in corso nei Durable Objects. La telemetria registra le chiavi della cache di Actions e i nomi degli artefatti solo come hash con chiave. Stiamo anche pianificando un piano gestito, operato da CacheFlow per te.
Quanto costa?
Le risorse Cloudflare usate da CacheFlow vengono fatturate sul tuo account Cloudflare, e R2 non applica costi di egress. Condivideremo i prezzi di CacheFlow stesso con i team in accesso anticipato.
È più veloce della cache di GitHub?
Non facciamo alcuna affermazione sulla velocità. I byte arrivano da Cloudflare R2 via internet, e non abbiamo misurato alcun vantaggio nella velocità di ripristino. Se ti serve una cache accanto al runner, la cache di un fornitore di runner potrebbe fare più al caso tuo.
Come si autenticano i job?
I job che usano le action di CacheFlow o setup-cacheflow scambiano un token GitHub OIDC di breve durata. I job che usano direttamente le action standard impiegano il token di runtime che GitHub fornisce già a ogni job. In entrambi i casi, nelle tue pipeline non viene memorizzato alcun segreto di lunga durata. Gli altri sistemi CI e i laptop degli sviluppatori usano un token emesso dal tuo operatore.
Possiamo tornare indietro?
Sì. CacheFlow parla i protocolli che i tuoi strumenti usano già: i servizi di cache e di artefatti di Actions e la cache remota di Turborepo. Rimuovi l'impostazione dei runner o lo step setup-cacheflow, e i tuoi workflow tornano alla cache che usavano prima.

Ottieni l'accesso anticipato

Unisciti alla lista d'attesa: ti contatteremo non appena il tuo team potrà iniziare.