# Percepat monorepo pnpm dan Turborepo di GitHub Actions (astro: 528 s menjadi 30 s)

> Di monorepo pnpm dan Turborepo di GitHub Actions, sebagian besar waktu habis untuk pnpm install di VM baru dan turbo yang menjalankan task yang hasilnya tidak ada di VM itu. Jalankan hanya paket yang terdampak, beri turbo cache, dan simpan store pnpm. Atau jalankan di mesin yang menyimpan keduanya: CI astro turun dari 528 detik di GitHub menjadi 30 detik di Skipbox, dengan harga tetap $39 per bulan.

Di monorepo pnpm dan Turborepo di GitHub Actions, sebagian besar job yang lambat adalah dua step: `pnpm install` di VM baru, dan `turbo run build test` yang menjalankan task yang hasilnya tidak dimiliki VM itu. Perbaiki dengan urutan ini. Jalankan hanya paket yang disentuh perubahan (`turbo run build --affected`, dengan checkout yang memiliki riwayat). Beri turbo cache yang bertahan lebih lama dari job, karena hasilnya disimpan di `.turbo/cache` di mesin yang dihapus GitHub setelah setiap job: Remote Caching, atau `.turbo` yang dipulihkan dengan `actions/cache`. Dan simpan store pnpm. Di runner GitHub, setiap cache itu berarti unduhan di setiap job. Di mesin yang menyimpan disknya, semuanya sudah ada: job CI astro memakan 528 detik di GitHub dan 30 detik di mesin khusus untuk Anda di Skipbox, yang memutar ulang seluruh 40 task build dari cache turbo yang tersimpan.

Skipbox menjalankan job Anda di mesin khusus untuk akun Anda, yang menyimpan store pnpm, tool, dan `.turbo` milik checkout di antara job, tanpa remote cache dan tanpa cache key. Ubah satu baris, `runs-on: skipbox`, dengan harga tetap $39 per bulan dan menit tanpa batas.

- CI astro: 528 detik di GitHub, 30 detik di Skipbox, dengan turbo memutar ulang 40 task build dan task test
- Store pnpm dan `.turbo` milik turbo tetap ada di mesin Anda: tanpa remote cache yang perlu disiapkan, tanpa arsip yang perlu diunduh
- 20.000 menit per bulan di 4 vCPU: $222 di GitHub, $39 di Skipbox

**GitHub Actions dengan harga tetap, menit tanpa batas** Skipbox menjalankan job GitHub Actions Anda di mesin khusus milik Anda sendiri: $39 per bulan, berapa pun menit yang Anda jalankan. Layer Docker dan cache dependensi tetap tersimpan di antara job, jadi job berikutnya langsung dimulai.

Runner 4 vCPU, 20.000 menit per bulan: GitHub $222 → Skipbox $39. Anda hemat $183 setiap bulan.

Pindah cukup dengan satu baris: `runs-on: skipbox`.

[Mulai uji coba gratis 7 hari](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-id)

## Ke mana waktu job monorepo habis

| Step | Di VM GitHub yang baru |
|---|---|
| Checkout | Shallow clone secara default; `--affected` butuh riwayat, jadi clone penuh |
| Menyiapkan Node dan pnpm | Diunduh, kecuali tool cache sudah punya versinya |
| `pnpm install` | Store dipulihkan dari arsip cache (atau diunduh dari registry), lalu `node_modules` di-link untuk setiap paket |
| `turbo run build` | Setiap task dijalankan, kecuali `.turbo/cache` dipulihkan atau remote cache menjawab |
| `turbo run test` | Sama, di 2 CPU pada `ubuntu-latest` repositori privat |

## 1. Jalankan hanya yang berubah

Dari [panduan CI Turborepo](https://turborepo.dev/docs/crafting-your-repository/constructing-ci): `turbo run build --affected` menjalankan task hanya di paket yang berubah dibandingkan branch base. Di GitHub Actions, Turborepo membaca `GITHUB_BASE_REF` di pull request dan `GITHUB_EVENT_PATH` di push. Dengan shallow clone setiap paket dianggap berubah, jadi checkout riwayatnya:

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

`turbo query affected --packages web` memberi tahu sebuah job apakah perlu berjalan sama sekali, jadi job untuk aplikasi yang tidak tersentuh bisa melewati instalasinya.

## 2. Beri turbo cache yang bertahan lebih lama dari job

Turborepo menyimpan hasil task di `.turbo/cache` [di mesin](https://turborepo.dev/docs/crafting-your-repository/caching). Mesin job yang dihosting GitHub dihapus saat job berakhir, jadi di CI cache itu dimulai kosong setiap kali. Dua cara mengatasinya, dari [panduan GitHub Actions Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions):

- **Remote Caching.** Atur `TURBO_TOKEN` dan `TURBO_TEAM` (Vercel Remote Cache, atau server yang di-host sendiri). Setiap hit adalah unduhan dari sana.
- **`actions/cache` pada `.turbo`.** Buat key `${{ runner.os }}-turbo-${{ github.sha }}` dengan `restore-keys: ${{ runner.os }}-turbo-`. Cara ini menyimpan entri baru di setiap run, di dalam 10 GB per repositori milik GitHub bersama semua yang di-cache repositori itu.

## 3. Simpan store pnpm

`actions/setup-node` dengan `cache: pnpm`, atau `actions/cache` pada `pnpm store path`, memulihkan store dengan key dari `pnpm-lock.yaml`. Cara ini tidak memulihkan `node_modules`, jadi pnpm tetap me-link setiap paket. [Dokumentasi CI pnpm](https://pnpm.io/continuous-integration) menyatakannya dengan jelas: meng-cache store "is not guaranteed" mempercepat instalasi. Di CI, pnpm beralih ke `--frozen-lockfile` dengan sendirinya.

## 4. Pakai core-nya

turbo menjalankan task independen secara paralel dan setiap tool build atau test memulai worker-nya sendiri, jadi monorepo memakai setiap core yang didapatnya. `ubuntu-latest` di repositori privat punya 2.

## Biaya setiap perbaikan di runner GitHub

- **Remote Caching** berarti satu layanan dan satu token lagi, dan setiap cache hit melewati jaringan.
- **`actions/cache` untuk `.turbo`** menulis entri di setiap run dan berebut 10 GB yang sama dengan store pnpm, layer Docker, dan cache setiap branch; entri yang tidak dipakai selama 7 hari dibuang.
- **Runner yang lebih besar** berarti larger runner di GitHub Team atau Enterprise Cloud, ditagih per menit.

## Saat perbaikannya adalah mesin yang menyimpan disknya

CI milik astro sendiri, dengan workflow tanpa perubahan, dari [run kami pada proyek nyata](https://skipbox.dev/id/guides/rust-cache-slow-rust-ci):

| | GitHub (repositori publik, 4 vCPU, 16 GB) | Mesin khusus untuk Anda di 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)) |
| Task build | 40 dijalankan | 40 diputar ulang dari cache turbo |
| Task test | dijalankan | diputar ulang dari cache turbo |

Mesin khusus untuk Anda menyimpan `.turbo` milik checkout dan store pnpm dari job terakhir, jadi turbo menemukan hasil setiap task tanpa ada yang perlu diunduh. turbo hanya memutar ulang task saat hash input-nya sama, jadi commit sungguhan menjalankan ulang paket yang disentuhnya dan memutar ulang sisanya.

## Skipbox menyimpan state monorepo

Setiap paket datang dengan mesin khusus untuk akun Anda, yang disimpan di antara job:

- **Store pnpm tetap ada** di `~/.local/share/pnpm/store`, bersama cache npm dan `~/.cache` setiap tool. `pnpm install` me-link dari disk alih-alih mengunduh.
- **Cache turbo tetap ada.** `.turbo` tingkat atas milik checkout disimpan di antara job saat `turbo.json` adalah milik turbo 2: ada key `tasks`, tanpa `pipeline`, dan tanpa `"envMode": "loose"`. Tanpa `TURBO_TOKEN`, tanpa step cache.
- **`node_modules` dihapus setelah setiap job**, jadi matrix versi Node yang berbagi satu checkout tidak pernah memuat native addon yang di-build untuk Node lain.
- **Tool-nya tetap ada:** versi Node yang dipasang `setup-node`, pnpm itu sendiri, serta image dan layer Docker.

Ruang cache setidaknya 7× GitHub di paket S. Sebuah job memilih ukurannya lewat label:

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

Menitnya tanpa batas. Untuk 20.000 menit per bulan di 4 vCPU, GitHub menagih $222; Skipbox S $39, $183 lebih murah.

## Pindah cukup 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. Masuk ke Skipbox dengan GitHub.
2. Instal aplikasi GitHub Skipbox dan pilih repositorinya.
3. Ubah `runs-on`, lalu push.

Biarkan step cache seperti apa adanya; apa yang disimpannya tetap berada di samping mesin.

## Keamanan

- Mesinnya hanya milik akun Anda. Tidak ada job perusahaan lain yang berjalan di sana.
- Setelah setiap job, kredensial runner, proses, dan container dihapus, begitu juga kredensial git, hook, dan file yang tidak dilacak di checkout yang disimpan. Bersih setiap job memberi setiap job mesin baru sebagai gantinya.
- Kode dari orang tanpa akses tulis (misalnya pull request dari fork) berjalan di VM baru yang bisa membaca cache Anda tetapi tidak bisa mengubahnya.

Detailnya ada di [cara job diisolasi](https://docs.skipbox.dev/id/isolation).

## Coba di monorepo Anda

Uji cobanya gratis selama 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, dan tanpa kartu. Pindahkan job build ke `runs-on: skipbox`, jalankan dua kali, lalu letakkan baris instalasi dan turbo di run kedua (`cached` dibandingkan `executing`) di samping hasil di GitHub.

## FAQ

### Bagaimana mempercepat monorepo pnpm/Turborepo yang besar di GitHub Actions?

Tiga hal, secara berurutan. Jalankan hanya yang berubah: turbo run build --affected, dengan checkout yang memiliki riwayat (fetch-depth: 0 dan filter: blob:none). Beri turbo cache yang bertahan setelah job: Remote Cache milik Turborepo, atau .turbo yang dipulihkan dengan actions/cache. Dan simpan store pnpm: cache: pnpm milik setup-node atau actions/cache pada path store. Di VM baru milik GitHub, masing-masing itu berarti unduhan di setiap job; di mesin yang menyimpan disknya, semuanya sudah ada. CI astro memakan 528 detik di GitHub dan 30 detik di mesin khusus untuk Anda di Skipbox yang menyimpan cache turbo dan store pnpm.

### Kenapa pnpm install lambat di GitHub Actions meskipun store-nya sudah di-cache?

Karena store yang dipulihkan tetap berupa arsip yang diunduh dan diekstrak di VM baru, lalu pnpm me-link node_modules untuk setiap paket di workspace. Dokumentasi CI pnpm sendiri menyebutkan bahwa meng-cache store tidak dijamin mempercepat instalasi. Store yang sudah ada di disk mesin melewati unduhan; yang tersisa hanya proses link.

### Apakah cache Turborepo bekerja di GitHub Actions?

Hanya jika cache-nya bertahan lebih lama dari job. Turborepo menyimpan hasil task di .turbo/cache di mesin, dan mesin job yang dihosting GitHub hilang saat job berakhir. Jadi CI butuh Remote Caching (TURBO_TOKEN dan TURBO_TEAM, milik Vercel atau yang di-host sendiri) atau step actions/cache untuk .turbo. Di mesin khusus untuk Anda di Skipbox, .turbo di checkout tetap ada di antara job untuk proyek turbo 2, jadi turbo memutar ulang task yang tidak berubah tanpa remote cache.

### Apakah turbo --affected bekerja di GitHub Actions?

Ya. Turborepo membaca GITHUB_BASE_REF di pull request, dan GITHUB_EVENT_PATH di push, untuk menemukan base pembandingnya. Fitur ini butuh riwayat: dengan shallow clone, setiap paket dianggap berubah. Atur fetch-depth: 0 dan filter: blob:none di actions/checkout.

### Apa yang disimpan Skipbox untuk monorepo Turborepo?

Store pnpm, cache npm dan cache setiap tool, tool yang dipasang setup-node, layer Docker, serta checkout beserta .turbo tingkat atasnya saat turbo.json adalah milik turbo 2 (ada key tasks, tanpa pipeline, bukan envMode loose). node_modules dihapus setelah setiap job, jadi instalasi tetap berjalan, dari store di disk. turbo hanya memutar ulang task saat hash input-nya sama, jadi sebuah commit menjalankan ulang apa yang disentuhnya.

### Berapa biaya untuk mencobanya?

Gratis. Uji cobanya 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu. Pindahkan job build monorepo ke runs-on: skipbox, jalankan dua kali, lalu bandingkan step instalasi dan turbo di run kedua dengan di GitHub.

Diperbarui 2026-11-19 · https://skipbox.dev/id/guides/pnpm-turborepo-monorepo-github-actions
