Cache ta’ GitHub Actions · artefatti · Turborepo

Il-cache tas-CI tiegħek, fil-kont Cloudflare tiegħek stess

actions/cache u upload-artifact standard jgħaddu minn CacheFlow mingħajr bidliet fil-workflows, u Turborepo b’pass wieħed ta’ setup. Żid policy ta’ konsumaturi affidabbli, u l-jobs tar-release tiegħek jirrestawraw biss dak li pproduċa build affidabbli.

Cache li hija tiegħek, li tista’ tafdaha u li tista’ tara x’qed jiġri fiha

Tiegħek

Il-kont tiegħek, il-bytes tiegħek

CacheFlow jaħdem fuq il-kont Cloudflare tiegħek, għalhekk il-bytes tal-cache u tal-artefatti qatt ma jinżammu għand terza parti, u r-riżorsi jidhru fuq il-kont tal-ħlas ta’ Cloudflare tiegħek stess.

  • Il-bytes tal-artefatti f’R2, mingħajr tariffi tal-egress
  • Is-sjieda taċ-ċwievet f’D1, triq ta’ qari mgħaġġla f’KV, is-sessjonijiet għaddejjin f’Durable Objects
  • Deployment wieħed iservi l-Actions cache, l-artefatti ta’ Actions u l-cache remota ta’ Turborepo

Afdah

Irrestawra biss dak li ssejvja build affidabbli

L-entrati ssejvjati b’token GitHub OIDC, kif jagħmlu l-actions ta’ CacheFlow, jirreġistraw l-avveniment, ir-ref, il-commit u l-workflow li ħolquhom. Żid policy ta’ konsumaturi affidabbli, u l-jobs tar-release tiegħek jirrestawraw biss entrati li ssejvja fuq il-branch protett tiegħek push, run skedat jew run manwali.

  • Kredenzjali ta’ ħajja qasira biss: GitHub OIDC għall-actions ta’ CacheFlow, it-token runtime ta’ GitHub stess għall-jobs b’actions standard
  • Kull branch jikteb biss fl-ambitu tiegħu stess u jaqra mill-branch bażi tiegħu u mill-branch default
  • Fuq jobs OIDC, is-salvataġġi fuq branch protett minn avvenimenti li persuni minn barra jistgħu jqanqlu, bħal pull_request_target, jitqiegħdu fi kwarantina; il-jobs b’actions standard isegwu l-permess tal-cache li jagħti GitHub stess

Arah

Kun af ir-rata ta’ hits tiegħek

Kull restawr, miss u salvataġġ fl-Actions cache u fl-artefatti jiġi rreġistrat bil-bytes tiegħu, bħalma jiġu rreġistrati d-downloads u l-uploads ta’ Turborepo, inkluż jekk ir-restawr qabilx iċ-ċavetta eżatta tiegħu jew waqa’ lura fuq prefiss.

  • Iċ-ċwievet tal-Actions cache u l-ismijiet tal-artefatti jiġu rreġistrati biss bħala hash b’ċavetta, qatt kif inkitbu
  • Is-sessjonijiet iżommu fil-buffer il-kitbiet minn jobs paralleli tal-matriċi u jikkommettjawhom b’mod atomiku
  • Is-sessjonijiet mitluqa jitnaddfu meta l-builds jispiċċaw jew jaqbżu l-ħin

Ibda minn fejn diġà tinsab

Erba’ modi kif tibda, minn żero bidliet sa kontroll sħiħ. Il-biċċa l-kbira tat-timijiet jibdew bl-ewwel wieħed u qatt ma jeditjaw workflow.

  1. Żero bidliet

    Żomm il-workflows li diġà għandek

    Ippunta r-runners tiegħek lejn CacheFlow darba biss. Minn hemm ’il quddiem, actions/cache, setup-node, Swatinem/rust-cache u upload-artifact standard jagħmlu cache permezz tiegħu, mingħajr ebda bidla. Fuq runners ospitati minn GitHub, l-istess workflow jerġa’ juża l-cache ta’ 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. Pass wieħed

    Tibqax tibni mill-ġdid dak li Turborepo diġà bena

    Żid setup-cacheflow u kull task li l-inputs tiegħu ma nbidlux jirriproduċi l-outputs tiegħu minflok ma jerġa’ jaħdem, bejn jobs, branches u repositories.

    Ara l-workflow sħiħ ↓
  3. Għar-releases

    Ibgħat biss dak li pproduċa build affidabbli

    Issejvja l-caches tar-release u tad-deploy permezz tal-actions ta’ CacheFlow. Kull entrata tirreġistra l-avveniment, ir-ref, il-commit u l-workflow li ħolquha. Żid policy ta’ konsumaturi affidabbli, u l-jobs tar-release tiegħek jirrestawraw biss entrati li ssejvja fuq il-branch protett tiegħek push, run skedat jew run manwali.

    # 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. Kwalunkwe għodda

    Agħmel cache ta’ kollox mil-linja tal-kmand

    Is-cacheflow CLI u l-Python SDK jaħżnu u jirrestawraw kwalunkwe artefatt minn kwalunkwe għodda tal-build. Is-sessjonijiet iżommu fil-buffer il-kitbiet minn jobs paralleli tal-matriċi u jikkommettjawhom b’mod atomiku, biex l-ebda job ma jikteb fuq ieħor.

    # 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

Il-cache remota ta’ Turborepo f’pass wieħed

setup-cacheflow joħloq kredenzjali OIDC ta’ ħajja qasira u jesporta TURBO_API, TURBO_TOKEN u TURBO_TEAM. L-ebda sigriet maħżun:

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

Il-mistoqsijiet li t-timijiet jagħmlu l-ewwel

Irridu nibdlu l-workflows tagħna?
Mhux għall-Actions cache u l-artefatti. Ippunta l-ambjent tar-runners tiegħek lejn CacheFlow darba biss, u actions/cache, setup-node, Swatinem/rust-cache u upload-artifact standard jużawh mingħajr bidla. Fuq runners ospitati minn GitHub, l-istess workflows ikomplu jużaw il-cache ta’ GitHub. Il-cache remota ta’ Turborepo teħtieġ pass wieħed setup-cacheflow għal kull workflow.
Fejn tinżamm id-data tagħna?
Fil-kont Cloudflare tiegħek: il-bytes f’R2, is-sjieda taċ-ċwievet f’D1, triq ta’ qari f’KV u s-sessjonijiet għaddejjin f’Durable Objects. It-telemetrija tirreġistra ċ-ċwievet tal-Actions cache u l-ismijiet tal-artefatti biss bħala hash b’ċavetta. Qed nippjanaw ukoll pjan immaniġġjat li CacheFlow tħaddem għalik.
Kemm jiswa?
Ir-riżorsi ta’ Cloudflare li juża CacheFlow jiġu ddebitati lill-kont Cloudflare tiegħek stess, u R2 ma jitlob l-ebda tariffa tal-egress. Il-prezzijiet ta’ CacheFlow innifsu se naqsmuhom mat-timijiet b’aċċess bikri.
Huwa aktar mgħaġġel mill-cache ta’ GitHub?
Ma nagħmlu l-ebda pretensjoni dwar il-veloċità. Il-bytes jiġu minn Cloudflare R2 fuq l-internet, u ma kejjilniex xi vantaġġ fil-veloċità tar-restawr. Jekk għandek bżonn cache ħdejn ir-runner, il-cache ta’ fornitur tar-runners tista’ taqdik aħjar.
Kif jawtentikaw ruħhom il-jobs?
Il-jobs li jużaw l-actions ta’ CacheFlow jew setup-cacheflow jiskambjaw token GitHub OIDC ta’ ħajja qasira. Il-jobs b’actions standard jużaw it-token runtime li GitHub diġà jagħti lil kull job. Fi kwalunkwe każ, l-ebda sigriet ta’ ħajja twila ma jinħażen fil-pipelines tiegħek. Sistemi CI oħra u l-laptops tal-iżviluppaturi jużaw token maħruġ mill-operatur tiegħek.
Nistgħu nerġgħu lura?
Iva. CacheFlow jitkellem il-protokolli li l-għodod tiegħek diġà jużaw: is-servizzi tal-Actions cache u tal-artefatti u l-cache remota ta’ Turborepo. Neħħi s-setting tar-runner jew il-pass setup-cacheflow, u l-workflows tiegħek imorru lura għall-cache li kienu jużaw qabel.

Ikseb aċċess bikri

Ingħaqad mal-lista ta’ stennija u nikkuntattjawk hekk kif it-tim tiegħek ikun jista’ jibda.