GitHub Actions predmemorija · artefakti · Turborepo

Vaša CI predmemorija na vašem vlastitom Cloudflare računu

Standardni actions/cache i upload-artifact spremaju u predmemoriju kroz CacheFlow bez promjena tijekova rada, a Turborepo uz jedan korak postavljanja. Dodajte pravilo pouzdanih potrošača i vaši jobovi za izdanja vraćat će samo ono što je proizveo pouzdan build.

Predmemorija koju posjedujete, kojoj vjerujete i u koju imate uvid

Vlasništvo

Vaš račun, vaši bajtovi

CacheFlow radi na vašem Cloudflare računu, pa bajtovi predmemorije i artefakata nikad ne stoje kod treće strane, a resursi se pojavljuju na vašem vlastitom Cloudflare obračunu.

  • Bajtovi artefakata u R2, bez naknada za izlazni promet
  • Vlasništvo ključeva u D1, brzi put čitanja u KV, sesije u tijeku u Durable Objects
  • Jedna implementacija poslužuje Actions predmemoriju, Actions artefakte i udaljenu predmemoriju Turborepo

Povjerenje

Vraćajte samo ono što je spremio pouzdan build

Unosi spremljeni s GitHub OIDC tokenom, kao što to čine CacheFlow akcije, bilježe događaj, ref, commit i tijek rada iz kojeg potječu. Dodajte pravilo pouzdanih potrošača i vaši jobovi za izdanja vraćat će samo unose koje je na vašoj zaštićenoj grani spremio push, zakazano ili ručno pokretanje.

  • Samo kratkotrajne vjerodajnice: GitHub OIDC za CacheFlow akcije, GitHubov vlastiti runtime token za drop-in jobove
  • Svaka grana piše samo u vlastiti opseg, a čita preko svoje osnovne i zadane grane
  • Na jobovima s OIDC-om spremanja na zaštićenu granu iz događaja koje mogu pokrenuti vanjske osobe, poput pull_request_target, stavljaju se u karantenu; drop-in jobovi slijede GitHubovo vlastito odobrenje za predmemoriju

Pregled

Znajte svoju stopu pogodaka

Svako vraćanje, promašaj i spremanje u Actions predmemoriji i artefaktima bilježi se zajedno s bajtovima, kao i Turborepo preuzimanja i učitavanja, uključujući je li se vraćanje podudaralo s točnim ključem ili se vratilo na prefiks.

  • Ključevi Actions predmemorije i nazivi artefakata bilježe se samo kao hash s ključem, nikad u izvornom obliku
  • Sesije međuspremaju zapise paralelnih matričnih jobova i atomski ih potvrđuju
  • Zastarjele sesije čiste se kad buildovi završe ili im istekne vrijeme

Krenite od onoga što već imate

Četiri načina za početak, od nula promjena do potpune kontrole. Većina timova krene s prvim i nikad ne mijenja nijedan tijek rada.

  1. Bez promjena

    Zadržite postojeće tijekove rada

    Jednom usmjerite svoje runnere na CacheFlow. Standardni actions/cache, setup-node, Swatinem/rust-cache i upload-artifact tada spremaju u predmemoriju preko njega, bez ikakvih izmjena. Na runnerima koje hostira GitHub isti se tijek rada vraća na predmemoriju koju pruža 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. Jedan korak

    Prestanite ponovno graditi ono što je Turborepo već izgradio

    Dodajte setup-cacheflow i svaki zadatak čiji se ulazi nisu promijenili reproducira svoje izlaze umjesto da se ponovno pokreće — kroz jobove, grane i repozitorije.

    Pogledajte cijeli tijek rada ↓
  3. Za izdanja

    Isporučite samo ono što je proizveo pouzdan build

    Spremajte predmemorije za izdanja i implementaciju putem CacheFlow akcija. Svaki unos bilježi događaj, ref, commit i tijek rada iz kojeg potječe. Dodajte pravilo pouzdanih potrošača i vaši jobovi za izdanja vraćat će samo unose koje je na vašoj zaštićenoj grani spremio push, zakazano ili ručno pokretanje.

    # 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. Bilo koji alat

    Spremite bilo što u predmemoriju iz naredbenog retka

    cacheflow CLI i Python SDK spremaju i vraćaju bilo koji artefakt iz bilo kojeg alata za build. Sesije međuspremaju zapise paralelnih matričnih jobova i atomski ih potvrđuju, tako da nijedan job ne prepisuje drugi.

    # 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

Udaljena predmemorija Turborepo u jednom koraku

setup-cacheflow izdaje kratkotrajnu OIDC vjerodajnicu i izvozi TURBO_API, TURBO_TOKEN i TURBO_TEAM. Bez pohranjenih tajni:

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

Pitanja koja timovi prvo postavljaju

Moramo li mijenjati svoje tijekove rada?
Ne za Actions predmemoriju i artefakte. Jednom usmjerite okruženje svojih runnera na CacheFlow i standardni actions/cache, setup-node, Swatinem/rust-cache i upload-artifact koristit će ga bez izmjena. Na runnerima koje hostira GitHub isti tijekovi rada i dalje koriste predmemoriju koju pruža GitHub. Udaljena predmemorija Turborepo zahtijeva jedan korak setup-cacheflow po tijeku rada.
Gdje se nalaze naši podaci?
Na vašem Cloudflare računu: bajtovi u R2, vlasništvo ključeva u D1, put čitanja u KV i sesije u tijeku u Durable Objects. Telemetrija bilježi ključeve Actions predmemorije i nazive artefakata samo kao hash s ključem. Planiramo i upravljani paket koji CacheFlow vodi umjesto vas.
Koliko košta?
Cloudflare resursi koje CacheFlow koristi naplaćuju se na vaš vlastiti Cloudflare račun, a R2 ne naplaćuje izlazni promet. Cijene samog CacheFlow podijelit ćemo s timovima s ranim pristupom.
Je li brži od predmemorije koju pruža GitHub?
Ne tvrdimo ništa o brzini. Bajtovi dolaze iz Cloudflare R2 preko interneta, a moguću prednost u brzini vraćanja nismo mjerili. Ako vam treba predmemorija odmah uz runner, predmemorija dobavljača runnera mogla bi vam bolje odgovarati.
Kako se jobovi autentificiraju?
Jobovi koji koriste CacheFlow akcije ili setup-cacheflow razmjenjuju kratkotrajni GitHub OIDC token. Drop-in jobovi na standardnim akcijama koriste runtime token koji GitHub već daje svakom jobu. U oba slučaja u vašim se cjevovodima ne pohranjuje nikakva dugotrajna tajna. Drugi CI sustavi i prijenosna računala developera koriste token koji izdaje vaš operater.
Možemo li se vratiti?
Da. CacheFlow podržava protokole koje vaši alati već koriste: servise Actions predmemorije i artefakata te udaljenu predmemoriju Turborepo. Uklonite postavku runnera ili korak setup-cacheflow i vaši će se tijekovi rada vratiti na predmemoriju koju su prije koristili.

Ostvarite rani pristup

Pridružite se listi čekanja i javit ćemo se čim vaš tim bude mogao krenuti.