Skipbox

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

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: 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

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.

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.

  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 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

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