GitHub Actions में Next.js बिल्ड धीमा या मेमोरी खत्म: कैश, मेमोरी, रनर साइज़
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 खाली शुरू होता है
Next.js की CI build caching गाइड के अनुसार Next.js .next/cache में एक कैश सेव करता है जो बिल्ड के बीच शेयर होता है, और जो CI इसे बिल्ड के बीच नहीं बचाता, वह No Cache Detected एरर दिखाता है। उसका GitHub Actions स्टेप:
- 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 गाइड करती है।
मेमोरी खत्म: दो अलग एरर
| लॉग में | क्या खत्म हुआ | क्या करें |
|---|---|---|
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 गाइड से:
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) |
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/cacherestore मशीन को पढ़ते हैं। वह जो सेव करता है, वह मशीन के पास रहता है, 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 |
आना बस एक लाइन का काम है
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 चलाता है।
- GitHub से Skipbox में साइन इन करें।
- Skipbox GitHub App इंस्टॉल करें और रिपॉज़िटरी चुनें।
runs-onबदलें और push करें।
सुरक्षा
- मशीन सिर्फ़ आपके अकाउंट की है। किसी दूसरी कंपनी की जॉब उस पर नहीं चलतीं।
- हर जॉब के बाद रनर के क्रेडेंशियल, प्रोसेस और कंटेनर मिटा दिए जाते हैं, और रखे गए चेकआउट के git क्रेडेंशियल और
.next/cacheजैसे बिल्ड कैश को छोड़कर उसकी untracked फ़ाइलें भी। “हर जॉब नई VM पर” इसके बजाय हर जॉब को नई मशीन देता है। - बिना write एक्सेस वाले लोगों का कोड (जैसे फ़ोर्क से आई पुल रिक्वेस्ट) एक नई VM पर चलता है जो आपका कैश पढ़ सकती है पर उसे बदल नहीं सकती।
पूरी जानकारी जॉब को अलग कैसे रखा जाता है में है।
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) करें।
19 नवंबर 2026 को अपडेट किया गया