Predpomnilnik GitHub Actions · artefakti · Turborepo

Vaš predpomnilnik CI v vašem lastnem računu Cloudflare

Standardna actions/cache in upload-artifact predpomnita prek CacheFlow brez sprememb potekov dela, Turborepo pa z enim korakom nastavitve. Dodajte pravilnik zaupanja vrednih porabnikov in vaša opravila za izdajo bodo obnovila le tisto, kar je ustvaril zaupanja vreden build.

Predpomnilnik, ki je vaš, ki mu zaupate in v katerega vidite

Lastništvo

Vaš račun, vaši bajti

CacheFlow teče v vašem računu Cloudflare, zato bajti predpomnilnika in artefaktov nikoli niso pri tretji osebi, viri pa se prikažejo na vašem lastnem obračunu Cloudflare.

  • Bajti artefaktov v R2, brez stroškov izhodnega prometa
  • Lastništvo ključev v D1, hitra pot za branje v KV, seje v teku v Durable Objects
  • Ena namestitev streže predpomnilnik Actions, artefakte Actions in oddaljeni predpomnilnik Turborepo

Zaupanje

Obnovite le tisto, kar je shranil zaupanja vreden build

Vnosi, shranjeni z žetonom GitHub OIDC, kot to počnejo akcije CacheFlow, zabeležijo dogodek, ref, commit in potek dela, iz katerih izvirajo. Dodajte pravilnik zaupanja vrednih porabnikov in vaša opravila za izdajo bodo obnovila le vnose, ki jih je na vaši zaščiteni veji shranil push, načrtovan zagon ali ročni zagon.

  • Samo kratkožive poverilnice: GitHub OIDC za akcije CacheFlow, GitHubov lastni izvajalni žeton za opravila drop-in
  • Vsaka veja piše le v svoj obseg, bere pa prek svoje osnovne in privzete veje
  • Pri opravilih z OIDC gredo shranjevanja na zaščiteno vejo iz dogodkov, ki jih lahko sprožijo zunanji uporabniki, kot je pull_request_target, v karanteno; opravila drop-in sledijo GitHubovemu lastnemu dovoljenju za predpomnilnik

Preglednost

Poznajte svojo stopnjo zadetkov

Vsaka obnova, zgrešitev in shranitev v predpomnilniku Actions in pri artefaktih se zabeleži skupaj z bajti, prav tako prenosi in nalaganja Turborepo, vključno s tem, ali se je obnova ujemala s točnim ključem ali se je vrnila na predpono.

  • Ključi predpomnilnika Actions in imena artefaktov se beležijo le kot zgoščena vrednost s ključem, nikoli v izvirni obliki
  • Seje zbirajo zapise iz vzporednih matričnih opravil in jih atomarno potrdijo
  • Zastarele seje se počistijo, ko se buildi končajo ali jim poteče čas

Začnite tam, kjer že ste

Štiri poti, od nič sprememb do popolnega nadzora. Večina ekip začne s prvo in poteka dela nikoli ne ureja.

  1. Nič sprememb

    Obdržite poteke dela, ki jih že imate

    Svoje runnerje enkrat usmerite na CacheFlow. Standardni actions/cache, setup-node, Swatinem/rust-cache in upload-artifact nato predpomnijo prek njega, brez sprememb. Na runnerjih, ki jih gosti GitHub, isti potek dela preklopi na predpomnilnik GitHuba.

    # 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. En korak

    Nehajte znova graditi, kar je Turborepo že zgradil

    Dodajte setup-cacheflow in vsaka naloga, katere vhodi se niso spremenili, predvaja svoje izhode, namesto da bi se znova zagnala — med opravili, vejami in repozitoriji.

    Oglejte si celoten potek dela ↓
  3. Za izdaje

    Izdajte le tisto, kar je ustvaril zaupanja vreden build

    Predpomnilnike za izdaje in uvajanje shranjujte prek akcij CacheFlow. Vsak vnos zabeleži dogodek, ref, commit in potek dela, iz katerih izvira. Dodajte pravilnik zaupanja vrednih porabnikov in vaša opravila za izdajo bodo obnovila le vnose, ki jih je na vaši zaščiteni veji shranil push, načrtovan zagon ali ročni zagon.

    # 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. Vsako orodje

    Predpomnite karkoli iz ukazne vrstice

    cacheflow CLI in Python SDK shranita in obnovita kateri koli artefakt iz katerega koli orodja za build. Seje zbirajo zapise iz vzporednih matričnih opravil in jih atomarno potrdijo, zato nobeno opravilo ne prepiše drugega.

    # 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

Oddaljeni predpomnilnik za Turborepo v enem koraku

setup-cacheflow izda kratkoživo poverilnico OIDC in izvozi TURBO_API, TURBO_TOKEN in TURBO_TEAM. Brez shranjenih skrivnosti:

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

Vprašanja, ki jih ekipe zastavijo najprej

Ali moramo spremeniti poteke dela?
Za predpomnilnik Actions in artefakte ne. Okolje svojih runnerjev enkrat usmerite na CacheFlow in standardni actions/cache, setup-node, Swatinem/rust-cache in upload-artifact ga bodo uporabljali brez sprememb. Na runnerjih, ki jih gosti GitHub, isti poteki dela še naprej uporabljajo predpomnilnik GitHuba. Oddaljeni predpomnilnik Turborepo zahteva en korak setup-cacheflow na potek dela.
Kje so shranjeni naši podatki?
V vašem računu Cloudflare: bajti v R2, lastništvo ključev v D1, pot za branje v KV in seje v teku v Durable Objects. Telemetrija beleži ključe predpomnilnika Actions in imena artefaktov le kot zgoščeno vrednost s ključem. Načrtujemo tudi upravljani paket, ki ga bo za vas upravljal CacheFlow.
Koliko stane?
Viri Cloudflare, ki jih uporablja CacheFlow, se zaračunajo vašemu lastnemu računu Cloudflare, R2 pa ne zaračunava stroškov izhodnega prometa. Cene samega CacheFlow bomo sporočili ekipam z zgodnjim dostopom.
Ali je hitrejši od predpomnilnika GitHuba?
O hitrosti ne trdimo ničesar. Bajti prihajajo iz Cloudflare R2 prek interneta in morebitne prednosti pri hitrosti obnove nismo merili. Če potrebujete predpomnilnik tik ob runnerju, vam bo morda bolj ustrezal predpomnilnik ponudnika runnerjev.
Kako se opravila overijo?
Opravila, ki uporabljajo akcije CacheFlow ali setup-cacheflow, izmenjajo kratkoživi žeton GitHub OIDC. Opravila drop-in na standardnih akcijah uporabljajo izvajalni žeton, ki ga GitHub že dodeli vsakemu opravilu. V obeh primerih v vaših cevovodih ni shranjena nobena dolgoživa skrivnost. Drugi sistemi CI in prenosniki razvijalcev uporabljajo žeton, ki ga izda vaš operater.
Ali se lahko vrnemo nazaj?
Da. CacheFlow podpira protokole, ki jih vaša orodja že uporabljajo: storitvi predpomnilnika in artefaktov Actions ter oddaljeni predpomnilnik Turborepo. Odstranite nastavitev runnerja ali korak setup-cacheflow in vaši poteki dela se vrnejo na predpomnilnik, ki so ga uporabljali prej.

Pridobite zgodnji dostop

Pridružite se čakalnemu seznamu in oglasili se vam bomo, ko bo vaša ekipa lahko začela.