Cache GitHub Actions · artefacte · Turborepo

Cache-ul tău de CI, în propriul tău cont Cloudflare

Acțiunile standard actions/cache și upload-artifact trec prin CacheFlow fără modificări ale workflow-urilor, iar Turborepo cu un singur pas de configurare. Adaugă o politică de consumatori de încredere, iar joburile tale de release restaurează doar ce a produs un build de încredere.

Un cache pe care îl deții, în care ai încredere și în care vezi ce se întâmplă

Deține-l

Contul tău, octeții tăi

CacheFlow rulează în contul tău Cloudflare, așa că octeții din cache și din artefacte nu stau niciodată la o terță parte, iar resursele apar pe propria ta factură Cloudflare.

  • Octeții artefactelor în R2, fără costuri de egress
  • Proprietatea cheilor în D1, o cale de citire rapidă în KV, sesiunile în curs în Durable Objects
  • O singură implementare servește cache-ul Actions, artefactele Actions și cache-ul remote Turborepo

Ai încredere

Restaurează doar ce a salvat un build de încredere

Intrările salvate cu un token GitHub OIDC, așa cum fac acțiunile CacheFlow, înregistrează evenimentul, ref-ul, commit-ul și workflow-ul din spatele lor. Adaugă o politică de consumatori de încredere, iar joburile de release vor restaura doar intrările salvate pe branch-ul tău protejat de un push, o rulare programată sau o rulare manuală.

  • Doar credențiale de scurtă durată: GitHub OIDC pentru acțiunile CacheFlow, tokenul de runtime al GitHub pentru joburile cu acțiuni standard
  • Fiecare branch scrie doar în propriul domeniu și citește prin branch-ul său de bază și prin branch-ul implicit
  • Pe joburile OIDC, salvările pe un branch protejat provenite din evenimente pe care le pot declanșa persoane din afară, precum pull_request_target, sunt puse în carantină; joburile cu acțiuni standard urmează permisiunea de cache acordată de GitHub

Vezi

Cunoaște-ți rata de hit

Fiecare restaurare, ratare și salvare din cache-ul și artefactele Actions este înregistrată împreună cu octeții săi, la fel ca descărcările și încărcările Turborepo, inclusiv dacă o restaurare s-a potrivit cu cheia exactă sau a recurs la un prefix.

  • Cheile cache-ului Actions și numele artefactelor sunt înregistrate doar ca hash cu cheie, niciodată în forma în care au fost scrise
  • Sesiunile adună scrierile din joburile matrix paralele și le confirmă atomic
  • Sesiunile rămase în urmă sunt curățate când build-urile se termină sau expiră

Pornește de unde ești deja

Patru moduri de a începe, de la zero modificări la control complet. Majoritatea echipelor încep cu primul și nu mai editează niciodată un workflow.

  1. Zero modificări

    Păstrează workflow-urile pe care le ai

    Îndreaptă-ți runnerele către CacheFlow o singură dată. Acțiunile standard actions/cache, setup-node, Swatinem/rust-cache și upload-artifact își folosesc apoi cache-ul prin el, neatinse. Pe runnerele găzduite de GitHub, același workflow revine la cache-ul 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 singur pas

    Nu mai reconstrui ce a construit deja Turborepo

    Adaugă setup-cacheflow și fiecare task ale cărui intrări nu s-au schimbat își redă rezultatele în loc să ruleze din nou, între joburi, branch-uri și repository-uri.

    Vezi workflow-ul complet ↓
  3. Pentru release

    Livrează doar ce a produs un build de încredere

    Salvează cache-urile de release și deploy prin acțiunile CacheFlow. Fiecare intrare înregistrează evenimentul, ref-ul, commit-ul și workflow-ul din spatele ei. Adaugă o politică de consumatori de încredere, iar joburile de release vor restaura doar intrările salvate pe branch-ul tău protejat de un push, o rulare programată sau o rulare manuală.

    # 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. Orice unealtă

    Pune orice în cache din linia de comandă

    cacheflow CLI și Python SDK stochează și restaurează orice artefact din orice unealtă de build. Sesiunile adună scrierile din joburile matrix paralele și le confirmă atomic, astfel încât niciun job nu îl suprascrie pe altul.

    # 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

Cache remote pentru Turborepo într-un singur pas

setup-cacheflow emite o credențială OIDC de scurtă durată și exportă TURBO_API, TURBO_TOKEN și TURBO_TEAM. Fără secrete stocate:

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

Întrebările pe care echipele le pun mai întâi

Trebuie să ne modificăm workflow-urile?
Nu pentru cache-ul și artefactele Actions. Îndreaptă o singură dată mediul runnerelor tale către CacheFlow, iar acțiunile standard actions/cache, setup-node, Swatinem/rust-cache și upload-artifact îl folosesc neschimbate. Pe runnerele găzduite de GitHub, aceleași workflow-uri continuă să folosească cache-ul GitHub. Cache-ul remote Turborepo necesită un pas setup-cacheflow în fiecare workflow.
Unde se află datele noastre?
În contul tău Cloudflare: octeții în R2, proprietatea cheilor în D1, o cale de citire în KV și sesiunile în curs în Durable Objects. Telemetria înregistrează cheile cache-ului Actions și numele artefactelor doar ca hash cu cheie. Pregătim și un plan gestionat, pe care CacheFlow îl operează pentru tine.
Cât costă?
Resursele Cloudflare folosite de CacheFlow sunt facturate în propriul tău cont Cloudflare, iar R2 nu percepe costuri de egress. Vom comunica prețurile pentru CacheFlow în sine echipelor cu acces timpuriu.
Este mai rapid decât cache-ul GitHub?
Nu facem nicio afirmație despre viteză. Octeții vin din Cloudflare R2 prin internet și nu am măsurat vreun avantaj de viteză la restaurare. Dacă ai nevoie de un cache chiar lângă runner, cache-ul unui furnizor de runnere ți s-ar putea potrivi mai bine.
Cum se autentifică joburile?
Joburile care folosesc acțiunile CacheFlow sau setup-cacheflow obțin acces în schimbul unui token GitHub OIDC de scurtă durată. Joburile cu acțiuni standard folosesc tokenul de runtime pe care GitHub îl oferă deja fiecărui job. În ambele cazuri, niciun secret de lungă durată nu este stocat în pipeline-urile tale. Alte sisteme CI și laptopurile dezvoltatorilor folosesc un token emis de operatorul tău.
Putem reveni la ce aveam?
Da. CacheFlow vorbește protocoalele pe care uneltele tale le folosesc deja: serviciile de cache și de artefacte Actions și cache-ul remote Turborepo. Elimină setarea runnerului sau pasul setup-cacheflow, iar workflow-urile tale revin la cache-ul pe care îl foloseau înainte.

Obține acces timpuriu

Înscrie-te pe lista de așteptare și te contactăm de îndată ce echipa ta poate începe.