Skipbox

بیلد 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 انجام می‌دهد.

کمبود حافظه: دو خطای متفاوت

بالا بردن 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 از آن برحذر می‌دارد، مگر آنکه گام دیگری تایپ‌ها را بررسی کند.

از ماشینی با حافظه بیشتر استفاده کنید

با 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 را برای جاب‌هایی که روی یک ماشین مجازی تازه اجرا می‌شوند نگه دارید؛ روی ماشین اختصاصی شما بازگردانی به کش نگه‌داشته‌شده دست نمی‌زند.
  • هسته‌های بیشتر با قیمت ثابت. کامپایل و تولید صفحه‌های ایستا از آن‌ها استفاده می‌کنند، و دقیقه‌ها نامحدودند.

انتقال یک خط است

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 را نصب کنید و مخزن‌ها را انتخاب کنید.
  3. 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) تغییر دهید.

به‌روزرسانی: ۲۵ آبان ۱۴۰۵

CI/CD سریع‌تر با کشی که همیشه آماده است

رانر همیشه آماده شما با قیمت ثابت

میزبانی با ماست. شما یک خط را عوض می‌کنید. 1/12 هزینه GitHub با استفاده کامل. قیمت ثابت است، پس تمام روز اجرایش کنید. ۷ برابر فضای کش GitHub.

  • بدون کارت
  • ورود با GitHub
  • لغو در هر زمان