GitHub Actions-cache · artefakter · Turborepo

Din CI-cache, på din egen Cloudflare-konto

Standard actions/cache og upload-artifact cacher igennem CacheFlow uden ændringer i dine workflows, og Turborepo med ét opsætningstrin. Tilføj en politik for betroede forbrugere, så gendanner dine release-jobs kun det, et betroet build har produceret.

En cache, du ejer, stoler på og kan se ind i

Ejerskab

Din konto, dine bytes

CacheFlow kører på din Cloudflare-konto, så cache- og artefakt-bytes ligger aldrig hos en tredjepart, og ressourcerne fremgår af din egen Cloudflare-regning.

  • Artefakt-bytes i R2, uden gebyrer for udgående trafik
  • Nøgleejerskab i D1, en hurtig læsesti i KV, igangværende sessioner i Durable Objects
  • Én udrulning betjener Actions-cachen, Actions-artefakter og Turborepos fjerncache

Tillid

Gendan kun det, et betroet build har gemt

Poster, der gemmes med et GitHub OIDC-token, som CacheFlow-actions gør, registrerer eventet, ref, commit og workflow bag dem. Tilføj en politik for betroede forbrugere, så gendanner dine release-jobs kun poster, som et push, en planlagt eller en manuel kørsel har gemt på din beskyttede branch.

  • Kun kortlivede legitimationsbeviser: GitHub OIDC til CacheFlow-actions, GitHubs eget runtime-token til drop-in-jobs
  • Hver branch skriver kun til sit eget scope og læser via sin base-branch og standard-branchen
  • På OIDC-jobs sættes gemninger på en beskyttet branch fra events, som udefrakommende kan udløse, såsom pull_request_target, i karantæne; drop-in-jobs følger GitHubs egen cache-tilladelse

Overblik

Kend din hitrate

Hver gendannelse, hvert miss og hver gemning i Actions-cachen og artefakter registreres med sine bytes, ligesom downloads og uploads i Turborepo, herunder om en gendannelse ramte sin præcise nøgle eller faldt tilbage til et præfiks.

  • Nøgler i Actions-cachen og artefaktnavne registreres kun som en nøglet hash, aldrig som de blev skrevet
  • Sessioner buffer skrivninger fra parallelle matrix-jobs og committer dem atomisk
  • Forældede sessioner ryddes op, når builds afsluttes eller får timeout

Start dér, hvor du allerede er

Fire veje ind, fra nul ændringer til fuld kontrol. De fleste teams starter med den første og redigerer aldrig et workflow.

  1. Nul ændringer

    Behold de workflows, du har

    Peg dine runners mod CacheFlow én gang. Standard actions/cache, setup-node, Swatinem/rust-cache og upload-artifact cacher derefter igennem det, helt uændret. På GitHub-hostede runners falder det samme workflow tilbage til GitHubs cache.

    # 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. Ét trin

    Stop med at genbygge det, Turborepo allerede har bygget

    Tilføj setup-cacheflow, og hver opgave, hvis input ikke har ændret sig, genafspiller sine output i stedet for at køre igen — på tværs af jobs, branches og repositories.

    Se hele workflowet ↓
  3. Release-klar

    Udgiv kun det, et betroet build har produceret

    Gem release- og deploy-caches via CacheFlow-actions. Hver post registrerer eventet, ref, commit og workflow bag den. Tilføj en politik for betroede forbrugere, så gendanner dine release-jobs kun poster, som et push, en planlagt eller en manuel kørsel har gemt på din beskyttede branch.

    # 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. Ethvert værktøj

    Cache alt fra kommandolinjen

    cacheflow CLI og Python SDK gemmer og gendanner ethvert artefakt fra ethvert build-værktøj. Sessioner buffer skrivninger fra parallelle matrix-jobs og committer dem atomisk, så intet job overskriver et andet.

    # 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-fjerncache i ét trin

setup-cacheflow udsteder et kortlivet OIDC-legitimationsbevis og eksporterer TURBO_API, TURBO_TOKEN og TURBO_TEAM. Ingen gemte hemmeligheder:

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

Spørgsmål, teams stiller først

Skal vi ændre vores workflows?
Ikke for Actions-cachen og artefakter. Peg miljøet for dine runners mod CacheFlow én gang, så bruger standard actions/cache, setup-node, Swatinem/rust-cache og upload-artifact det uden ændringer. På GitHub-hostede runners bliver de samme workflows ved med at bruge GitHubs cache. Turborepos fjerncache kræver ét setup-cacheflow-trin pr. workflow.
Hvor ligger vores data?
På din Cloudflare-konto: bytes i R2, nøgleejerskab i D1, en læsesti i KV og igangværende sessioner i Durable Objects. Telemetrien registrerer nøgler i Actions-cachen og artefaktnavne kun som en nøglet hash. Vi planlægger også en administreret plan, som CacheFlow driver for dig.
Hvad koster det?
De Cloudflare-ressourcer, CacheFlow bruger, faktureres til din egen Cloudflare-konto, og R2 opkræver ingen gebyrer for udgående trafik. Vi deler priserne for selve CacheFlow med teams med tidlig adgang.
Er det hurtigere end GitHubs cache?
Vi fremsætter ingen påstand om hastighed. Bytes hentes fra Cloudflare R2 over internettet, og vi har ikke målt nogen fordel i gendannelseshastighed. Har du brug for en cache lige ved siden af runneren, passer en runner-leverandørs cache måske bedre til dig.
Hvordan autentificerer jobs sig?
Jobs, der bruger CacheFlow-actions eller setup-cacheflow, veksler et kortlivet GitHub OIDC-token ind. Drop-in-jobs på standard-actions bruger det runtime-token, GitHub allerede giver hvert job. Uanset hvad gemmes der ingen langlivet hemmelighed i dine pipelines. Andre CI-systemer og udvikleres bærbare bruger et token, som din operatør udsteder.
Kan vi skifte tilbage?
Ja. CacheFlow taler de protokoller, dine værktøjer allerede bruger: Actions-cache- og artefakttjenesterne og Turborepos fjerncache. Fjern runner-indstillingen eller setup-cacheflow-trinnet, så går dine workflows tilbage til den cache, de brugte før.

Få tidlig adgang

Skriv dig på ventelisten, så kontakter vi dig, når dit team kan komme i gang.