GitHub Actions kešatmiņa · artefakti · Turborepo

Jūsu CI kešatmiņa jūsu pašu Cloudflare kontā

Standarta actions/cache un upload-artifact izmanto kešatmiņu caur CacheFlow bez izmaiņām darbplūsmās, bet Turborepo — ar vienu iestatīšanas soli. Pievienojiet uzticamu patērētāju politiku, un jūsu laidienu jobi atjaunos tikai to, ko radījusi uzticama būve.

Kešatmiņa, kas pieder jums, kurai varat uzticēties un kurā varat ieskatīties

Pieder jums

Jūsu konts, jūsu baiti

CacheFlow darbojas jūsu Cloudflare kontā, tāpēc kešatmiņas un artefaktu baiti nekad neatrodas pie trešās puses, un resursi parādās jūsu pašu Cloudflare rēķinā.

  • Artefaktu baiti R2, bez izejošās datplūsmas maksas
  • Atslēgu piederība D1, ātrs lasīšanas ceļš KV, notiekošās sesijas Durable Objects
  • Viena izvietošana apkalpo Actions kešatmiņu, Actions artefaktus un Turborepo attālo kešatmiņu

Uzticieties

Atjaunojiet tikai to, ko saglabājusi uzticama būve

Ieraksti, kas saglabāti ar GitHub OIDC marķieri, kā to dara CacheFlow darbības, fiksē notikumu, ref, commit un darbplūsmu, no kuras tie radušies. Pievienojiet uzticamu patērētāju politiku, un jūsu laidienu jobi atjaunos tikai ierakstus, ko jūsu aizsargātajā zarā saglabājis push, ieplānota vai manuāla palaišana.

  • Tikai īslaicīgi akreditācijas dati: GitHub OIDC CacheFlow darbībām, paša GitHub izpildlaika marķieris drop-in jobiem
  • Katrs zars raksta tikai savā tvērumā un lasa caur savu bāzes zaru un noklusējuma zaru
  • OIDC jobos saglabājumi aizsargātā zarā no notikumiem, ko var izraisīt nepiederošas personas, piemēram, pull_request_target, tiek ievietoti karantīnā; drop-in jobi ievēro paša GitHub kešatmiņas piekļuves tiesības

Redziet

Ziniet savu trāpījumu līmeni

Katra Actions kešatmiņas un artefaktu atjaunošana, netrāpījums un saglabāšana tiek reģistrēta kopā ar baitu apjomu, tāpat kā Turborepo lejupielādes un augšupielādes, tostarp tas, vai atjaunošana atbilda precīzai atslēgai vai atkāpās uz prefiksu.

  • Actions kešatmiņas atslēgas un artefaktu nosaukumi tiek reģistrēti tikai kā atslēgots jaucējkods, nekad oriģinālajā veidā
  • Sesijas buferizē paralēlo matricas jobu ierakstus un apstiprina tos atomāri
  • Novecojušas sesijas tiek iztīrītas, kad būves beidzas vai pārsniedz laika limitu

Sāciet tur, kur jau esat

Četri ceļi — no nulles izmaiņām līdz pilnai kontrolei. Lielākā daļa komandu sāk ar pirmo un nekad nerediģē nevienu darbplūsmu.

  1. Bez izmaiņām

    Paturiet esošās darbplūsmas

    Vienreiz norādiet saviem runneriem uz CacheFlow. Pēc tam standarta actions/cache, setup-node, Swatinem/rust-cache un upload-artifact izmanto tā kešatmiņu bez jebkādām izmaiņām. GitHub mitinātos runneros tā pati darbplūsma atgriežas pie GitHub kešatmiņas.

    # 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. Viens solis

    Vairs nebūvējiet to, ko Turborepo jau uzbūvēja

    Pievienojiet setup-cacheflow, un katrs uzdevums, kura ievaddati nav mainījušies, atkārto savus rezultātus, nevis tiek palaists no jauna — starp jobiem, zariem un repozitorijiem.

    Skatīt pilnu darbplūsmu ↓
  3. Laidieniem

    Piegādājiet tikai to, ko radījusi uzticama būve

    Saglabājiet laidienu un izvietošanas kešatmiņas, izmantojot CacheFlow darbības. Katrs ieraksts fiksē notikumu, ref, commit un darbplūsmu, no kuras tas radies. Pievienojiet uzticamu patērētāju politiku, un jūsu laidienu jobi atjaunos tikai ierakstus, ko jūsu aizsargātajā zarā saglabājis push, ieplānota vai manuāla palaišana.

    # 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. Jebkurš rīks

    Kešojiet jebko no komandrindas

    cacheflow CLI un Python SDK saglabā un atjauno jebkuru artefaktu no jebkura būves rīka. Sesijas buferizē paralēlo matricas jobu ierakstus un apstiprina tos atomāri, tāpēc neviens jobs nepārraksta cita darbu.

    # 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 attālā kešatmiņa vienā solī

setup-cacheflow izveido īslaicīgus OIDC akreditācijas datus un eksportē TURBO_API, TURBO_TOKEN un TURBO_TEAM. Nekādu glabātu noslēpumu:

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

Jautājumi, ko komandas uzdod vispirms

Vai mums jāmaina savas darbplūsmas?
Actions kešatmiņai un artefaktiem — nē. Vienreiz iestatiet savu runneru vidi, lai tā norādītu uz CacheFlow, un standarta actions/cache, setup-node, Swatinem/rust-cache un upload-artifact to izmantos bez izmaiņām. GitHub mitinātos runneros tās pašas darbplūsmas turpina izmantot GitHub kešatmiņu. Turborepo attālajai kešatmiņai katrā darbplūsmā nepieciešams viens setup-cacheflow solis.
Kur glabājas mūsu dati?
Jūsu Cloudflare kontā: baiti R2, atslēgu piederība D1, lasīšanas ceļš KV un notiekošās sesijas Durable Objects. Telemetrija Actions kešatmiņas atslēgas un artefaktu nosaukumus reģistrē tikai kā atslēgotu jaucējkodu. Mēs plānojam arī pārvaldītu plānu, ko jūsu vietā uzturēs CacheFlow.
Cik tas maksā?
Cloudflare resursi, ko izmanto CacheFlow, tiek iekļauti jūsu pašu Cloudflare konta rēķinā, un R2 neiekasē maksu par izejošo datplūsmu. Pašas CacheFlow cenas darīsim zināmas komandām ar agrīnu piekļuvi.
Vai tas ir ātrāks par GitHub kešatmiņu?
Mēs neko neapgalvojam par ātrumu. Baiti tiek saņemti no Cloudflare R2 caur internetu, un mēs neesam izmērījuši nekādas priekšrocības atjaunošanas ātrumā. Ja jums nepieciešama kešatmiņa tieši blakus runnerim, jums labāk varētu derēt runneru piegādātāja kešatmiņa.
Kā jobi autentificējas?
Jobi, kas izmanto CacheFlow darbības vai setup-cacheflow, apmaina īslaicīgu GitHub OIDC marķieri. Drop-in jobi ar standarta darbībām izmanto izpildlaika marķieri, ko GitHub jau piešķir katram jobam. Jebkurā gadījumā jūsu konveijeros netiek glabāts neviens ilgtermiņa noslēpums. Citas CI sistēmas un izstrādātāju klēpjdatori izmanto marķieri, ko izsniedz jūsu operators.
Vai varam pāriet atpakaļ?
Jā. CacheFlow izmanto tos pašus protokolus, ko jau izmanto jūsu rīki: Actions kešatmiņas un artefaktu pakalpojumus un Turborepo attālo kešatmiņu. Noņemiet runnera iestatījumu vai setup-cacheflow soli, un jūsu darbplūsmas atgriezīsies pie kešatmiņas, ko tās izmantoja iepriekš.

Iegūstiet agrīnu piekļuvi

Pievienojieties gaidīšanas sarakstam, un mēs sazināsimies, tiklīdz jūsu komanda varēs sākt.