# Percepatkan monorepo pnpm dan Turborepo dalam GitHub Actions (astro: 528 s kepada 30 s)

> Dalam monorepo pnpm dan Turborepo di GitHub Actions, kebanyakan masa ialah pnpm install pada VM baharu dan turbo menjalankan tugas yang hasilnya tiada padanya. Jalankan hanya pakej yang terjejas, berikan turbo cache, dan kekalkan stor pnpm. Atau jalankan pada mesin yang mengekalkan kedua-duanya: CI astro turun daripada 528 s di GitHub kepada 30 s di Skipbox, pada harga tetap $39 sebulan.

Dalam monorepo pnpm dan Turborepo di GitHub Actions, kebanyakan masa job yang perlahan ialah dua step: `pnpm install` pada VM baharu, dan `turbo run build test` menjalankan tugas yang hasilnya tiada pada VM itu. Betulkan mengikut urutan ini. Jalankan hanya pakej yang disentuh oleh perubahan (`turbo run build --affected`, dengan checkout yang mempunyai sejarah). Berikan turbo cache yang bertahan lebih lama daripada job, kerana hasilnya berada dalam `.turbo/cache` pada mesin yang dipadam GitHub selepas setiap job: Remote Caching, atau `.turbo` yang dipulihkan dengan `actions/cache`. Dan kekalkan stor pnpm. Pada runner GitHub setiap cache itu ialah muat turun pada setiap job. Pada mesin yang mengekalkan cakeranya ia memang sudah ada: job CI astro mengambil masa 528 s di GitHub dan 30 s pada mesin khusus Skipbox, yang memainkan semula kesemua 40 tugas build daripada cache turbo yang dikekalkan.

Skipbox menjalankan job anda pada mesin khusus akaun anda, yang mengekalkan stor pnpm, alat dan `.turbo` dalam checkout antara job, tanpa remote cache dan tanpa cache key. Tukar satu baris, `runs-on: skipbox`, pada harga tetap $39 sebulan dengan minit tanpa had.

- CI astro: 528 s di GitHub, 30 s di Skipbox, dengan turbo memainkan semula 40 tugas build dan tugas ujian
- Stor pnpm dan `.turbo` turbo kekal pada mesin anda: tiada remote cache untuk disediakan, tiada arkib untuk dimuat turun
- 20,000 minit sebulan pada 4 vCPU: $222 di GitHub, $39 di Skipbox

**GitHub Actions pada harga tetap, minit tanpa had** Skipbox menjalankan job GitHub Actions anda pada mesin khusus anda sendiri: $39 sebulan, berapa minit pun anda jalankan. Lapisan Docker dan cache dependency kekal antara job, jadi job seterusnya bermula serta-merta.

Runner 4 vCPU, 20,000 minit sebulan: GitHub $222 → Skipbox $39. Anda jimat $183 setiap bulan.

Beralih hanya memerlukan satu baris: `runs-on: skipbox`.

[Mulakan percubaan percuma 7 hari saya](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-ms)

## Di mana job monorepo menghabiskan masanya

| Step | Pada VM GitHub yang baharu |
|---|---|
| Checkout | Clone cetek secara lalai; `--affected` memerlukan sejarah, jadi clone penuh |
| Sediakan Node dan pnpm | Dimuat turun, melainkan cache alat mempunyai versi itu |
| `pnpm install` | Stor dipulihkan daripada arkib cache (atau dimuat turun daripada registry), kemudian `node_modules` dipaut untuk setiap pakej |
| `turbo run build` | Setiap tugas berjalan, melainkan `.turbo/cache` dipulihkan atau remote cache menjawab |
| `turbo run test` | Sama, pada 2 CPU pada `ubuntu-latest` repositori peribadi |

## 1. Jalankan hanya apa yang berubah

Daripada [panduan CI Turborepo](https://turborepo.dev/docs/crafting-your-repository/constructing-ci): `turbo run build --affected` menjalankan tugas hanya dalam pakej yang berubah berbanding cabang asas. Dalam GitHub Actions ia membaca `GITHUB_BASE_REF` pada pull request dan `GITHUB_EVENT_PATH` pada push. Dengan clone cetek setiap pakej dikira sebagai berubah, jadi checkout sejarahnya:

```yaml
- uses: actions/checkout@v4
  with:
    fetch-depth: 0
    filter: blob:none
```

`turbo query affected --packages web` memberitahu job sama ada perlu berjalan langsung, jadi job untuk app yang tidak disentuh boleh melangkau install-nya.

## 2. Berikan turbo cache yang bertahan lebih lama daripada job

Turborepo menyimpan hasil tugas dalam `.turbo/cache` [pada mesin](https://turborepo.dev/docs/crafting-your-repository/caching). Mesin job yang dihoskan GitHub dipadam apabila ia tamat, jadi dalam CI cache itu bermula kosong setiap kali. Dua cara mengatasinya, daripada [panduan GitHub Actions Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions):

- **Remote Caching.** Tetapkan `TURBO_TOKEN` dan `TURBO_TEAM` (Vercel Remote Cache, atau pelayan self-hosted). Setiap hit ialah muat turun daripadanya.
- **`actions/cache` pada `.turbo`.** Gunakan key `${{ runner.os }}-turbo-${{ github.sha }}` dengan `restore-keys: ${{ runner.os }}-turbo-`. Ia menyimpan entri baharu pada setiap larian, di dalam 10 GB GitHub bagi setiap repositori bersama semua yang lain dalam cache repositori.

## 3. Kekalkan stor pnpm

`actions/setup-node` dengan `cache: pnpm`, atau `actions/cache` pada `pnpm store path`, memulihkan stor dengan key berdasarkan `pnpm-lock.yaml`. Ia tidak memulihkan `node_modules`, jadi pnpm masih memaut setiap pakej. [Dokumentasi CI pnpm](https://pnpm.io/continuous-integration) menyatakannya dengan jelas: menyimpan stor dalam cache "is not guaranteed" menjadikan pemasangan lebih pantas. Dalam CI pnpm beralih ke `--frozen-lockfile` dengan sendirinya.

## 4. Gunakan teras

turbo menjalankan tugas yang bebas secara selari dan setiap alat build atau ujian memulakan worker-nya sendiri, jadi monorepo menggunakan setiap teras yang diberikan. `ubuntu-latest` repositori peribadi mempunyai 2.

## Kos setiap pembetulan pada runner GitHub

- **Remote Caching** ialah satu lagi perkhidmatan dan satu lagi token, dan setiap hit cache merentasi rangkaian.
- **`actions/cache` untuk `.turbo`** menulis entri pada setiap larian dan bersaing untuk 10 GB yang sama dengan stor pnpm, lapisan Docker dan cache setiap cabang; entri yang tidak digunakan selama 7 hari dibuang.
- **Runner yang lebih besar** ialah larger runner pada GitHub Team atau Enterprise Cloud, dicaj ikut minit.

## Apabila penyelesaiannya ialah mesin yang mengekalkan cakeranya

CI astro sendiri, workflow-nya tanpa perubahan, daripada [larian kami pada projek sebenar](https://skipbox.dev/ms/guides/rust-cache-slow-rust-ci):

| | GitHub (repositori awam, 4 vCPU, 16 GB) | Mesin khusus Skipbox (4 vCPU) |
|---|---|---|
| Job | 528 s | **30 s** ([31 s](https://github.com/skipbox-dev/astro/actions/runs/43351547473), [28 s](https://github.com/skipbox-dev/astro/actions/runs/43351638436)) |
| Tugas build | 40 dijalankan | 40 dimainkan semula daripada cache turbo |
| Tugas ujian | dijalankan | dimainkan semula daripada cache turbo |

Mesin khusus mengekalkan `.turbo` dalam checkout dan stor pnpm daripada job sebelumnya, jadi turbo menemui hasil setiap tugas tanpa apa-apa untuk dimuat turun. turbo hanya memainkan semula tugas apabila hash inputnya sama, jadi commit sebenar menjalankan semula pakej yang disentuhnya dan memainkan semula selebihnya.

## Skipbox mengekalkan keadaan monorepo

Setiap pelan disertakan dengan mesin khusus akaun anda, dikekalkan antara job:

- **Stor pnpm kekal** dalam `~/.local/share/pnpm/store`, bersama cache npm dan `~/.cache` setiap alat. `pnpm install` memaut daripada cakera dan bukannya memuat turun.
- **Cache turbo kekal.** `.turbo` di peringkat atas checkout dikekalkan antara job apabila `turbo.json` ialah turbo 2: key `tasks`, tiada `pipeline`, dan tiada `"envMode": "loose"`. Tiada `TURBO_TOKEN`, tiada step cache.
- **`node_modules` dipadam selepas setiap job**, jadi matrix versi Node yang berkongsi satu checkout tidak pernah memuatkan addon natif yang dibina untuk Node lain.
- **Alat kekal:** versi Node yang dipasang `setup-node`, pnpm itu sendiri, imej dan lapisan Docker.

Sekurang-kurangnya 7× ruang cache GitHub pada S. Job memilih saiznya melalui label:

| Label | Mesin | Pelan |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, $39 sebulan |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, $79 sebulan |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, $149 sebulan |

Minit tanpa had. Pada 20,000 minit sebulan pada 4 vCPU, GitHub mengecaj $222; Skipbox S ialah $39, $183 lebih murah.

## Beralih hanya satu baris

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          filter: blob:none
      - uses: pnpm/action-setup@v3
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: pnpm
      - run: pnpm install
      - run: pnpm turbo run build test --affected
```

1. Log masuk ke Skipbox dengan GitHub.
2. Pasang GitHub App Skipbox dan pilih repositori.
3. Tukar `runs-on` dan push.

Kekalkan step cache seperti sedia ada; apa yang disimpannya kekal bersebelahan dengan mesin.

## Keselamatan

- Mesin itu milik akaun anda seorang. Tiada job syarikat lain berjalan padanya.
- Selepas setiap job, bukti kelayakan, proses dan container runner dipadam, begitu juga bukti kelayakan git, hook dan fail tidak dijejak dalam checkout yang dikekalkan. “VM baharu bagi setiap job” memberi setiap job mesin baharu sebaliknya.
- Kod daripada orang tanpa akses tulis (seperti pull request daripada fork) berjalan pada VM baharu yang membaca cache anda tetapi tidak boleh mengubahnya.

Butirannya dalam [cara job diasingkan](https://docs.skipbox.dev/ms/isolation).

## Cuba pada monorepo

Percubaan adalah percuma selama 7 hari atau 3,000 minit job, yang mana dahulu, dan tidak memerlukan kad. Pindahkan job build ke `runs-on: skipbox`, jalankan dua kali, dan letakkan baris install dan turbo larian kedua (`cached` berbanding `executing`) bersebelahan dengan GitHub.

## Soalan lazim

### Bagaimanakah cara mempercepat monorepo pnpm/Turborepo yang besar dalam GitHub Actions?

Tiga perkara, mengikut urutan. Jalankan hanya apa yang berubah: turbo run build --affected, dengan checkout yang mempunyai sejarah (fetch-depth: 0 dan filter: blob:none). Berikan turbo cache yang bertahan selepas job: Remote Cache Turborepo, atau .turbo yang dipulihkan dengan actions/cache. Dan kekalkan stor pnpm: cache: pnpm setup-node atau actions/cache pada laluan stor. Pada VM baharu GitHub setiap satu itu ialah muat turun pada setiap job; pada mesin yang mengekalkan cakeranya ia sudah ada. CI astro mengambil masa 528 s di GitHub dan 30 s pada mesin khusus Skipbox yang mengekalkan cache turbo dan stor pnpm.

### Kenapa pnpm install perlahan dalam GitHub Actions walaupun stor disimpan dalam cache?

Kerana stor yang dipulihkan masih merupakan arkib yang dimuat turun dan dibuka pada VM baharu, dan pnpm kemudian memaut node_modules untuk setiap pakej dalam workspace. Dokumentasi CI pnpm sendiri menyatakan menyimpan stor dalam cache tidak dijamin menjadikan pemasangan lebih pantas. Stor yang sudah ada pada cakera mesin melangkau muat turun; hanya pemautan yang tinggal.

### Adakah cache Turborepo berfungsi dalam GitHub Actions?

Hanya jika cache bertahan lebih lama daripada job. Turborepo menyimpan hasil tugas dalam .turbo/cache pada mesin, dan mesin job yang dihoskan GitHub hilang apabila ia tamat. Jadi CI memerlukan Remote Caching (TURBO_TOKEN dan TURBO_TEAM, milik Vercel atau self-hosted) atau step actions/cache untuk .turbo. Pada mesin khusus Skipbox, .turbo dalam checkout kekal antara job bagi projek turbo 2, jadi turbo memainkan semula tugas yang tidak berubah tanpa remote cache.

### Adakah turbo --affected berfungsi dalam GitHub Actions?

Ya. Turborepo membaca GITHUB_BASE_REF pada pull request, dan GITHUB_EVENT_PATH pada push, untuk mencari asas perbandingan. Ia memerlukan sejarah: dengan clone cetek setiap pakej dikira sebagai berubah. Tetapkan fetch-depth: 0 dan filter: blob:none pada actions/checkout.

### Apakah yang dikekalkan Skipbox untuk monorepo Turborepo?

Stor pnpm, cache npm dan setiap alat, alat yang dipasang setup-node, lapisan Docker, dan checkout bersama .turbo di peringkat atas apabila turbo.json ialah turbo 2 (key tasks, tiada pipeline, bukan envMode loose). node_modules dipadam selepas setiap job, jadi install berjalan, daripada stor pada cakera. turbo hanya memainkan semula tugas apabila hash inputnya sama, jadi commit menjalankan semula apa yang disentuhnya.

### Berapakah kos untuk mencuba?

Tiada. Percubaan ialah 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad. Pindahkan job build monorepo ke runs-on: skipbox, jalankan dua kali, dan bandingkan step install dan turbo larian kedua dengan GitHub.

Dikemas kini 2026-11-19 · https://skipbox.dev/ms/guides/pnpm-turborepo-monorepo-github-actions
