# GitHub Actions’ta Next.js derlemesi yavaş ya da belleği yetmiyor: önbellek, bellek, runner boyutu

> GitHub Actions’ta bir Next.js derlemesi, .next/cache bir sonraki çalıştırmaya taşınmadığında yavaştır; webpack, tür kontrolü ve source map’ler toplandığında da özel bir deponun 8 GB’lık ubuntu-latest runner’ında belleği yetmez. Neyi önbelleğe almalı, hangi Next.js ayarları belleği düşürür ve runner boyutu: Skipbox’ta ayda $79 karşılığında 16 GB ya da $149 karşılığında 32 GB; .next/cache işler arasında kalır, dakikalar sınırsızdır.

GitHub Actions’ta bir Next.js derlemesi bir nedenle yavaştır, başka bir nedenle belleği yetmez. `.next/cache` bir sonraki çalıştırmaya taşınmadığında yavaştır: Next.js bu önbelleği derlemeler arasında yeniden kullanır, GitHub’ın barındırdığı bir iş yeni bir VM’de başlar ve bir önbellek adımı olmadan her derleme soğuktur (log `No Cache Detected` der). Belleği yetmez, çünkü özel bir deponun `ubuntu-latest` runner’ında 8 GB vardır ve büyük bir uygulamanın webpack derlemesi, tür kontrolü ve source map’leri bunu aşabilir. İlkini `.next/cache` üzerinde `actions/cache` ile düzeltin. İkincisi için önce Next.js’in bellek ayarları gelir (`experimental.webpackMemoryOptimizations`, production source map’i yok); sonra daha fazla belleği olan bir makine: 16 GB ya da 32 GB.

Skipbox derlemeye bu belleği sabit fiyata verir: `runs-on: skipbox-8x16` ile ayda $79 karşılığında 16 GB ve 8 vCPU, `skipbox-16x32` ile $149 karşılığında 32 GB ve 16 vCPU. Size ayrılmış makinede `.next/cache` sonraki derleme için kalır, paket önbellekleri diskte kalır ve `actions/cache`’in kaydettiği yerel olarak okunur, sınırsız dakikayla.

- `.next/cache` size ayrılmış makinede kalır: sonraki derleme, önbellek adımı olmadan son derlemesini yeniden kullanır
- Ayda $79 karşılığında 16 GB ya da $149 karşılığında 32 GB; özel bir `ubuntu-latest` runner’ında 8 GB’a karşı
- Paket önbellekleri makinenizde kalır ve önbellek geri yüklemeleri indirmek yerine onun diskini okur

**Sabit fiyatla GitHub Actions, sınırsız dakika** Skipbox, GitHub Actions işlerinizi size ayrılmış kendi makinenizde çalıştırır: kaç dakika çalıştırırsanız çalıştırın ayda $39. Docker katmanları ve bağımlılık önbellekleri işler arasında kalır, böylece sonraki iş hemen başlar.

4 vCPU’luk bir runner, ayda 20.000 dakika: GitHub $222 → Skipbox $39. Her ay $183 tasarruf edersiniz.

Geçiş tek satır: `runs-on: skipbox`.

[7 günlük ücretsiz denememi başlat](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-tr)

## Yavaş: .next/cache boş başlar

Next.js’in [CI derleme önbelleği rehberine](https://nextjs.org/docs/app/guides/ci-build-caching) göre Next.js, derlemeler arasında paylaşılan bir önbelleği `.next/cache` içine kaydeder ve onu derlemeler arasında korumayan bir CI `No Cache Detected` hatası gösterir. GitHub Actions adımı:

```yaml
- uses: actions/cache@v4
  with:
    path: |
      ~/.npm
      ${{ github.workspace }}/.next/cache
    key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
    restore-keys: |
      ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
```

Anahtar her kaynak değişikliğinde değişir; bu yüzden her çalıştırma depo başına GitHub’ın 10 GB’ı içinde yeni bir girdi kaydeder. Bir Turborepo’da, [Turborepo’nun GitHub Actions rehberinde](https://turborepo.dev/docs/guides/ci-vendors/github-actions) olduğu gibi `.next/cache`’i görevin `outputs` listesinden hariç tutun (`"!.next/cache/**"`).

## Bellek yetersiz: iki farklı hata

| Log’da | Biten şey | Ne yapmalı |
|---|---|---|
| `JavaScript heap out of memory` | Node’un kendi heap sınırı; makinede hâlâ bellek vardı | Yükseltin: makinenin belleğinin altında kalacak şekilde `NODE_OPTIONS=--max-old-space-size=6144` |
| `Process completed with exit code 137` | Makinenin belleği: Linux süreci sonlandırdı | Daha az bellek kullanın ya da daha fazlası olan bir makine |

Heap’i makinenin belleğinin ötesine yükseltmek ilk hatayı ikincisine çevirir.

## Daha az bellek kullanın: Next.js’in kendi ayarları

Next.js’in [bellek kullanımı rehberinden](https://nextjs.org/docs/app/guides/memory-usage):

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 ve sonrası), biraz daha uzun bir derleme pahasına webpack’in zirve belleğini düşürür.
- **Webpack build worker’ı** derlemeyi ayrı bir Node worker’ında çalıştırır; bu da belleği düşürür. Özel bir webpack yapılandırmanız yoksa v14.1.0’dan beri varsayılan olarak açıktır; varsa `experimental.webpackBuildWorker: true` ayarlayın.
- **Source map’ler kapalı:** `productionBrowserSourceMaps: false` ve `experimental.serverSourceMaps: false`. Derlemenin belleği "Generating static pages" sırasında bitiyorsa `enablePrerenderSourceMaps: false` da.
- **Ölçün:** `next build --experimental-debug-memory-usage` (v14.2.0 ve sonrası) derleme boyunca heap kullanımını yazdırır ve sınıra yakın heap anlık görüntüleri alır.
- **Tür kontrolü:** `typescript.ignoreBuildErrors: true` tür kontrolünü ve onun belleğini atlar, tür hatalarının da derlemeye girmesine izin verir. Next.js, başka bir adım tür kontrolü yapmıyorsa buna karşı uyarır.

## Daha fazla belleği olan bir makine kullanın

| Runner | CPU ve bellek | Kimler kullanabilir |
|---|---|---|
| GitHub `ubuntu-latest`, özel depo | 2 CPU, 8 GB | Herkes |
| GitHub `ubuntu-latest`, herkese açık depo | 4 CPU, 16 GB | Herkese açık depolar |
| GitHub’ın daha büyük runner’ı, 4 ya da 8 çekirdek | 16 GB ya da 32 GB | GitHub Team ve Enterprise Cloud kuruluşları, dakika başına ([daha büyük runner’lar](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | Kuruluşlar ve kişisel hesaplar, ayda $79 |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | Kuruluşlar ve kişisel hesaplar, ayda $149 |

Ayda 20.000 dakikada GitHub’ın 8 çekirdekli runner’ı $422, Skipbox M ise $79 tutar; 16 çekirdekte $822, L için $149. GitHub tutarları, GitHub Team’e dahil kullanım düşüldükten sonradır.

## Skipbox’ın bir Next.js derlemesi için yaptıkları

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

- **Derlemenin ihtiyaç duyduğu bellek,** etiketle: M’de 16 GB, L’de 32 GB. Heap’i buna göre ayarlayın, örneğin M’de `--max-old-space-size=12288`.
- **Paket önbellekleri diskte kalır:** `~/.npm`, pnpm deposu, her aracın `~/.cache` dizini ve `setup-node`’un kurduğu Node sürümleri. `npm ci` kayıt deposu yerine onları okur.
- **`.next/cache` sonraki iş için kalır.** Makine checkout’unuzu işler arasında tutar; içindeki `.next/cache`’i de bir monorepoda ne kadar derinde olursa olsun (`apps/web/.next/cache`) tutar. Sonraki `next build` oradan başlar; önbellek adımı gerekmez, `No Cache Detected` da çıkmaz. `.next`’in geri kalanı ve checkout’un diğer izlenmeyen dosyaları her işten sonra temizlenir.
- **`actions/cache` geri yüklemeleri makineyi okur.** Kaydettikleri, GitHub’ın depo başına 10 GB’ından daha fazla alanla makinenin yanında kalır ve geri yükleme yerel bir okumadır. `.next/cache` adımını yeni bir VM’de çalışan işler için koruyabilirsiniz; size ayrılmış makinede geri yükleme tutulan önbelleğe dokunmaz.
- **Sabit fiyata daha fazla çekirdek.** Derleme ve statik sayfa üretimi onları kullanır ve dakikalar sınırsızdır.

| Etiket | Makine | Plan |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, ayda $39 |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, ayda $79 |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, ayda $149 |

## Geçiş tek satır

```yaml
jobs:
  build:
    runs-on: skipbox-8x16 # was ubuntu-latest
    env:
      NODE_OPTIONS: --max-old-space-size=12288
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - uses: actions/cache@v4
        with:
          path: ${{ github.workspace }}/.next/cache
          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
          restore-keys: |
            ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
      - run: npm ci
      - run: npx next build
```

`skipbox-8x16` bir M planında çalışır; deneme `runs-on: skipbox` çalıştırır.

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.

## 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 ve `.next/cache` gibi derleme önbellekleri dışındaki 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](https://docs.skipbox.dev/tr/isolation) sayfasında.

## Next.js derlemesinde deneyin

Deneme 7 gün ya da 3.000 iş dakikası boyunca, hangisi önce dolarsa, ücretsizdir ve kart istemez. `runs-on: skipbox` işini 16 GB ile, yani özel bir deponun `ubuntu-latest` runner’ının 2 katı bellekle çalıştırır: önbelleği ve belleği orada deneyin, daha fazlasına ihtiyaç duyan bir derlemeyi L planına (`skipbox-16x32`, 32 GB) taşıyın.

## SSS

### next build GitHub Actions’ta neden yavaş?

Genellikle .next/cache boş başladığı için. Next.js .next/cache içine bir derleme önbelleği kaydeder ve bir sonraki derlemede onu yeniden kullanır, ama GitHub’ın barındırdığı bir iş yeni bir VM’dir; .next/cache’i taşıyan bir adım olmadan her derleme soğuktur ve log No Cache Detected uyarısı verir. Kilit dosyasına ve kaynak dosyalarınıza göre anahtarlanmış, .next/cache için bir actions/cache ekleyin. Sürenin geri kalanı kurulum ve 2 CPU’daki derlemedir.

### Bir Next.js derlemesi GitHub Actions’ta hangi runner boyutunu kullanmalı?

Derlemenin zirvesine yetecek bellek. Özel bir deponun ubuntu-latest runner’ında 2 CPU ve 8 GB vardır ve büyük bir Next.js uygulamasının webpack derlemesi, tür kontrolü ve source map’leri bunu aşabilir. GitHub’ın daha büyük runner’larında 4 çekirdekte 16 GB ve 8’de 32 GB vardır; yalnızca GitHub Team ya da Enterprise Cloud’da, dakika başına. Skipbox runs-on: skipbox-8x16 ile ayda $79 karşılığında 8 vCPU ile 16 GB, skipbox-16x32 ile $149 karşılığında 16 vCPU ile 32 GB verir.

### GitHub Actions’taki bir Next.js derlemesinde JavaScript heap out of memory hatasını nasıl düzeltirim?

Bu hata makinenin belleği değil, Node’un kendi heap sınırıdır. Onu makinenin belleğinin altında kalacak şekilde NODE_OPTIONS=--max-old-space-size=<MiB> ile yükseltin. İş bunun yerine exit code 137 ile biterse makinenin kendisinin belleği bitmiştir: derlemenin belleğini azaltın (experimental.webpackMemoryOptimizations, production source map’i yok) ya da daha fazla belleği olan bir makinede çalıştırın.

### Next.js derleme bellek kullanımını nasıl azaltırım?

Next.js’in bellek rehberinden: experimental.webpackMemoryOptimizations’ı deneyin (v15 ve sonrası), webpack build worker’ını açık tutun (v14.1.0’dan beri özel bir webpack yapılandırması yoksa varsayılan), productionBrowserSourceMaps ve experimental.serverSourceMaps’i kapatın ve next build --experimental-debug-memory-usage ile ölçün. typescript.ignoreBuildErrors ile tür kontrolünü atlamak bellek kazandırır ama tür hatalarının geçmesine izin verir; bunu yalnızca başka bir CI işi tür kontrolü yapıyorsa yapın.

### Skipbox .next/cache’i işler arasında tutar mı?

Evet. Size ayrılmış makine checkout’u işler arasında tutar; içindeki .next/cache’i de Next.js onu nereye koyduysa orada (bir monorepoda apps/web/.next/cache) tutar. Böylece sonraki next build, önbellek adımı olmadan bir öncekinin önbelleğinden başlar. .next’in geri kalanı ve checkout’un diğer izlenmeyen dosyaları her işten sonra temizlenir. npm’in ya da pnpm’in önbelleği, setup-node’un kurduğu Node sürümleri ve Docker katmanları da diskte kalır. .next/cache için bir actions/cache adımı kalabilir: Bir fork’tan gelen pull request gibi yeni bir VM’de çalışan iş ondan geri yükler, size ayrılmış makinede ise geri yükleme tutulan önbelleğe dokunmaz.

### Denemenin maliyeti nedir?

Hiçbir şey. Deneme 7 gün ya da 3.000 iş dakikası sürer, hangisi önce dolarsa, kart istemez ve 4 vCPU ve 16 GB üzerinde çalışır: özel bir depodaki ubuntu-latest’in 8 GB’ının 2 katı ve GitHub’ın 4 çekirdekli daha büyük runner’ıyla aynı. Önbelleği ve belleği orada deneyin; daha fazlasına ihtiyaç duyan bir derleme için L planını seçin ve etiketi skipbox-16x32 (32 GB) yapın.

Güncellendi: 2026-11-19 · https://skipbox.dev/tr/guides/nextjs-build-slow-out-of-memory-github-actions
