GitHub Actions -välimuisti · artefaktit · Turborepo

CI-välimuistisi omalla Cloudflare-tililläsi

Vakiomuotoiset actions/cache ja upload-artifact käyttävät välimuistia CacheFlow’n kautta ilman työnkulkumuutoksia, ja Turborepo yhdellä käyttöönottovaiheella. Lisää luotettujen kuluttajien käytäntö, niin julkaisutyösi palauttavat vain sen, minkä luotettu käännös on tuottanut.

Välimuisti, jonka omistat, johon luotat ja jonka sisälle näet

Omista se

Sinun tilisi, sinun tavusi

CacheFlow toimii Cloudflare-tililläsi, joten välimuistin ja artefaktien tavut eivät koskaan ole kolmannen osapuolen hallussa, ja resurssit näkyvät omassa Cloudflare-laskussasi.

  • Artefaktien tavut R2:ssa ilman lähtevän liikenteen maksuja
  • Avainten omistajuus D1:ssä, nopea lukupolku KV:ssä, käynnissä olevat istunnot Durable Objectsissa
  • Yksi käyttöönotto palvelee Actionsin välimuistia, Actions-artefakteja ja Turborepon etävälimuistia

Luota siihen

Palauta vain se, minkä luotettu käännös tallensi

GitHub OIDC -tunnisteella tallennetut merkinnät, kuten CacheFlow-actionien tallentamat, kirjaavat taustalla olevan tapahtuman, refin, commitin ja työnkulun. Lisää luotettujen kuluttajien käytäntö, niin julkaisutyösi palauttavat vain merkinnät, jotka push, ajastettu ajo tai manuaalinen ajo on tallentanut suojatulle haarallesi.

  • Vain lyhytikäisiä tunnistetietoja: GitHub OIDC CacheFlow-actioneille, GitHubin oma ajonaikainen tunniste drop-in-töille
  • Jokainen haara kirjoittaa vain omaan alueeseensa ja lukee kantahaaransa ja oletushaaran kautta
  • OIDC-töissä suojatulle haaralle tehdyt tallennukset tapahtumista, jotka ulkopuoliset voivat käynnistää, kuten pull_request_target, asetetaan karanteeniin; drop-in-työt noudattavat GitHubin omaa välimuistioikeutta

Näe se

Tunne osumaprosenttisi

Jokainen Actionsin välimuistin ja artefaktien palautus, huti ja tallennus kirjataan tavumäärineen, samoin Turborepon lataukset ja lähetykset, mukaan lukien se, osuiko palautus tarkkaan avaimeensa vai turvautuiko se etuliitteeseen.

  • Actionsin välimuistin avaimet ja artefaktien nimet kirjataan vain avainnettuna tiivisteenä, ei koskaan sellaisinaan
  • Istunnot puskuroivat rinnakkaisten matriisitöiden kirjoitukset ja vahvistavat ne atomisesti
  • Vanhentuneet istunnot siivotaan, kun käännökset päättyvät tai aikakatkaistaan

Aloita siitä, missä jo olet

Neljä tapaa päästä alkuun, nollamuutoksista täyteen hallintaan. Useimmat tiimit aloittavat ensimmäisestä eivätkä koskaan muokkaa yhtäkään työnkulkua.

  1. Ei muutoksia

    Pidä nykyiset työnkulkusi

    Osoita runnerisi CacheFlow’hun kerran. Sen jälkeen vakiomuotoiset actions/cache, setup-node, Swatinem/rust-cache ja upload-artifact käyttävät välimuistia sen kautta sellaisenaan. GitHubin isännöimillä runnereilla sama työnkulku käyttää GitHubin omaa välimuistia.

    # 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. Yksi vaihe

    Lopeta sen kääntäminen, minkä Turborepo jo käänsi

    Lisää setup-cacheflow, niin jokainen tehtävä, jonka syötteet eivät ole muuttuneet, toistaa aiemmat tulosteensa uudelleenajon sijaan — yli töiden, haarojen ja repositorioiden.

    Katso koko työnkulku ↓
  3. Julkaisutaso

    Toimita vain luotetun käännöksen tuotokset

    Tallenna julkaisu- ja käyttöönottovälimuistit CacheFlow-actionien kautta. Jokainen merkintä kirjaa taustalla olevan tapahtuman, refin, commitin ja työnkulun. Lisää luotettujen kuluttajien käytäntö, niin julkaisutyösi palauttavat vain merkinnät, jotka push, ajastettu ajo tai manuaalinen ajo on tallentanut suojatulle haarallesi.

    # 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. Mikä tahansa työkalu

    Tallenna mitä tahansa välimuistiin komentoriviltä

    cacheflow CLI ja Python SDK tallentavat ja palauttavat minkä tahansa artefaktin mistä tahansa käännöstyökalusta. Istunnot puskuroivat rinnakkaisten matriisitöiden kirjoitukset ja vahvistavat ne atomisesti, joten mikään työ ei ylikirjoita toista.

    # 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 Remote Cache yhdellä vaiheella

setup-cacheflow luo lyhytikäisen OIDC-tunnistetiedon ja vie TURBO_API-, TURBO_TOKEN- ja TURBO_TEAM-muuttujat. Ei tallennettuja salaisuuksia:

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

Kysymyksiä, joita tiimit kysyvät ensimmäisenä

Pitääkö työnkulkujamme muuttaa?
Ei Actionsin välimuistin ja artefaktien osalta. Osoita runneriesi ympäristö CacheFlow’hun kerran, niin vakiomuotoiset actions/cache, setup-node, Swatinem/rust-cache ja upload-artifact käyttävät sitä sellaisenaan. GitHubin isännöimillä runnereilla samat työnkulut käyttävät edelleen GitHubin välimuistia. Turborepon etävälimuisti vaatii yhden setup-cacheflow-vaiheen työnkulkua kohden.
Missä tietomme sijaitsevat?
Cloudflare-tililläsi: tavut R2:ssa, avainten omistajuus D1:ssä, lukupolku KV:ssä ja käynnissä olevat istunnot Durable Objectsissa. Telemetria kirjaa Actionsin välimuistin avaimet ja artefaktien nimet vain avainnettuna tiivisteenä. Suunnittelemme myös hallinnoitua palvelua, jota CacheFlow ylläpitää puolestasi.
Mitä se maksaa?
CacheFlow’n käyttämät Cloudflare-resurssit laskutetaan omalta Cloudflare-tililtäsi, eikä R2 veloita lähtevästä liikenteestä. Kerromme itse CacheFlow’n hinnoittelun varhaisen pääsyn tiimeille.
Onko se nopeampi kuin GitHubin välimuisti?
Emme väitä mitään nopeudesta. Tavut tulevat Cloudflare R2:sta internetin yli, emmekä ole mitanneet etua palautusnopeudessa. Jos tarvitset välimuistin aivan runnerin vieressä, runner-toimittajan välimuisti voi sopia sinulle paremmin.
Miten työt todentautuvat?
CacheFlow-actioneita tai setup-cacheflow’ta hyödyntävät työt käyttävät tunnistevaihdossa lyhytikäistä GitHub OIDC -tunnistetta. Vakio-actioneilla toimivat drop-in-työt käyttävät ajonaikaista tunnistetta, jonka GitHub antaa jo jokaiselle työlle. Kummassakin tapauksessa putkiisi ei tallenneta pitkäikäistä salaisuutta. Muut CI-järjestelmät ja kehittäjien kannettavat käyttävät operaattorisi myöntämää tunnistetta.
Voimmeko palata takaisin?
Kyllä. CacheFlow puhuu protokollia, joita työkalusi jo käyttävät: Actionsin välimuisti- ja artefaktipalveluita sekä Turborepon etävälimuistia. Poista runner-asetus tai setup-cacheflow-vaihe, niin työnkulkusi palaavat käyttämään välimuistia, jota ne käyttivät aiemmin.

Hanki varhainen pääsy

Liity jonotuslistalle, niin otamme yhteyttä, kun tiimisi pääsee alkuun.