Cache GitHub Actions · artefakty · Turborepo

Twój cache CI na Twoim własnym koncie Cloudflare

Standardowe actions/cache i upload-artifact korzystają z cache przez CacheFlow bez zmian w workflow, a Turborepo po jednym kroku konfiguracji. Dodaj politykę zaufanych konsumentów, a Twoje joby release’owe przywrócą tylko to, co wytworzył zaufany build.

Cache, który należy do Ciebie, któremu ufasz i w który masz wgląd

Posiadaj

Twoje konto, Twoje bajty

CacheFlow działa na Twoim koncie Cloudflare, więc bajty cache i artefaktów nigdy nie trafiają do strony trzeciej, a zasoby pojawiają się na Twoim własnym rachunku Cloudflare.

  • Bajty artefaktów w R2, bez opłat za ruch wychodzący
  • Własność kluczy w D1, szybka ścieżka odczytu w KV, trwające sesje w Durable Objects
  • Jedno wdrożenie obsługuje cache Actions, artefakty Actions i zdalny cache Turborepo

Ufaj

Przywracaj tylko to, co zapisał zaufany build

Wpisy zapisane z tokenem GitHub OIDC, tak jak robią to akcje CacheFlow, rejestrują zdarzenie, ref, commit i workflow, z których pochodzą. Dodaj politykę zaufanych konsumentów, a Twoje joby release’owe przywrócą tylko wpisy zapisane na Twoim chronionym branchu przez push, uruchomienie według harmonogramu lub uruchomienie ręczne.

  • Wyłącznie krótkotrwałe poświadczenia: GitHub OIDC dla akcji CacheFlow, własny token runtime GitHub dla jobów drop-in
  • Każdy branch zapisuje tylko we własnym zakresie, a odczytuje przez swój branch bazowy i branch domyślny
  • W jobach z OIDC zapisy na chronionym branchu ze zdarzeń, które mogą wywołać osoby z zewnątrz, takich jak pull_request_target, trafiają do kwarantanny; joby drop-in podlegają własnym uprawnieniom GitHub do cache

Obserwuj

Poznaj swój współczynnik trafień

Każde przywrócenie, chybienie i zapis w cache Actions i artefaktach są rejestrowane wraz z liczbą bajtów, podobnie jak pobrania i wysyłki Turborepo, łącznie z informacją, czy przywrócenie trafiło w dokładny klucz, czy skorzystało z dopasowania po prefiksie.

  • Klucze cache Actions i nazwy artefaktów są rejestrowane wyłącznie jako hash z kluczem, nigdy w oryginalnej postaci
  • Sesje buforują zapisy z równoległych jobów macierzy i zatwierdzają je atomowo
  • Nieaktualne sesje są czyszczone, gdy buildy się kończą lub przekraczają limit czasu

Zacznij tam, gdzie już jesteś

Cztery sposoby na start — od zera zmian po pełną kontrolę. Większość zespołów zaczyna od pierwszego i nigdy nie edytuje żadnego workflow.

  1. Zero zmian

    Zachowaj workflow, które już masz

    Raz skieruj swoje runnery na CacheFlow. Standardowe actions/cache, setup-node, Swatinem/rust-cache i upload-artifact zaczną korzystać z jego cache — bez żadnych zmian. Na runnerach hostowanych przez GitHub ten sam workflow wraca do cache GitHub.

    # 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. Jeden krok

    Przestań przebudowywać to, co Turborepo już zbudowało

    Dodaj setup-cacheflow, a każde zadanie, którego wejścia się nie zmieniły, odtworzy swoje wyniki zamiast uruchamiać się ponownie — między jobami, branchami i repozytoriami.

    Zobacz cały workflow ↓
  3. Gotowe na release

    Wdrażaj tylko to, co zbudował zaufany build

    Zapisuj cache release’ów i wdrożeń przez akcje CacheFlow. Każdy wpis rejestruje zdarzenie, ref, commit i workflow, z których pochodzi. Dodaj politykę zaufanych konsumentów, a Twoje joby release’owe przywrócą tylko wpisy zapisane na Twoim chronionym branchu przez push, uruchomienie według harmonogramu lub uruchomienie ręczne.

    # 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. Dowolne narzędzie

    Cache’uj wszystko z linii poleceń

    cacheflow CLI i Python SDK zapisują i przywracają dowolny artefakt z dowolnego narzędzia do budowania. Sesje buforują zapisy z równoległych jobów macierzy i zatwierdzają je atomowo, więc żaden job nie nadpisuje innego.

    # 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

Zdalny cache Turborepo w jednym kroku

setup-cacheflow generuje krótkotrwałe poświadczenie OIDC i eksportuje TURBO_API, TURBO_TOKEN i TURBO_TEAM. Żadnych przechowywanych sekretów:

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

Pytania, które zespoły zadają najpierw

Czy musimy zmieniać nasze workflow?
Nie w przypadku cache Actions i artefaktów. Raz skieruj środowisko swoich runnerów na CacheFlow, a standardowe actions/cache, setup-node, Swatinem/rust-cache i upload-artifact będą z niego korzystać bez zmian. Na runnerach hostowanych przez GitHub te same workflow nadal korzystają z cache GitHub. Zdalny cache Turborepo wymaga jednego kroku setup-cacheflow w każdym workflow.
Gdzie przechowywane są nasze dane?
Na Twoim koncie Cloudflare: bajty w R2, własność kluczy w D1, ścieżka odczytu w KV, a trwające sesje w Durable Objects. Telemetria rejestruje klucze cache Actions i nazwy artefaktów wyłącznie jako hash z kluczem. Planujemy też plan zarządzany, który CacheFlow będzie prowadzić za Ciebie.
Ile to kosztuje?
Zasoby Cloudflare używane przez CacheFlow są rozliczane na Twoim własnym koncie Cloudflare, a R2 nie pobiera opłat za ruch wychodzący. Cennik samego CacheFlow udostępnimy zespołom z wczesnym dostępem.
Czy jest szybszy niż cache GitHub?
Nie składamy żadnych deklaracji dotyczących szybkości. Bajty pochodzą z Cloudflare R2 przez internet, a ewentualnej przewagi w szybkości przywracania nie mierzyliśmy. Jeśli potrzebujesz cache tuż obok runnera, lepiej może sprawdzić się cache dostawcy runnerów.
Jak uwierzytelniają się joby?
Joby korzystające z akcji CacheFlow lub setup-cacheflow wymieniają krótkotrwały token GitHub OIDC. Joby drop-in na standardowych akcjach używają tokenu runtime, który GitHub już przekazuje każdemu jobowi. W obu przypadkach w Twoich pipeline’ach nie jest przechowywany żaden długotrwały sekret. Inne systemy CI i laptopy programistów używają tokenu wydanego przez Twojego operatora.
Czy możemy wrócić do poprzedniego rozwiązania?
Tak. CacheFlow obsługuje protokoły, których Twoje narzędzia już używają: usługi cache i artefaktów Actions oraz zdalny cache Turborepo. Usuń ustawienie runnera lub krok setup-cacheflow, a Twoje workflow wrócą do cache, z którego korzystały wcześniej.

Uzyskaj wcześniejszy dostęp

Dołącz do listy oczekujących, a odezwiemy się, gdy Twój zespół będzie mógł zacząć.