Taisce GitHub Actions · déantúsáin · Turborepo

Do thaisce CI, i do chuntas Cloudflare féin

Téann actions/cache agus upload-artifact caighdeánacha trí CacheFlow gan athrú ar bith ar do shreafaí oibre, agus Turborepo le céim socraithe amháin. Cuir beartas tomhaltóirí iontaofa leis, agus ní aischuirfidh do jabanna scaoilte ach an rud a tháirg tógáil iontaofa.

Taisce is leatsa, a bhfuil muinín agat aisti agus a bhfeiceann tú isteach inti

Úinéireacht

Do chuntas, do bhearta

Ritheann CacheFlow ar do chuntas Cloudflare, mar sin ní bhíonn bearta taisce ná déantúsán riamh ag tríú páirtí agus feictear na hacmhainní ar do bhille Cloudflare féin.

  • Bearta déantúsán in R2, gan táillí egress
  • Úinéireacht eochracha in D1, cosán tapa léite in KV, seisiúin ar siúl in Durable Objects
  • Freastalaíonn imscaradh amháin ar thaisce Actions, ar dhéantúsáin Actions agus ar chiantaisce Turborepo

Muinín

Ná haischuir ach an rud a shábháil tógáil iontaofa

Taifeadann iontrálacha a shábháiltear le comhartha GitHub OIDC, mar a dhéanann gníomhartha CacheFlow, an teagmhas, an ref, an commit agus an sreabhadh oibre taobh thiar díobh. Cuir beartas tomhaltóirí iontaofa leis, agus ní aischuirfidh do jabanna scaoilte ach iontrálacha a shábháil push, rith sceidealaithe nó rith láimhe ar do bhrainse cosanta.

  • Dintiúir ghearrshaolacha amháin: GitHub OIDC do ghníomhartha CacheFlow, comhartha runtime GitHub féin do jabanna le gníomhartha caighdeánacha
  • Ní scríobhann gach brainse ach ina raon féin, agus léann sé trína bhonnbhrainse agus tríd an mbrainse réamhshocraithe
  • Ar jabanna OIDC, cuirtear i gcoraintín sábhálacha ar bhrainse cosanta ó theagmhais ar féidir le daoine seachtracha iad a spreagadh, amhail pull_request_target; leanann jabanna le gníomhartha caighdeánacha deontas taisce GitHub féin

Léargas

Bíodh a fhios agat cén ráta aimsithe atá agat

Taifeadtar gach aischur, gach teip aimsithe agus gach sábháil i dtaisce agus i ndéantúsáin Actions mar aon lena mbearta, chomh maith le híoslódálacha agus uaslódálacha Turborepo, lena n-áirítear ar mheaitseáil aischur a eochair bheacht nó ar thit sé siar ar réimír.

  • Ní thaifeadtar eochracha thaisce Actions ná ainmneacha déantúsán ach mar haisc eochraithe, riamh mar a scríobhadh iad
  • Maolánaíonn seisiúin scríobhanna ó jabanna maitríse comhthreomhara agus tiomnaíonn siad go hadamhach iad
  • Glantar seisiúin thréigthe nuair a chríochnaíonn tógálacha nó nuair a théann siad thar am

Tosaigh san áit a bhfuil tú cheana

Ceithre bhealach isteach, ó ghan athrú ar bith go smacht iomlán. Tosaíonn formhór na bhfoirne leis an gcéad cheann agus ní chuireann siad sreabhadh oibre in eagar riamh.

  1. Gan athruithe

    Coinnigh na sreafaí oibre atá agat

    Dírigh do runners ar CacheFlow uair amháin. Ansin déanann actions/cache, setup-node, Swatinem/rust-cache agus upload-artifact caighdeánacha taisceadh tríd, gan athrú ar bith. Ar runners arna n-óstáil ag GitHub, filleann an sreabhadh oibre céanna ar thaisce 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. Céim amháin

    Ná hatóg arís an rud atá tógtha ag Turborepo cheana

    Cuir setup-cacheflow leis, agus athsheinneann gach tasc nár athraigh a ionchuir a aschuir in ionad rith arís, thar jabanna, bhrainsí agus stórtha.

    Féach an sreabhadh oibre iomlán ↓
  3. Do scaoileadh

    Ná seol ach an rud a tháirg tógáil iontaofa

    Sábháil taisceanna scaoilte agus imscartha trí ghníomhartha CacheFlow. Taifeadann gach iontráil an teagmhas, an ref, an commit agus an sreabhadh oibre taobh thiar di. Cuir beartas tomhaltóirí iontaofa leis, agus ní aischuirfidh do jabanna scaoilte ach iontrálacha a shábháil push, rith sceidealaithe nó rith láimhe ar do bhrainse cosanta.

    # 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. Aon uirlis

    Taisc rud ar bith ón líne ordaithe

    Stórálann agus aischuireann an cacheflow CLI agus an Python SDK aon déantúsán ó aon uirlis tógála. Maolánaíonn seisiúin scríobhanna ó jabanna maitríse comhthreomhara agus tiomnaíonn siad go hadamhach iad, ionas nach scríobhann jab amháin thar jab eile.

    # 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

Ciantaisce Turborepo i gcéim amháin

Cruthaíonn setup-cacheflow dintiúr OIDC gearrshaolach agus easpórtálann sé TURBO_API, TURBO_TOKEN agus TURBO_TEAM. Gan rúin stóráilte:

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

Na ceisteanna a chuireann foirne ar dtús

An gá dúinn ár sreafaí oibre a athrú?
Ní gá, i gcás thaisce agus dhéantúsáin Actions. Dírigh timpeallacht do runners ar CacheFlow uair amháin, agus úsáideann actions/cache, setup-node, Swatinem/rust-cache agus upload-artifact caighdeánacha é gan athrú. Ar runners arna n-óstáil ag GitHub, leanann na sreafaí oibre céanna d’úsáid thaisce GitHub. Teastaíonn céim setup-cacheflow amháin in aghaidh an tsreafa oibre do chiantaisce Turborepo.
Cá gcoimeádtar ár sonraí?
I do chuntas Cloudflare: bearta in R2, úinéireacht eochracha in D1, cosán léite in KV agus seisiúin ar siúl in Durable Objects. Ní thaifeadann an teiliméadracht eochracha thaisce Actions ná ainmneacha déantúsán ach mar haisc eochraithe. Tá plean bainistithe á phleanáil againn freisin, a reáchtálfaidh CacheFlow duit.
Cén costas atá air?
Gearrtar na hacmhainní Cloudflare a úsáideann CacheFlow ar do chuntas Cloudflare féin, agus ní ghearrann R2 aon táillí egress. Roinnfimid praghsáil CacheFlow féin le foirne a bhfuil luathrochtain acu.
An bhfuil sé níos tapúla ná taisce GitHub?
Ní mhaímid tada faoi luas. Tagann na bearta ó Cloudflare R2 thar an idirlíon, agus níor thomhaiseamar aon bhuntáiste i luas aischurtha. Má theastaíonn taisce in aice leis an runner uait, b’fhéidir go n-oirfeadh taisce soláthraí runners níos fearr duit.
Conas a fhíordheimhníonn na jabanna?
Malartaíonn jabanna a úsáideann gníomhartha CacheFlow nó setup-cacheflow comhartha GitHub OIDC gearrshaolach. Úsáideann jabanna le gníomhartha caighdeánacha an comhartha runtime a thugann GitHub do gach jab cheana. Ar aon chuma, ní stóráiltear aon rún fadsaolach i do phíblínte. Úsáideann córais CI eile agus ríomhairí glúine forbróirí comhartha a eisíonn d’oibreoir.
An féidir linn filleadh ar an rud a bhí againn?
Is féidir. Labhraíonn CacheFlow na prótacail a úsáideann d’uirlisí cheana: seirbhísí taisce agus déantúsán Actions agus ciantaisce Turborepo. Bain an socrú runner nó an chéim setup-cacheflow, agus filleann do shreafaí oibre ar an taisce a d’úsáid siad roimhe.

Faigh luathrochtain

Cláraigh ar an liosta feithimh agus rachaimid i dteagmháil leat a luaithe is féidir le d’fhoireann tosú.