# GitHub Actions में Next.js बिल्ड धीमा या मेमोरी खत्म: कैश, मेमोरी, रनर साइज़

> GitHub Actions में Next.js बिल्ड तब धीमा होता है जब .next/cache अगले रन तक नहीं पहुंचता, और प्राइवेट रिपॉज़िटरी के 8 GB वाले ubuntu-latest पर उसकी मेमोरी तब खत्म होती है जब webpack, टाइप चेक और source maps मिलकर बढ़ जाते हैं। क्या कैश करें, कौन सी Next.js सेटिंग मेमोरी घटाती हैं, और रनर साइज़: Skipbox पर हर महीने $79 में 16 GB या $149 में 32 GB, जहां .next/cache जॉब के बीच बना रहता है और मिनट अनलिमिटेड हैं।

GitHub Actions में Next.js बिल्ड एक वजह से धीमा होता है और दूसरी वजह से उसकी मेमोरी खत्म होती है। धीमा तब होता है जब `.next/cache` अगले रन तक नहीं पहुंचता: Next.js बिल्ड के बीच वह कैश दोबारा इस्तेमाल करता है, GitHub-होस्टेड जॉब नई VM पर शुरू होती है, और कैश स्टेप के बिना हर बिल्ड ठंडा होता है (लॉग में `No Cache Detected` दिखता है)। मेमोरी इसलिए खत्म होती है क्योंकि प्राइवेट रिपॉज़िटरी के `ubuntu-latest` में 8 GB है, और बड़े ऐप का webpack compile, टाइप चेक और source maps उसे पार कर सकते हैं। पहली समस्या `.next/cache` पर `actions/cache` से ठीक करें। दूसरी के लिए पहले Next.js की मेमोरी सेटिंग (`experimental.webpackMemoryOptimizations`, production में source maps नहीं); फिर ज़्यादा मेमोरी वाली मशीन: 16 GB या 32 GB।

Skipbox बिल्ड को वह मेमोरी तय कीमत पर देता है: `runs-on: skipbox-8x16` पर 16 GB और 8 vCPU, हर महीने $79 में, `skipbox-16x32` पर 32 GB और 16 vCPU, $149 में। आपकी डेडिकेटेड मशीन पर `.next/cache` अगले बिल्ड के लिए बना रहता है, पैकेज कैश डिस्क पर रहते हैं, और `actions/cache` जो सेव करता है वह लोकल पढ़ा जाता है, अनलिमिटेड मिनट के साथ।

- `.next/cache` आपकी डेडिकेटेड मशीन पर रहता है: अगला बिल्ड अपना पिछला compile दोबारा इस्तेमाल करता है, बिना कैश स्टेप के
- हर महीने $79 में 16 GB या $149 में 32 GB, जबकि प्राइवेट `ubuntu-latest` पर 8 GB
- पैकेज कैश आपकी मशीन पर रहते हैं, और कैश restore डाउनलोड करने के बजाय उसकी डिस्क पढ़ते हैं

**तय कीमत पर GitHub Actions, अनलिमिटेड मिनट** Skipbox आपकी GitHub Actions जॉब आपकी अपनी डेडिकेटेड मशीन पर चलाता है: हर महीने $39, आप कितने भी मिनट चलाएं। Docker लेयर और डिपेंडेंसी कैश जॉब के बीच बने रहते हैं, इसलिए अगली जॉब तुरंत शुरू होती है।

4 vCPU रनर, हर महीने 20,000 मिनट: GitHub $222 → Skipbox $39. आप हर महीने $183 बचाते हैं.

आने के लिए एक लाइन काफ़ी है: `runs-on: skipbox`।

[7 दिन का मुफ़्त ट्रायल शुरू करें](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-hi)

## धीमा: .next/cache खाली शुरू होता है

Next.js की [CI build caching गाइड](https://nextjs.org/docs/app/guides/ci-build-caching) के अनुसार Next.js `.next/cache` में एक कैश सेव करता है जो बिल्ड के बीच शेयर होता है, और जो CI इसे बिल्ड के बीच नहीं बचाता, वह `No Cache Detected` एरर दिखाता है। उसका GitHub Actions स्टेप:

```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') }}-
```

key हर सोर्स बदलाव के साथ बदलती है, इसलिए हर रन एक नई एंट्री सेव करता है, GitHub के हर रिपॉज़िटरी के 10 GB के अंदर। Turborepo में task के `outputs` से `.next/cache` बाहर रखें (`"!.next/cache/**"`), जैसा [Turborepo की GitHub Actions गाइड](https://turborepo.dev/docs/guides/ci-vendors/github-actions) करती है।

## मेमोरी खत्म: दो अलग एरर

| लॉग में | क्या खत्म हुआ | क्या करें |
|---|---|---|
| `JavaScript heap out of memory` | Node की अपनी heap सीमा; मशीन में मेमोरी अब भी थी | उसे बढ़ाएं: `NODE_OPTIONS=--max-old-space-size=6144`, मशीन की मेमोरी से कम |
| `Process completed with exit code 137` | मशीन की मेमोरी: Linux ने प्रोसेस बंद किया | कम मेमोरी इस्तेमाल करें, या ज़्यादा मेमोरी वाली मशीन |

heap को मशीन की मेमोरी से ऊपर बढ़ाने पर पहली एरर दूसरी में बदल जाती है।

## कम मेमोरी इस्तेमाल करें: Next.js की अपनी सेटिंग

Next.js की [memory usage गाइड](https://nextjs.org/docs/app/guides/memory-usage) से:

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 और बाद में) webpack की पीक मेमोरी घटाता है, थोड़े लंबे compile की कीमत पर।
- **webpack build worker** compile को अलग Node worker में चलाता है, जिससे मेमोरी घटती है। v14.1.0 से यह डिफ़ॉल्ट रूप से चालू है, जब तक आपके पास custom webpack config न हो; उसके साथ `experimental.webpackBuildWorker: true` सेट करें।
- **source maps बंद:** `productionBrowserSourceMaps: false` और `experimental.serverSourceMaps: false`। अगर "Generating static pages" के दौरान मेमोरी खत्म होती है, तो `enablePrerenderSourceMaps: false` भी।
- **मापें:** `next build --experimental-debug-memory-usage` (v14.2.0 और बाद में) पूरे बिल्ड में heap का इस्तेमाल छापता है, और सीमा के पास heap snapshot लेता है।
- **टाइप चेक:** `typescript.ignoreBuildErrors: true` टाइप चेक और उसकी मेमोरी छोड़ देता है, और टाइप एरर बिल्ड में आने देता है। Next.js इसके खिलाफ़ चेतावनी देता है, जब तक कोई दूसरा स्टेप टाइप चेक न करे।

## ज़्यादा मेमोरी वाली मशीन इस्तेमाल करें

| रनर | CPU और मेमोरी | कौन इस्तेमाल कर सकता है |
|---|---|---|
| GitHub `ubuntu-latest`, प्राइवेट रिपॉज़िटरी | 2 CPU, 8 GB | सभी |
| GitHub `ubuntu-latest`, पब्लिक रिपॉज़िटरी | 4 CPU, 16 GB | पब्लिक रिपॉज़िटरी |
| GitHub larger runner, 4 या 8 कोर | 16 GB या 32 GB | GitHub Team और Enterprise Cloud ऑर्गनाइज़ेशन, प्रति मिनट ([larger runners](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox `skipbox-8x16` | 8 vCPU, 16 GB | ऑर्गनाइज़ेशन और पर्सनल अकाउंट, हर महीने $79 |
| Skipbox `skipbox-16x32` | 16 vCPU, 32 GB | ऑर्गनाइज़ेशन और पर्सनल अकाउंट, हर महीने $149 |

हर महीने 20,000 मिनट पर GitHub का 8-कोर रनर $422 है और Skipbox M $79; 16 कोर पर $822, जबकि L $149 का। GitHub के आंकड़े GitHub Team के शामिल इस्तेमाल के बाद के हैं।

## Skipbox Next.js बिल्ड के लिए क्या करता है

हर प्लान के साथ आपके अकाउंट की डेडिकेटेड मशीन आती है, जो जॉब के बीच बनी रहती है:

- **बिल्ड की ज़रूरत की मेमोरी**, लेबल से: M पर 16 GB, L पर 32 GB। heap उसके हिसाब से सेट करें, जैसे M पर `--max-old-space-size=12288`।
- **पैकेज कैश डिस्क पर रहते हैं:** `~/.npm`, pnpm store, हर टूल का `~/.cache`, और `setup-node` के इंस्टॉल किए Node वर्ज़न। `npm ci` रजिस्ट्री के बजाय उन्हें पढ़ता है।
- **`.next/cache` अगली जॉब के लिए बना रहता है।** मशीन जॉब के बीच आपका चेकआउट रखती है, और उसमें `.next/cache` भी, monorepo उसे जितनी भी गहराई पर रखे (`apps/web/.next/cache`)। अगला `next build` उसी से शुरू होता है, बिना कैश स्टेप और बिना `No Cache Detected` के। `.next` का बाकी हिस्सा और चेकआउट की दूसरी untracked फ़ाइलें हर जॉब के बाद साफ़ की जाती हैं।
- **`actions/cache` restore मशीन को पढ़ते हैं।** वह जो सेव करता है, वह मशीन के पास रहता है, GitHub के हर रिपॉज़िटरी के 10 GB से ज़्यादा जगह के साथ, और restore एक लोकल रीड है। नई VM पर चलने वाली जॉब के लिए `.next/cache` स्टेप रखें; आपकी डेडिकेटेड मशीन पर restore रखे गए कैश को जैसा है वैसा छोड़ देता है।
- **तय कीमत पर ज़्यादा कोर।** compile और static पेज बनाना उनका इस्तेमाल करते हैं, और मिनट अनलिमिटेड हैं।

| लेबल | मशीन | प्लान |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S, हर महीने $39 |
| `skipbox-8x16` | 8 vCPU · 16 GB | M, हर महीने $79 |
| `skipbox-16x32` | 16 vCPU · 32 GB | L, हर महीने $149 |

## आना बस एक लाइन का काम है

```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` M प्लान पर चलता है; ट्रायल `runs-on: skipbox` चलाता है।

1. GitHub से Skipbox में साइन इन करें।
2. Skipbox GitHub App इंस्टॉल करें और रिपॉज़िटरी चुनें।
3. `runs-on` बदलें और push करें।

## सुरक्षा

- मशीन सिर्फ़ आपके अकाउंट की है। किसी दूसरी कंपनी की जॉब उस पर नहीं चलतीं।
- हर जॉब के बाद रनर के क्रेडेंशियल, प्रोसेस और कंटेनर मिटा दिए जाते हैं, और रखे गए चेकआउट के git क्रेडेंशियल और `.next/cache` जैसे बिल्ड कैश को छोड़कर उसकी untracked फ़ाइलें भी। “हर जॉब नई VM पर” इसके बजाय हर जॉब को नई मशीन देता है।
- बिना write एक्सेस वाले लोगों का कोड (जैसे फ़ोर्क से आई पुल रिक्वेस्ट) एक नई VM पर चलता है जो आपका कैश पढ़ सकती है पर उसे बदल नहीं सकती।

पूरी जानकारी [जॉब को अलग कैसे रखा जाता है](https://docs.skipbox.dev/hi/isolation) में है।

## Next.js बिल्ड पर आज़माएं

ट्रायल 7 दिन या 3,000 जॉब-मिनट तक मुफ़्त है, जो भी पहले पूरा हो, बिना कार्ड। यह `runs-on: skipbox` चलाता है, 16 GB के साथ, प्राइवेट रिपॉज़िटरी के `ubuntu-latest` से 2× मेमोरी: वहां कैश और मेमोरी आज़माएं, और जिस बिल्ड को ज़्यादा चाहिए उसे L प्लान (`skipbox-16x32`, 32 GB) पर ले जाएं।

## अक्सर पूछे जाने वाले सवाल

### GitHub Actions में next build धीमा क्यों है?

आमतौर पर इसलिए कि .next/cache खाली शुरू होता है। Next.js बिल्ड कैश .next/cache में सेव करता है और अगले बिल्ड में दोबारा इस्तेमाल करता है, पर GitHub-होस्टेड जॉब नई VM है, इसलिए .next/cache को आगे ले जाने वाले स्टेप के बिना हर बिल्ड ठंडा होता है और लॉग No Cache Detected की चेतावनी देता है। lockfile और आपकी सोर्स फ़ाइलों पर key वाला .next/cache के लिए actions/cache जोड़ें। बाकी समय 2 CPU पर इंस्टॉल और compile का है।

### GitHub Actions में Next.js बिल्ड को किस साइज़ का रनर इस्तेमाल करना चाहिए?

बिल्ड के पीक के लिए काफ़ी मेमोरी। प्राइवेट रिपॉज़िटरी के ubuntu-latest में 2 CPU और 8 GB हैं, और बड़े Next.js ऐप का webpack बिल्ड, टाइप चेक और source maps उसे पार कर सकते हैं। GitHub के larger runners में 4 कोर पर 16 GB और 8 पर 32 GB हैं, सिर्फ़ GitHub Team या Enterprise Cloud पर, प्रति मिनट। Skipbox runs-on: skipbox-8x16 पर हर महीने $79 में 8 vCPU के साथ 16 GB देता है, और skipbox-16x32 पर $149 में 16 vCPU के साथ 32 GB।

### GitHub Actions पर Next.js बिल्ड में JavaScript heap out of memory कैसे ठीक करें?

वह एरर Node की अपनी heap सीमा है, मशीन की मेमोरी नहीं। उसे NODE_OPTIONS=--max-old-space-size=<MiB> से बढ़ाएं, मशीन की मेमोरी से कम रखकर। अगर तब जॉब exit code 137 के साथ खत्म होती है, तो मशीन की खुद की मेमोरी खत्म हुई: बिल्ड की मेमोरी घटाएं (experimental.webpackMemoryOptimizations, production में source maps नहीं) या ज़्यादा मेमोरी वाली मशीन पर चलाएं।

### Next.js बिल्ड की मेमोरी कैसे घटाएं?

Next.js की मेमोरी गाइड से: experimental.webpackMemoryOptimizations आज़माएं (v15 और बाद में), webpack build worker चालू रखें (v14.1.0 से custom webpack config के बिना डिफ़ॉल्ट), productionBrowserSourceMaps और experimental.serverSourceMaps बंद करें, और next build --experimental-debug-memory-usage से मापें। typescript.ignoreBuildErrors से टाइप चेक छोड़ने पर मेमोरी बचती है पर टाइप एरर निकल जाती हैं, इसलिए ऐसा तभी करें जब कोई दूसरी CI जॉब टाइप चेक करती हो।

### क्या Skipbox जॉब के बीच .next/cache रखता है?

हां। आपकी डेडिकेटेड मशीन जॉब के बीच चेकआउट रखती है, और उसमें .next/cache भी, Next.js ने उसे जहां भी रखा हो (monorepo में apps/web/.next/cache), इसलिए अगला next build बिना किसी कैश स्टेप के पिछले बिल्ड के कैश से शुरू होता है। .next का बाकी हिस्सा और चेकआउट की दूसरी untracked फ़ाइलें हर जॉब के बाद साफ़ की जाती हैं। npm या pnpm का कैश, setup-node के इंस्टॉल किए Node वर्ज़न और Docker की लेयर भी डिस्क पर रहते हैं। .next/cache के लिए actions/cache स्टेप रह सकता है: नई VM पर चलने वाली जॉब, जैसे फ़ोर्क से आई पुल रिक्वेस्ट, उससे restore करती है, और आपकी डेडिकेटेड मशीन पर restore रखे गए कैश को जैसा है वैसा छोड़ देता है।

### आज़माने में कितना खर्च आता है?

कुछ नहीं। ट्रायल 7 दिन या 3,000 जॉब-मिनट का है, जो भी पहले पूरा हो, बिना कार्ड, 4 vCPU और 16 GB पर: प्राइवेट रिपॉज़िटरी पर ubuntu-latest के 8 GB का 2×, और GitHub के 4-कोर larger runner के बराबर। वहां कैशिंग और मेमोरी आज़माएं; जिस बिल्ड को ज़्यादा चाहिए, उसके लिए L प्लान चुनें और लेबल skipbox-16x32 (32 GB) करें।

2026-11-19 को अपडेट किया गया · https://skipbox.dev/hi/guides/nextjs-build-slow-out-of-memory-github-actions
