GitHub Actions’ta Next.js derlemesi yavaş ya da belleği yetmiyor: önbellek, bellek, runner boyutu
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.
Yavaş: .next/cache boş başlar
Next.js’in CI derleme önbelleği rehberine 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ı:
- 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 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:
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: trueayarlayın. - Source map’ler kapalı:
productionBrowserSourceMaps: falseveexperimental.serverSourceMaps: false. Derlemenin belleği "Generating static pages" sırasında bitiyorsaenablePrerenderSourceMaps: falseda. - Ö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: truetü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) |
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~/.cachedizini vesetup-node’un kurduğu Node sürümleri.npm cikayıt deposu yerine onları okur. .next/cachesonraki 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. Sonrakinext buildoradan başlar; önbellek adımı gerekmez,No Cache Detectedda çıkmaz..next’in geri kalanı ve checkout’un diğer izlenmeyen dosyaları her işten sonra temizlenir.actions/cachegeri 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/cacheadı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
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.
- GitHub ile Skipbox’a giriş yapın.
- Skipbox GitHub App’i yükleyin ve depoları seçin.
runs-onsatı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/cachegibi 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 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: 19 Kasım 2026