GitHub Actions gyorsítótár · artefaktok · Turborepo

Az Ön CI-gyorsítótára, a saját Cloudflare-fiókjában

A gyári actions/cache és upload-artifact a munkafolyamatok módosítása nélkül, a Turborepo pedig egyetlen beállítási lépéssel gyorsítótáraz a CacheFlow-n keresztül. Adjon hozzá egy megbízható fogyasztói szabályzatot, és a kiadási jobjai csak azt állítják vissza, amit megbízható build állított elő.

Gyorsítótár, amely az Öné, amelyben megbízhat, és amelybe belelát

Birtokolja

Az Ön fiókja, az Ön bájtjai

A CacheFlow az Ön Cloudflare-fiókjában fut, így a gyorsítótár- és artefaktbájtok soha nem kerülnek harmadik félhez, az erőforrások pedig az Ön saját Cloudflare-számláján jelennek meg.

  • Artefaktbájtok az R2-ben, kimenőforgalmi díj nélkül
  • Kulcstulajdonlás a D1-ben, gyors olvasási útvonal a KV-ban, folyamatban lévő munkamenetek a Durable Objectsben
  • Egyetlen telepítés szolgálja ki az Actions gyorsítótárat, az Actions artefaktokat és a Turborepo távoli gyorsítótárat

Bízzon benne

Csak azt állítsa vissza, amit megbízható build mentett

A GitHub OIDC-tokennel mentett bejegyzések, ahogyan a CacheFlow actionök is mentenek, rögzítik a mögöttük álló eseményt, refet, commitot és munkafolyamatot. Adjon hozzá egy megbízható fogyasztói szabályzatot, és a kiadási jobok csak olyan bejegyzéseket állítanak vissza, amelyeket push, ütemezett vagy kézi futtatás mentett a védett ágára.

  • Csak rövid élettartamú hitelesítőadatok: GitHub OIDC a CacheFlow actionökhöz, a GitHub saját runtime tokenje a drop-in jobokhoz
  • Minden ág csak a saját hatókörébe ír, és az alapágán, valamint az alapértelmezett ágon keresztül olvas
  • OIDC-s jobokon a védett ágra olyan eseményekből érkező mentések, amelyeket külsősök is kiválthatnak, például a pull_request_target, karanténba kerülnek; a drop-in jobok a GitHub saját gyorsítótár-jogosultságát követik

Lássa át

Ismerje a találati arányát

Az Actions gyorsítótár és az artefaktok minden visszaállítását, nem-találatát és mentését rögzítjük a bájtokkal együtt, ahogy a Turborepo letöltéseit és feltöltéseit is, beleértve azt, hogy a visszaállítás a pontos kulcsra illeszkedett-e, vagy egy előtagra esett vissza.

  • Az Actions gyorsítótárkulcsokat és artefaktneveket csak kulcsolt hashként rögzítjük, soha nem eredeti formájukban
  • A munkamenetek pufferelik a párhuzamos mátrixjobok írásait, és atomikusan véglegesítik őket
  • Az elavult munkameneteket eltakarítjuk, amikor a buildek befejeződnek vagy túllépik az időkorlátot

Kezdje ott, ahol most tart

Négy belépési pont, a nulla módosítástól a teljes kontrollig. A legtöbb csapat az elsővel kezd, és soha nem nyúl egyetlen munkafolyamathoz sem.

  1. Nulla módosítás

    Maradhatnak a mostani munkafolyamatai

    Egyszer irányítsa runnereit a CacheFlow-ra. Ettől kezdve a gyári actions/cache, setup-node, Swatinem/rust-cache és upload-artifact változtatás nélkül rajta keresztül gyorsítótáraz. A GitHub által hosztolt runnereken ugyanaz a munkafolyamat a GitHub saját gyorsítótárára vált vissza.

    # 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. Egy lépés

    Ne buildelje újra, amit a Turborepo már lebuildelt

    Adja hozzá a setup-cacheflow lépést, és minden olyan feladat, amelynek bemenetei nem változtak, újrafuttatás helyett visszajátssza a kimeneteit — jobokon, ágakon és repókon át.

    A teljes munkafolyamat megtekintése ↓
  3. Kiadási szint

    Csak azt szállítsa, amit megbízható build állított elő

    Mentse a kiadási és telepítési gyorsítótárakat a CacheFlow actionökön keresztül. Minden bejegyzés rögzíti a mögötte álló eseményt, refet, commitot és munkafolyamatot. Adjon hozzá egy megbízható fogyasztói szabályzatot, és a kiadási jobok csak olyan bejegyzéseket állítanak vissza, amelyeket push, ütemezett vagy kézi futtatás mentett a védett ágára.

    # 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. Bármilyen eszköz

    Gyorsítótárazzon bármit a parancssorból

    A cacheflow CLI és a Python SDK bármely build eszköz bármely artefaktját elmenti és visszaállítja. A munkamenetek pufferelik a párhuzamos mátrixjobok írásait, és atomikusan véglegesítik őket, így egyik job sem írja felül a másikat.

    # 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 távoli gyorsítótár egyetlen lépésben

A setup-cacheflow rövid élettartamú OIDC-hitelesítőadatot állít ki, és exportálja a TURBO_API, TURBO_TOKEN és TURBO_TEAM változókat. Nincsenek tárolt titkok:

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

Amit a csapatok először kérdeznek

Módosítanunk kell a munkafolyamatainkat?
Az Actions gyorsítótárhoz és az artefaktokhoz nem. Egyszer irányítsa runnerei környezetét a CacheFlow-ra, és a gyári actions/cache, setup-node, Swatinem/rust-cache és upload-artifact változtatás nélkül azt használja. A GitHub által hosztolt runnereken ugyanazok a munkafolyamatok továbbra is a GitHub gyorsítótárát használják. A Turborepo távoli gyorsítótárhoz munkafolyamatonként egy setup-cacheflow lépés szükséges.
Hol vannak az adataink?
Az Ön Cloudflare-fiókjában: a bájtok az R2-ben, a kulcstulajdonlás a D1-ben, az olvasási útvonal a KV-ban, a folyamatban lévő munkamenetek pedig a Durable Objectsben. A telemetria az Actions gyorsítótárkulcsokat és artefaktneveket csak kulcsolt hashként rögzíti. Tervezünk egy menedzselt csomagot is, amelyet a CacheFlow üzemeltet Ön helyett.
Mennyibe kerül?
A CacheFlow által használt Cloudflare-erőforrásokat az Ön saját Cloudflare-fiókjára számlázzák, és az R2 nem számít fel kimenőforgalmi díjat. Magának a CacheFlow-nak az árazását a korai hozzáféréssel rendelkező csapatokkal osztjuk meg.
Gyorsabb, mint a GitHub gyorsítótára?
A sebességről nem állítunk semmit. A bájtok a Cloudflare R2-ből érkeznek az interneten keresztül, és a visszaállítás esetleges sebességelőnyét nem mértük. Ha a runner közvetlen közelében lévő gyorsítótárra van szüksége, egy runner-szolgáltató gyorsítótára jobban megfelelhet Önnek.
Hogyan hitelesítenek a jobok?
A CacheFlow actionöket vagy a setup-cacheflow-t használó jobok rövid élettartamú GitHub OIDC-tokent váltanak be. A gyári actionöket használó drop-in jobok azt a runtime tokent használják, amelyet a GitHub eleve megad minden jobnak. Így a folyamataiban egyik esetben sincs tárolva hosszú élettartamú titok. Más CI-rendszerek és a fejlesztői laptopok az üzemeltető által kiállított tokent használják.
Visszaválthatunk?
Igen. A CacheFlow azokat a protokollokat támogatja, amelyeket eszközei már használnak: az Actions gyorsítótár- és artefaktszolgáltatásokat, valamint a Turborepo távoli gyorsítótárat. Távolítsa el a runnerbeállítást vagy a setup-cacheflow lépést, és munkafolyamatai visszatérnek a korábban használt gyorsítótárhoz.

Szerezzen korai hozzáférést

Iratkozzon fel a várólistára, és jelentkezünk, amint csapata elkezdheti.