GitHub Actions podėlis · artefaktai · Turborepo

Jūsų CI podėlis jūsų pačių Cloudflare paskyroje

Standartiniai actions/cache ir upload-artifact naudoja podėlį per CacheFlow be jokių darbo eigų pakeitimų, o Turborepo — atlikus vieną sąrankos žingsnį. Pridėkite patikimų vartotojų politiką, ir jūsų leidimų job’ai atkurs tik tai, ką sukūrė patikimas build’as.

Podėlis, kuris priklauso jums, kuriuo galite pasitikėti ir į kurį galite pažvelgti

Valdykite

Jūsų paskyra, jūsų baitai

CacheFlow veikia jūsų Cloudflare paskyroje, todėl podėlio ir artefaktų baitai niekada nebūna pas trečiąją šalį, o ištekliai matomi jūsų pačių Cloudflare sąskaitoje.

  • Artefaktų baitai R2, be mokesčio už išeinantį srautą
  • Raktų nuosavybė D1, greitas skaitymo kelias KV, vykdomos sesijos Durable Objects
  • Vienas diegimas aptarnauja Actions podėlį, Actions artefaktus ir Turborepo nuotolinį podėlį

Pasitikėkite

Atkurkite tik tai, ką išsaugojo patikimas build’as

Įrašai, išsaugoti su GitHub OIDC žetonu, kaip tai daro CacheFlow veiksmai, fiksuoja juos sukūrusį įvykį, ref, commit’ą ir darbo eigą. Pridėkite patikimų vartotojų politiką, ir jūsų leidimų job’ai atkurs tik tuos įrašus, kuriuos jūsų apsaugotoje šakoje išsaugojo push’as, suplanuotas ar rankinis paleidimas.

  • Tik trumpalaikiai prisijungimo duomenys: GitHub OIDC CacheFlow veiksmams, paties GitHub vykdymo žetonas drop-in job’ams
  • Kiekviena šaka rašo tik į savo sritį, o skaito per savo bazinę šaką ir numatytąją šaką
  • OIDC job’uose išsaugojimai apsaugotoje šakoje iš įvykių, kuriuos gali sukelti pašaliniai asmenys, pavyzdžiui, pull_request_target, patenka į karantiną; drop-in job’ai laikosi paties GitHub podėlio prieigos teisių

Matykite

Žinokite savo pataikymų dažnį

Kiekvienas Actions podėlio ir artefaktų atkūrimas, nepataikymas ir išsaugojimas registruojamas kartu su baitų kiekiu, kaip ir Turborepo atsisiuntimai bei įkėlimai, įskaitant tai, ar atkūrimas atitiko tikslų raktą, ar grįžo prie prefikso.

  • Actions podėlio raktai ir artefaktų pavadinimai registruojami tik kaip raktuota maiša, niekada ne tokie, kokie buvo parašyti
  • Sesijos buferizuoja lygiagrečių matricos job’ų įrašus ir patvirtina juos atomiškai
  • Pasenusios sesijos išvalomos, kai build’ai baigiasi arba jiems baigiasi laikas

Pradėkite nuo to, ką jau turite

Keturi keliai — nuo jokių pakeitimų iki visiškos kontrolės. Dauguma komandų pradeda nuo pirmojo ir niekada neredaguoja nė vienos darbo eigos.

  1. Be pakeitimų

    Palikite esamas darbo eigas

    Vieną kartą nukreipkite savo runner’ius į CacheFlow. Tada standartiniai actions/cache, setup-node, Swatinem/rust-cache ir upload-artifact naudos jo podėlį be jokių pakeitimų. GitHub talpinamuose runner’iuose ta pati darbo eiga grįžta prie GitHub podėlio.

    # 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. Vienas žingsnis

    Nebeperkurkite to, ką Turborepo jau sukūrė

    Pridėkite setup-cacheflow, ir kiekviena užduotis, kurios įvestys nepasikeitė, užuot vykdoma iš naujo, tiesiog atkurs savo rezultatus — tarp job’ų, šakų ir repozitorijų.

    Žiūrėti visą darbo eigą ↓
  3. Leidimams

    Išleiskite tik tai, ką sukūrė patikimas build’as

    Leidimų ir diegimų podėlį išsaugokite per CacheFlow veiksmus. Kiekvienas įrašas fiksuoja jį sukūrusį įvykį, ref, commit’ą ir darbo eigą. Pridėkite patikimų vartotojų politiką, ir jūsų leidimų job’ai atkurs tik tuos įrašus, kuriuos jūsų apsaugotoje šakoje išsaugojo push’as, suplanuotas ar rankinis paleidimas.

    # 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. Bet koks įrankis

    Kaupkite bet ką podėlyje iš komandinės eilutės

    cacheflow CLI ir Python SDK išsaugo ir atkuria bet kokį artefaktą iš bet kurio build įrankio. Sesijos buferizuoja lygiagrečių matricos job’ų įrašus ir patvirtina juos atomiškai, todėl nė vienas job’as neperrašo kito.

    # 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 nuotolinis podėlis vienu žingsniu

setup-cacheflow sukuria trumpalaikį OIDC prisijungimo duomenį ir eksportuoja TURBO_API, TURBO_TOKEN ir TURBO_TEAM. Jokių saugomų paslapčių:

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

Klausimai, kuriuos komandos užduoda pirmiausia

Ar turime keisti savo darbo eigas?
Actions podėliui ir artefaktams — ne. Vieną kartą nukreipkite savo runner’ių aplinką į CacheFlow, ir standartiniai actions/cache, setup-node, Swatinem/rust-cache ir upload-artifact jį naudos be pakeitimų. GitHub talpinamuose runner’iuose tos pačios darbo eigos toliau naudoja GitHub podėlį. Turborepo nuotoliniam podėliui reikia vieno setup-cacheflow žingsnio kiekvienoje darbo eigoje.
Kur saugomi mūsų duomenys?
Jūsų Cloudflare paskyroje: baitai R2, raktų nuosavybė D1, skaitymo kelias KV ir vykdomos sesijos Durable Objects. Telemetrija Actions podėlio raktus ir artefaktų pavadinimus registruoja tik kaip raktuotą maišą. Taip pat planuojame valdomą planą, kurį už jus valdys CacheFlow.
Kiek tai kainuoja?
Už CacheFlow naudojamus Cloudflare išteklius sąskaitos išrašomos jūsų pačių Cloudflare paskyrai, o R2 neima mokesčio už išeinantį srautą. Pačios CacheFlow kainodarą pateiksime ankstyvosios prieigos komandoms.
Ar tai greičiau nei GitHub podėlis?
Mes neteigiame nieko apie greitį. Baitai gaunami iš Cloudflare R2 per internetą, ir mes nesame išmatavę jokio atkūrimo greičio pranašumo. Jei jums reikia podėlio šalia runner’io, jums gali labiau tikti runner’ių tiekėjo podėlis.
Kaip job’ai autentifikuojasi?
Job’ai, naudojantys CacheFlow veiksmus arba setup-cacheflow, iškeičia trumpalaikį GitHub OIDC žetoną. Drop-in job’ai su standartiniais veiksmais naudoja vykdymo žetoną, kurį GitHub jau suteikia kiekvienam job’ui. Bet kuriuo atveju jūsų konvejeriuose nesaugoma jokia ilgalaikė paslaptis. Kitos CI sistemos ir kūrėjų nešiojamieji kompiuteriai naudoja jūsų operatoriaus išduotą žetoną.
Ar galime grįžti atgal?
Taip. CacheFlow naudoja tuos pačius protokolus, kuriuos jau naudoja jūsų įrankiai: Actions podėlio ir artefaktų paslaugas bei Turborepo nuotolinį podėlį. Pašalinkite runner’io nustatymą arba setup-cacheflow žingsnį, ir jūsų darbo eigos grįš prie podėlio, kurį naudojo anksčiau.

Gaukite ankstyvą prieigą

Prisijunkite prie laukiančiųjų sąrašo — susisieksime, kai tik jūsų komanda galės pradėti.