GitHub Actionsi vahemälu · artefaktid · Turborepo

Sinu CI-vahemälu sinu enda Cloudflare’i kontol

Tavalised actions/cache ja upload-artifact kasutavad vahemälu CacheFlow kaudu ilma töövooge muutmata ning Turborepo ühe seadistussammuga. Lisa usaldusväärsete tarbijate poliitika ja sinu väljalasketööd taastavad ainult seda, mille on loonud usaldusväärne ehitus.

Vahemälu, mis on sinu oma, mida saad usaldada ja mille sisse näed

Sinu oma

Sinu konto, sinu baidid

CacheFlow töötab sinu Cloudflare’i kontol, nii et vahemälu ja artefaktide baidid ei ole kunagi kolmanda osapoole käes ning ressursid kajastuvad sinu enda Cloudflare’i arvel.

  • Artefaktide baidid R2-s, ilma väljuva liikluse tasudeta
  • Võtmete omandiõigus D1-s, kiire lugemistee KV-s, pooleliolevad seansid Durable Objectsis
  • Üks juurutus teenindab Actionsi vahemälu, Actionsi artefakte ja Turborepo kaugvahemälu

Usalda

Taasta ainult see, mille salvestas usaldusväärne ehitus

GitHubi OIDC-tõendiga salvestatud kirjed, nagu need, mille salvestavad CacheFlow actionid, talletavad nende taga oleva sündmuse, ref’i, commit’i ja töövoo. Lisa usaldusväärsete tarbijate poliitika ja sinu väljalasketööd taastavad ainult kirjeid, mille on sinu kaitstud harule salvestanud push, ajastatud käivitus või käsitsi käivitus.

  • Ainult lühiealised mandaadid: GitHubi OIDC CacheFlow actionitele, GitHubi enda käitustõend drop-in-töödele
  • Iga haru kirjutab ainult oma ulatusse ja loeb oma baasharu ning vaikeharu kaudu
  • OIDC-töödes pannakse karantiini kaitstud harule tehtud salvestused sündmustest, mida saavad käivitada kõrvalised isikud, näiteks pull_request_target; drop-in-tööd järgivad GitHubi enda vahemäluõigust

Näe

Tea oma tabamusmäära

Iga Actionsi vahemälu ja artefaktide taastamine, möödalask ja salvestus logitakse koos baitide arvuga, samuti Turborepo allalaadimised ja üleslaadimised, sealhulgas see, kas taastamine leidis täpse võtme või langes tagasi prefiksile.

  • Actionsi vahemälu võtmeid ja artefaktide nimesid talletatakse ainult võtmega räsina, mitte kunagi kirjutatud kujul
  • Seansid puhverdavad paralleelsete matrix-tööde kirjutused ja kinnitavad need atomaarselt
  • Aegunud seansid koristatakse, kui ehitused lõpevad või aeguvad

Alusta sealt, kus sa juba oled

Neli sisenemisviisi, null muudatusest täieliku kontrollini. Enamik meeskondi alustab esimesest ega muuda kunagi ühtegi töövoogu.

  1. Null muudatust

    Hoia alles oma praegused töövood

    Suuna oma runnerid korra CacheFlow’le. Tavalised actions/cache, setup-node, Swatinem/rust-cache ja upload-artifact kasutavad seejärel vahemälu selle kaudu, muutmata kujul. GitHubi hostitud runneritel langeb sama töövoog tagasi GitHubi vahemälule.

    # 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. Üks samm

    Ära ehita uuesti seda, mille Turborepo on juba ehitanud

    Lisa setup-cacheflow ja iga ülesanne, mille sisendid pole muutunud, taasesitab oma väljundid uuesti käivitamise asemel — üle tööde, harude ja hoidlate.

    Vaata kogu töövoogu ↓
  3. Väljalaskeks

    Avalda ainult usaldusväärse ehituse tulemust

    Salvesta väljalaske- ja juurutusvahemälud CacheFlow actionite kaudu. Iga kirje talletab selle taga oleva sündmuse, ref’i, commit’i ja töövoo. Lisa usaldusväärsete tarbijate poliitika ja sinu väljalasketööd taastavad ainult kirjeid, mille on sinu kaitstud harule salvestanud push, ajastatud käivitus või käsitsi käivitus.

    # 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. Iga tööriist

    Salvesta vahemällu ükskõik mida käsurealt

    cacheflow CLI ja Python SDK salvestavad ja taastavad mis tahes artefakti mis tahes ehitustööriistast. Seansid puhverdavad paralleelsete matrix-tööde kirjutused ja kinnitavad need atomaarselt, nii et ükski töö ei kirjuta teist üle.

    # 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 kaugvahemälu ühe sammuga

setup-cacheflow väljastab lühiealise OIDC-mandaadi ja ekspordib TURBO_API, TURBO_TOKEN-i ja TURBO_TEAM-i. Salvestatud saladusi pole:

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

Küsimused, mida meeskonnad kõigepealt küsivad

Kas peame oma töövooge muutma?
Actionsi vahemälu ja artefaktide puhul mitte. Suuna oma runnerite keskkond korra CacheFlow’le ning tavalised actions/cache, setup-node, Swatinem/rust-cache ja upload-artifact kasutavad seda muutmata kujul. GitHubi hostitud runneritel kasutavad samad töövood edasi GitHubi vahemälu. Turborepo kaugvahemälu vajab ühte setup-cacheflow sammu töövoo kohta.
Kus meie andmed asuvad?
Sinu Cloudflare’i kontol: baidid R2-s, võtmete omandiõigus D1-s, lugemistee KV-s ja pooleliolevad seansid Durable Objectsis. Telemeetria talletab Actionsi vahemälu võtmeid ja artefaktide nimesid ainult võtmega räsina. Kavandame ka hallatud paketti, mida CacheFlow sinu eest käitab.
Mis see maksab?
Cloudflare’i ressursid, mida CacheFlow kasutab, arveldatakse sinu enda Cloudflare’i kontol, ja R2 ei võta väljuva liikluse tasusid. CacheFlow enda hinnastust jagame varajase ligipääsuga meeskondadega.
Kas see on kiirem kui GitHubi vahemälu?
Me ei väida kiiruse kohta midagi. Baidid tulevad Cloudflare R2-st üle interneti ja me pole mõõtnud taastamiskiiruse eelist. Kui vajad vahemälu otse runneri kõrval, võib runneri pakkuja vahemälu sulle paremini sobida.
Kuidas tööd end autendivad?
CacheFlow actioneid või setup-cacheflow’d kasutavad tööd vahetavad lühiealise GitHubi OIDC-tõendi. Tavalistel actionitel põhinevad drop-in-tööd kasutavad käitustõendit, mille GitHub annab juba igale tööle. Mõlemal juhul ei hoita sinu torudes ühtegi pikaealist saladust. Teised CI-süsteemid ja arendajate sülearvutid kasutavad sinu operaatori väljastatud tõendit.
Kas saame tagasi minna?
Jah. CacheFlow kasutab samu protokolle, mida sinu tööriistad juba kasutavad: Actionsi vahemälu- ja artefaktiteenuseid ning Turborepo kaugvahemälu. Eemalda runneri seadistus või setup-cacheflow samm ja sinu töövood lähevad tagasi vahemälu juurde, mida nad varem kasutasid.

Saa varajane ligipääs

Liitu ootenimekirjaga ja võtame ühendust, kui sinu meeskond saab alustada.