بیلد Next.js در GitHub Actions کند است یا حافظهاش تمام میشود: کش، حافظه، اندازه رانر
بیلد Next.js در GitHub Actions به یک دلیل کند است و به دلیل دیگری حافظهاش تمام میشود. وقتی کند است که .next/cache به اجرای بعدی نرسد: Next.js آن کش را بین بیلدها دوباره استفاده میکند، جاب میزبانیشده GitHub روی یک ماشین مجازی تازه شروع میشود، و بدون گام کش هر بیلد سرد است (لاگ میگوید No Cache Detected). حافظهاش تمام میشود چون ubuntu-latest یک مخزن خصوصی 8 GB دارد، و کامپایل webpack، بررسی تایپ و source mapهای یک اپ بزرگ میتوانند از آن بگذرند. اولی را با actions/cache روی .next/cache درست کنید. برای دومی، اول تنظیمات حافظه Next.js (experimental.webpackMemoryOptimizations، بدون source mapهای production)؛ بعد ماشینی با حافظه بیشتر: 16 GB یا 32 GB.
Skipbox آن حافظه را با قیمت ثابت به بیلد میدهد: ۱۶ GB و ۸ vCPU روی runs-on: skipbox-8x16 با ماهانه $۷۹، و ۳۲ GB و ۱۶ vCPU روی skipbox-16x32 با $۱۴۹. روی ماشین اختصاصی شما .next/cache برای بیلد بعدی میماند، کش پکیجها روی دیسک میمانند، و آنچه actions/cache ذخیره میکند محلی خوانده میشود، با دقیقههای نامحدود.
کند: .next/cache خالی شروع میشود
طبق راهنمای کش بیلد در CI در 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') }}-
کلید با هر تغییر سورس تغییر میکند، پس هر اجرا یک ورودی تازه ذخیره میکند، داخل ۱۰ GB GitHub برای هر مخزن. در Turborepo، .next/cache را از outputs تسک کنار بگذارید ("!.next/cache/**")، همانطور که راهنمای GitHub Actions در Turborepo انجام میدهد.
کمبود حافظه: دو خطای متفاوت
| در لاگ | چه چیزی تمام شد | چه کنید |
|---|---|---|
JavaScript heap out of memory | سقف heap خود Node؛ ماشین هنوز حافظه داشت | بالایش ببرید: NODE_OPTIONS=--max-old-space-size=6144، کمتر از حافظه ماشین |
Process completed with exit code 137 | حافظه ماشین: Linux پروسه را کشت | حافظه کمتری مصرف کنید، یا ماشینی با حافظه بیشتر |
بالا بردن heap بیشتر از حافظه ماشین خطای اول را به دومی تبدیل میکند.
حافظه کمتری مصرف کنید: تنظیمات خود Next.js
از راهنمای مصرف حافظه در Next.js:
experimental.webpackMemoryOptimizations: true(v15.0.0 و بعدتر) اوج حافظه webpack را پایین میآورد، به قیمت کامپایلی کمی طولانیتر.- build worker در webpack کامپایل را در یک worker جداگانه Node اجرا میکند، که حافظه را کم میکند. از v14.1.0 بهطور پیشفرض روشن است، مگر تنظیم webpack سفارشی داشته باشید؛ با آن،
experimental.webpackBuildWorker: trueرا تنظیم کنید. - source mapها خاموش:
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 و حافظه | چه کسانی میتوانند استفاده کنند |
|---|---|---|
ubuntu-latest در GitHub، مخزن خصوصی | 2 CPU، 8 GB | همه |
ubuntu-latest در GitHub، مخزن عمومی | 4 CPU، 16 GB | مخزنهای عمومی |
| larger runner در GitHub، 4 یا 8 هسته | 16 GB یا 32 GB | سازمانهای GitHub Team و Enterprise Cloud، دقیقهای (larger runnerها) |
Skipbox skipbox-8x16 | ۸ vCPU، ۱۶ GB | سازمانها و حسابهای شخصی، ماهانه $۷۹ |
Skipbox skipbox-16x32 | ۱۶ vCPU، ۳۲ GB | سازمانها و حسابهای شخصی، ماهانه $۱۴۹ |
با 20,000 دقیقه در ماه، رانر 8 هستهای GitHub $۴۲۲ است و Skipbox M $۷۹؛ با 16 هسته، $۸۲۲ در برابر $۱۴۹ برای L. ارقام GitHub پس از مصرف شاملشده GitHub Team است.
Skipbox برای بیلد Next.js چه میکند
هر طرح با ماشین اختصاصی حساب شما میآید که بین جابها نگه داشته میشود:
- حافظهای که بیلد لازم دارد، با لیبل: روی M ۱۶ GB، روی L ۳۲ GB. heap را متناسب با آن تنظیم کنید، مثلاً روی M
--max-old-space-size=12288. - کش پکیجها روی دیسک میمانند:
~/.npm، store در pnpm،~/.cacheهر ابزار، و نسخههای Node کهsetup-nodeنصب کرده.npm ciبهجای registry از آنها میخواند. .next/cacheبرای جاب بعدی میماند. ماشین checkout شما را بین جابها نگه میدارد، و.next/cacheداخل آن را، در هر عمقی که یک monorepo آن را بگذارد (apps/web/.next/cache).next buildبعدی از آن شروع میشود، بدون گام کش و بدونNo Cache Detected. بقیه.nextو فایلهای ردیابینشده دیگر checkout بعد از هر جاب پاک میشوند.- بازگردانیهای
actions/cacheاز ماشین میخوانند. آنچه ذخیره میکند کنار ماشین میماند، با فضایی بیشتر از ۱۰ GB GitHub برای هر مخزن، و بازگردانی یک خواندن محلی است. گام.next/cacheرا برای جابهایی که روی یک ماشین مجازی تازه اجرا میشوند نگه دارید؛ روی ماشین اختصاصی شما بازگردانی به کش نگهداشتهشده دست نمیزند. - هستههای بیشتر با قیمت ثابت. کامپایل و تولید صفحههای ایستا از آنها استفاده میکنند، و دقیقهها نامحدودند.
| لیبل | ماشین | طرح |
|---|---|---|
skipbox | ۴ vCPU · ۱۶ GB | S، ماهانه $۳۹ |
skipbox-8x16 | ۸ vCPU · ۱۶ GB | M، ماهانه $۷۹ |
skipbox-16x32 | ۱۶ vCPU · ۳۲ GB | L، ماهانه $۱۴۹ |
انتقال یک خط است
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 را نصب کنید و مخزنها را انتخاب کنید.
runs-onرا تغییر دهید و push کنید.
امنیت
- ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمیشود.
- بعد از هر جاب، اعتبارنامههای رانر، پروسهها و کانتینرها پاک میشوند، و همینطور اعتبارنامههای git در checkout نگهداشتهشده و فایلهای ردیابینشده آن بهجز کشهای بیلد مثل
.next/cache. گزینه «ماشین تازه برای هر جاب» بهجای آن به هر جاب یک ماشین تازه میدهد. - کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین مجازی تازه اجرا میشود که کشهای شما را میخواند ولی نمیتواند تغییرشان دهد.
جزئیات در جداسازی جابها است.
روی بیلد Next.js امتحانش کنید
دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، بدون کارت. runs-on: skipbox را با ۱۶ GB اجرا میکند، ۲ برابر حافظه ubuntu-latest یک مخزن خصوصی: کش و حافظه را آنجا امتحان کنید، و بیلدی را که بیشتر لازم دارد به طرح L (skipbox-16x32، ۳۲ GB) ببرید.
پرسشهای متداول
چرا next build در GitHub Actions کند است؟
معمولاً چون .next/cache خالی شروع میشود. Next.js یک کش بیلد در .next/cache ذخیره میکند و در بیلد بعدی دوباره از آن استفاده میکند، ولی جاب میزبانیشده GitHub یک ماشین مجازی تازه است، پس بدون گامی که .next/cache را منتقل کند، هر بیلد سرد است و لاگ هشدار No Cache Detected میدهد. actions/cache را برای .next/cache با کلیدی بر اساس lockfile و فایلهای سورس اضافه کنید. بقیه زمان صرف نصب و کامپایل روی 2 CPU میشود.
بیلد Next.js در GitHub Actions از چه اندازه رانری باید استفاده کند؟
حافظه کافی برای اوج بیلد. ubuntu-latest یک مخزن خصوصی 2 CPU و 8 GB دارد، و بیلد webpack، بررسی تایپ و source mapهای یک اپ بزرگ Next.js میتوانند از آن بگذرند. larger runnerهای GitHub با 4 هسته 16 GB و با 8 هسته 32 GB دارند، فقط در GitHub Team یا Enterprise Cloud، دقیقهای. Skipbox روی runs-on: skipbox-8x16 ۱۶ GB با ۸ vCPU به ماهانه $۷۹ میدهد، و روی skipbox-16x32 ۳۲ GB با ۱۶ vCPU به $۱۴۹.
چطور خطای JavaScript heap out of memory را در بیلد Next.js روی GitHub Actions برطرف کنم؟
آن خطا سقف heap خود Node است، نه حافظه ماشین. با NODE_OPTIONS=--max-old-space-size=<MiB> بالایش ببرید، کمتر از حافظه ماشین. اگر جاب بعد از آن بهجایش با exit code 137 تمام شد، حافظه خود ماشین تمام شده است: حافظه بیلد را کم کنید (experimental.webpackMemoryOptimizations، بدون source mapهای production) یا روی ماشینی با حافظه بیشتر اجرا کنید.
چطور مصرف حافظه بیلد Next.js را کم کنم؟
از راهنمای حافظه Next.js: experimental.webpackMemoryOptimizations را امتحان کنید (v15 و بعدتر)، build worker در webpack را روشن نگه دارید (از v14.1.0 بدون تنظیم webpack سفارشی پیشفرض است)، productionBrowserSourceMaps و experimental.serverSourceMaps را خاموش کنید، و با next build --experimental-debug-memory-usage اندازه بگیرید. رد کردن بررسی تایپ با typescript.ignoreBuildErrors حافظه را کم میکند ولی خطاهای تایپ را رد میکند، پس فقط وقتی انجامش دهید که جاب CI دیگری تایپها را بررسی کند.
Skipbox پوشه .next/cache را بین جابها نگه میدارد؟
بله. ماشین اختصاصی شما checkout را بین جابها نگه میدارد، و .next/cache داخل آن را، هر جا که Next.js گذاشته باشد (در یک monorepo، apps/web/.next/cache)، پس next build بعدی بدون هیچ گام کشی از کش بیلد قبلی شروع میشود. بقیه .next و فایلهای ردیابینشده دیگر checkout بعد از هر جاب پاک میشوند. کش npm یا pnpm، نسخههای Node که setup-node نصب کرده و لایههای Docker هم روی دیسک میمانند. گام actions/cache برای .next/cache میتواند بماند: جابی روی یک ماشین مجازی تازه، مثل pull request از یک fork، از آن بازمیگرداند، و روی ماشین اختصاصی شما بازگردانی به کش نگهداشتهشده دست نمیزند.
امتحان کردنش چقدر هزینه دارد؟
هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، بدون کارت، روی ۴ vCPU و ۱۶ GB: ۲ برابر ۸ GB در ubuntu-latest روی مخزن خصوصی، و برابر larger runner با ۴ هسته در GitHub. کش و حافظه را آنجا امتحان کنید؛ برای بیلدی که بیشتر لازم دارد، طرح L را انتخاب کنید و لیبل را به skipbox-16x32 (۳۲ GB) تغییر دهید.
بهروزرسانی: ۲۵ آبان ۱۴۰۵