Skipbox

GitHub Actions’ta pnpm ve Turborepo monorepo’sunu hızlandırın (astro: 528 sn’den 30 sn’ye)

GitHub Actions’taki bir pnpm ve Turborepo monorepo’sunda yavaş bir işin çoğu iki adımdır: yeni bir VM’de pnpm install ve sonuçları VM’de olmayan görevleri çalıştıran turbo run build test. Onları bu sırayla düzeltin. Yalnızca bir değişikliğin dokunduğu paketleri çalıştırın (geçmişi olan bir checkout ile turbo run build --affected). turbo’ya işten uzun yaşayan bir önbellek verin, çünkü sonuçları GitHub’ın her işten sonra sildiği bir makinedeki .turbo/cache içinde yaşar: Remote Caching ya da actions/cache ile geri yüklenen .turbo. Ve pnpm deposunu tutun. GitHub’ın runner’larında bu önbelleklerin her biri her işte bir indirmedir. Diskini tutan bir makinede ise basitçe oradadırlar: astro’nun CI işi GitHub’da 528 sn, 40 derleme görevinin hepsini turbo’nun tutulan önbelleğinden yeniden oynatan Skipbox’ın size ayrılmış makinesinde 30 sn sürdü.

Skipbox işlerinizi, pnpm deposunu, araçları ve checkout’un .turbo dizinini işler arasında tutan, yalnızca hesabınız için barındırdığı makinede çalıştırır; uzak önbellek ve önbellek anahtarı olmadan. Tek bir satırı, runs-on: skipbox satırını değiştirin; ayda sabit $39 karşılığında sınırsız dakika.

Bir monorepo işi zamanını nerede harcar

1. Yalnızca değişeni çalıştırın

Turborepo’nun CI rehberinden: turbo run build --affected görevleri yalnızca taban dala göre değişen paketlerde çalıştırır. GitHub Actions’ta pull request’lerde GITHUB_BASE_REF’i, push’larda GITHUB_EVENT_PATH’i okur. Sığ bir klonla her paket değişmiş sayılır; bu yüzden geçmişi checkout edin:

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

turbo query affected --packages web bir işe hiç çalışıp çalışmayacağını söyler; böylece dokunulmamış bir uygulamanın işi install’ını atlayabilir.

2. turbo’ya işten uzun yaşayan bir önbellek verin

Turborepo görev sonuçlarını makinede .turbo/cache içinde saklar. GitHub’ın barındırdığı bir işin makinesi iş bittiğinde silinir; bu yüzden CI’da o önbellek her seferinde boş başlar. Turborepo’nun GitHub Actions rehberinden iki çözüm:

  • Remote Caching. TURBO_TOKEN ve TURBO_TEAM ayarlayın (Vercel Remote Cache ya da self-hosted bir sunucu). Her isabet ondan bir indirmedir.
  • .turbo üzerinde actions/cache. restore-keys: ${{ runner.os }}-turbo- ile ${{ runner.os }}-turbo-${{ github.sha }} anahtarını kullanın. Her çalıştırmada, deponun önbelleğe aldığı diğer her şeyle birlikte, depo başına GitHub’ın 10 GB’ı içinde yeni bir girdi kaydeder.

3. pnpm deposunu tutun

cache: pnpm ile actions/setup-node ya da pnpm store path üzerinde actions/cache, depoyu pnpm-lock.yaml’a göre anahtarlayarak geri yükler. node_modules’u geri yüklemez; bu yüzden pnpm yine her paketi bağlar. pnpm’in CI belgeleri bunu açıkça söyler: depoyu önbelleğe almanın kurulumu hızlandıracağının garantisi yoktur. CI’da pnpm kendiliğinden --frozen-lockfile’a geçer.

4. Çekirdekleri kullanın

turbo bağımsız görevleri paralel çalıştırır ve her derleme ya da test aracı kendi worker’larını başlatır; yani bir monorepo aldığı her çekirdeği kullanır. Özel bir deponun ubuntu-latest runner’ında 2 tane vardır.

Her çözümün GitHub’ın runner’larında maliyeti

  • Remote Caching bir hizmet ve bir token daha demektir ve her önbellek isabeti ağı aşar.
  • .turbo için actions/cache her çalıştırmada bir girdi yazar ve pnpm deposu, Docker katmanları ve her dalın önbellekleriyle aynı 10 GB için yarışır; 7 gün kullanılmayan girdiler gider.
  • Daha büyük bir runner, GitHub Team ya da Enterprise Cloud’da dakika başına faturalandırılan daha büyük bir runner demektir.

Çözüm diskini tutan bir makine olduğunda

astro’nun kendi CI’ı, iş akışı değiştirilmeden, gerçek projelerdeki çalıştırmalarımızdan:

Size ayrılmış makine checkout’un .turbo dizinini ve pnpm deposunu son işten tutmuştu; böylece turbo indirilecek hiçbir şey olmadan her görevin sonucunu buldu. turbo bir görevi yalnızca girdilerinin hash’i aynıysa yeniden oynatır; yani gerçek bir commit dokunduğu paketleri yeniden çalıştırır, gerisini yeniden oynatır.

Skipbox monorepo’nun durumunu tutar

Her plan, hesabınıza ayrılmış ve işler arasında kalan bir makineyle gelir:

  • pnpm deposu kalır; ~/.local/share/pnpm/store içinde, npm’in önbelleği ve her aracın ~/.cache diziniyle birlikte. pnpm install indirmek yerine diskten bağlar.
  • turbo’nun önbelleği kalır. turbo.json turbo 2’ninki olduğunda checkout’un üst düzey .turbo dizini işler arasında tutulur: bir tasks anahtarı, pipeline yok ve "envMode": "loose" yok. TURBO_TOKEN yok, önbellek adımı yok.
  • node_modules her işten sonra silinir; böylece tek bir checkout’u paylaşan bir Node sürüm matrisi asla başka bir Node için derlenmiş yerel bir eklentiyi yüklemez.
  • Araçlar kalır: setup-node’un kurduğu Node sürümleri, pnpm’in kendisi, Docker’ın imajları ve katmanları.

S’de GitHub’ın önbellek alanının en az 7 katı. Bir iş boyutunu etiketle seçer:

Dakikalar sınırsızdır. 4 vCPU’da ayda 20.000 dakikada GitHub $222 faturalandırır; Skipbox S ise $39, yani $183 daha az.

Geçiş tek satır

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. GitHub ile Skipbox’a giriş yapın.
  2. Skipbox GitHub App’i yükleyin ve depoları seçin.
  3. runs-on satırını değiştirin ve push edin.

Önbellek adımlarını olduğu gibi bırakın; kaydettikleri makinenin yanında kalır.

Güvenlik

  • Makine yalnızca hesabınıza aittir. Başka hiçbir şirketin işleri onda çalışmaz.
  • Her işten sonra runner’ın kimlik bilgileri, süreçleri ve container’ları silinir; tutulan checkout’taki git kimlik bilgileri, hook’lar ve izlenmeyen dosyalar da. Her iş için temiz VM ayarı bunun yerine her işe yeni bir makine verir.
  • Yazma erişimi olmayan kişilerin kodu (örneğin fork’lardan gelen pull request’ler), önbelleklerinizi okuyan ama değiştiremeyen yeni bir VM’de çalışır.

Ayrıntılar işler nasıl yalıtılır sayfasında.

Monorepo’da deneyin

Deneme 7 gün ya da 3.000 iş dakikası boyunca, hangisi önce dolarsa, ücretsizdir ve kart istemez. Derleme işini runs-on: skipbox satırına taşıyın, iki kez çalıştırın ve ikinci çalıştırmanın install ve turbo satırlarını (cached ve executing) GitHub’dakilerin yanına koyun.

SSS

GitHub Actions’ta büyük bir pnpm/Turborepo monorepo’sunu nasıl hızlandırırım?

Sırasıyla üç şey. Yalnızca değişeni çalıştırın: geçmişi olan bir checkout ile (fetch-depth: 0 ve filter: blob:none) turbo run build --affected. turbo’ya işten sonra da kalan bir önbellek verin: Turborepo’nun Remote Cache’i ya da actions/cache ile geri yüklenen .turbo. Ve pnpm deposunu tutun: setup-node’un cache: pnpm ayarı ya da depo yolu üzerinde actions/cache. GitHub’ın yeni VM’lerinde bunların her biri her işte bir indirmedir; diskini tutan bir makinede zaten oradadırlar. astro’nun CI’ı GitHub’da 528 sn, turbo’nun önbelleğini ve pnpm deposunu tutan Skipbox’ın size ayrılmış makinesinde 30 sn sürdü.

Depo önbelleğe alınmış olsa bile pnpm install GitHub Actions’ta neden yavaş?

Çünkü geri yüklenen bir depo yine de yeni bir VM’e indirilip açılan bir arşivdir ve pnpm ardından çalışma alanının her paketi için node_modules bağlantılarını kurar. pnpm’in kendi CI belgeleri, depoyu önbelleğe almanın kurulumu hızlandıracağının garanti olmadığını söyler. Zaten makinenin diskinde olan bir depo indirmeyi atlar; geriye yalnızca bağlama kalır.

Turborepo önbelleği GitHub Actions’ta çalışır mı?

Yalnızca önbellek işten uzun yaşarsa. Turborepo görev sonuçlarını makinede .turbo/cache içinde tutar ve GitHub’ın barındırdığı bir işin makinesi iş bittiğinde gider. Bu yüzden CI, Remote Caching’e (TURBO_TOKEN ve TURBO_TEAM; Vercel’inki ya da self-hosted bir tane) ya da .turbo için bir actions/cache adımına ihtiyaç duyar. Bir Skipbox’ın size ayrılmış makinesinde checkout’un .turbo dizini turbo 2 projeleri için işler arasında kalır; böylece turbo değişmemiş görevleri uzak önbellek olmadan yeniden oynatır.

turbo --affected GitHub Actions’ta çalışır mı?

Evet. Turborepo karşılaştırılacak tabanı bulmak için pull request’lerde GITHUB_BASE_REF’i, push’larda GITHUB_EVENT_PATH’i okur. Geçmişe ihtiyaç duyar: sığ bir klonla her paket değişmiş sayılır. actions/checkout üzerinde fetch-depth: 0 ve filter: blob:none ayarlayın.

Skipbox bir Turborepo monorepo’su için neleri tutar?

pnpm deposunu, npm’in ve her aracın önbelleklerini, setup-node’un kurduğu araçları, Docker katmanlarını ve turbo.json turbo 2’ninki olduğunda (bir tasks anahtarı, pipeline yok, envMode loose değil) üst düzey .turbo ile birlikte checkout’u. node_modules her işten sonra silinir; bu yüzden install diskteki depodan çalışır. turbo bir görevi yalnızca girdilerinin hash’i aynıysa yeniden oynatır; bir commit dokunduğunu yeniden çalıştırır.

Denemenin maliyeti nedir?

Hiçbir şey. Deneme 7 gün ya da 3.000 iş dakikası sürer, hangisi önce dolarsa, ve kart istemez. Monorepo’nun derleme işini runs-on: skipbox satırına taşıyın, iki kez çalıştırın ve ikinci çalıştırmanın install ve turbo adımlarını GitHub’dakilerle karşılaştırın.

Güncellendi: 19 Kasım 2026

Her zaman hazır önbellekle daha hızlı CI/CD

Sabit fiyatla hazır bekleyen runner’ınız

Biz barındırırız. Siz tek satır değiştirirsiniz. Tam kullanımda maliyet GitHub’ın 1/12 kadarı. Fiyat sabit, yani gün boyu çalıştırın. GitHub’ın 7 katı önbellek alanı.

  • Kart gerekmez
  • GitHub ile giriş
  • İstediğiniz zaman iptal edin