Кеш за GitHub Actions · артефакти · Turborepo

Вашият CI кеш, във вашия собствен акаунт в Cloudflare

Стандартните actions/cache и upload-artifact минават през CacheFlow без промени в работните потоци, а Turborepo — с една стъпка за настройка. Добавете политика за доверени консуматори и релийз задачите ви ще възстановяват само това, което е създал доверен билд.

Кеш, който е ваш, на който имате доверие и в който виждате какво става

Притежавайте го

Вашият акаунт, вашите байтове

CacheFlow работи във вашия акаунт в Cloudflare, така че байтовете на кеша и артефактите никога не стоят при трета страна, а ресурсите се появяват във вашата собствена сметка от Cloudflare.

  • Байтовете на артефактите в R2, без такси за изходящ трафик
  • Собствеността на ключовете в D1, бърз път за четене в KV, активните сесии в Durable Objects
  • Едно внедряване обслужва кеша на Actions, артефактите на Actions и отдалечения кеш на Turborepo

Доверете му се

Възстановявайте само това, което е записал доверен билд

Записите, запазени с GitHub OIDC токен, както правят CacheFlow actions, пазят събитието, ref-а, къмита и работния поток зад тях. Добавете политика за доверени консуматори и релийз задачите ви ще възстановяват само записи, които push, планирано или ръчно изпълнение е записало във вашия защитен клон.

  • Само краткотрайни идентификационни данни: GitHub OIDC за CacheFlow actions, собственият runtime токен на GitHub за задачите със стандартни actions
  • Всеки клон записва само в собствения си обхват и чете през базовия си клон и клона по подразбиране
  • При задачите с OIDC записите в защитен клон от събития, които външни лица могат да задействат, като pull_request_target, се поставят под карантина; задачите със стандартни actions следват собственото разрешение за кеша, дадено от GitHub

Вижте го

Знайте своя процент на попадения

Всяко възстановяване, пропуск и запис в кеша и артефактите на Actions се регистрира заедно с байтовете си, както и изтеглянията и качванията на Turborepo, включително дали възстановяването е съвпаднало с точния си ключ, или е преминало към префикс.

  • Ключовете на кеша на Actions и имената на артефактите се записват само като хеш с ключ, никога във вида, в който са написани
  • Сесиите буферират записите от паралелни matrix задачи и ги потвърждават атомарно
  • Остарелите сесии се почистват, когато билдовете приключат или времето им изтече

Започнете оттам, където вече сте

Четири начина да започнете — от нула промени до пълен контрол. Повечето екипи тръгват с първия и никога не редактират работен поток.

  1. Без промени

    Запазете работните потоци, които имате

    Насочете рънърите си към CacheFlow веднъж. Стандартните actions/cache, setup-node, Swatinem/rust-cache и upload-artifact след това кешират през него, без никакви промени. На рънъри, хоствани от GitHub, същият работен поток се връща към кеша на 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. Една стъпка

    Спрете да билдвате отново това, което Turborepo вече е билднал

    Добавете setup-cacheflow и всяка задача, чиито входни данни не са се променили, възпроизвежда изходите си, вместо да се изпълнява отново — между задачи, клонове и хранилища.

    Вижте целия работен поток ↓
  3. За релийзи

    Пускайте само това, което е създал доверен билд

    Записвайте кеша за релийзи и деплойменти чрез CacheFlow actions. Всеки запис пази събитието, ref-а, къмита и работния поток зад него. Добавете политика за доверени консуматори и релийз задачите ви ще възстановяват само записи, които push, планирано или ръчно изпълнение е записало във вашия защитен клон.

    # 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. Всеки инструмент

    Кеширайте всичко от командния ред

    cacheflow CLI и Python SDK записват и възстановяват всякакви артефакти от всеки билд инструмент. Сесиите буферират записите от паралелни matrix задачи и ги потвърждават атомарно, така че никоя задача не презаписва друга.

    # 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 с една стъпка

setup-cacheflow издава краткотраен OIDC идентификационен документ и експортира TURBO_API, TURBO_TOKEN и TURBO_TEAM. Без съхранени тайни:

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

Въпросите, които екипите задават първо

Трябва ли да променяме работните си потоци?
Не, що се отнася до кеша и артефактите на Actions. Насочете средата на рънърите си към CacheFlow веднъж и стандартните actions/cache, setup-node, Swatinem/rust-cache и upload-artifact го използват без промени. На рънъри, хоствани от GitHub, същите работни потоци продължават да използват кеша на GitHub. Отдалеченият кеш на Turborepo изисква една стъпка setup-cacheflow за всеки работен поток.
Къде се намират данните ни?
Във вашия акаунт в Cloudflare: байтовете в R2, собствеността на ключовете в D1, пътят за четене в KV и активните сесии в Durable Objects. Телеметрията записва ключовете на кеша на Actions и имената на артефактите само като хеш с ключ. Планираме и управляван план, който CacheFlow поддържа вместо вас.
Колко струва?
Ресурсите на Cloudflare, които CacheFlow използва, се таксуват във вашия собствен акаунт в Cloudflare, а R2 не начислява такси за изходящ трафик. Ще споделим цените на самия CacheFlow с екипите с ранен достъп.
По-бърз ли е от кеша на GitHub?
Не правим твърдения за скоростта. Байтовете идват от Cloudflare R2 през интернет и не сме измервали предимство в скоростта на възстановяване. Ако ви трябва кеш непосредствено до рънъра, кешът на доставчик на рънъри може да ви подхожда повече.
Как се удостоверяват задачите?
Задачите, които използват CacheFlow actions или setup-cacheflow, обменят краткотраен GitHub OIDC токен. Задачите със стандартни actions използват runtime токена, който GitHub вече дава на всяка задача. И в двата случая в конвейерите ви не се съхранява дълготрайна тайна. Други CI системи и лаптопите на разработчиците използват токен, издаден от вашия оператор.
Можем ли да се върнем обратно?
Да. CacheFlow говори протоколите, които инструментите ви вече използват: услугите за кеш и артефакти на Actions и отдалечения кеш на Turborepo. Премахнете настройката на рънъра или стъпката setup-cacheflow и работните ви потоци се връщат към кеша, който са използвали преди.

Получете ранен достъп

Запишете се в списъка на чакащите и ще се свържем с вас, щом екипът ви може да започне.