Skipbox

Компилацията на Next.js е бавна или ѝ свършва паметта в GitHub Actions: кеш, памет, размер на рънъра

Компилацията на Next.js в GitHub Actions е бавна по една причина и ѝ свършва паметта по друга. Бавна е, когато .next/cache не се пренася към следващото изпълнение: Next.js използва този кеш отново между компилациите, задача, хоствана от GitHub, започва на нова VM и без стъпка за кеша всяка компилация е студена (логът казва No Cache Detected). Паметта ѝ свършва, защото ubuntu-latest в частно хранилище има 8 GB, а компилирането с webpack, проверката на типовете и source maps на голямо приложение могат да надхвърлят това. Първото се оправя с actions/cache за .next/cache. За второто първо идват настройките на Next.js за паметта (experimental.webpackMemoryOptimizations, без source maps в production); после машина с повече памет: 16 GB или 32 GB.

Skipbox дава на компилацията тази памет на фиксирана цена: 16 GB и 8 vCPU с runs-on: skipbox-8x16 за $79 на месец, 32 GB и 16 vCPU с skipbox-16x32 за $149. На отделната ви машина .next/cache остава за следващата компилация, кешовете на пакетите остават на диска, а записаното от actions/cache се чете локално, с неограничени минути.

Бавна: .next/cache започва празен

От ръководството на Next.js за кеширане на компилацията в 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') }}-

Ключът се сменя с всяка промяна в изходния код, така че всяко изпълнение записва нов запис, в рамките на 10-те GB на хранилище в GitHub. В Turborepo изключете .next/cache от outputs на задачата ("!.next/cache/**"), както прави ръководството на Turborepo за GitHub Actions.

Без памет: две различни грешки

Вдигането на heap над паметта на машината превръща първата грешка във втората.

Използвайте по-малко памет: собствените настройки на Next.js

От ръководството на Next.js за използването на памет:

  • experimental.webpackMemoryOptimizations: true (v15.0.0 и по-нови) намалява пика на паметта на webpack, срещу малко по-дълго компилиране.
  • Build worker-ът на webpack изпълнява компилирането в отделен Node worker, което намалява паметта. Той е включен по подразбиране от v14.1.0, освен ако нямате собствена конфигурация на webpack; ако имате, задайте 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 snapshots близо до лимита.
  • Проверка на типовете: typescript.ignoreBuildErrors: true прескача проверката на типовете и паметта ѝ и пуска грешките в типовете в компилацията. Next.js предупреждава срещу това, освен ако друга стъпка не проверява типовете.

Използвайте машина с повече памет

При 20 000 минути на месец рънърът на GitHub с 8 ядра е $422, а Skipbox M е $79; при 16 ядра – $822 срещу $149 за L. Цифрите за GitHub са след включеното в GitHub Team използване.

Какво прави Skipbox за компилация на Next.js

Всеки план идва с отделна машина за профила ви, пазена между задачите:

  • Паметта, от която се нуждае компилацията, чрез етикета: 16 GB в M, 32 GB в L. Задайте heap според нея, например --max-old-space-size=12288 в M.
  • Кешовете на пакетите остават на диска: ~/.npm, хранилището на pnpm, ~/.cache на всеки инструмент и версиите на Node, инсталирани от setup-node. npm ci чете от тях вместо от регистъра.
  • .next/cache остава за следващата задача. Машината пази работното ви копие между задачите, а с него и .next/cache, на каквато и дълбочина да го слага monorepo (apps/web/.next/cache). Следващото next build започва от него, без стъпка за кеша и без No Cache Detected. Останалото от .next и другите непроследени файлове в работното копие се почистват след всяка задача.
  • Възстановяванията от actions/cache четат машината. Записаното от тях остава до машината, с повече място от 10-те GB на хранилище в GitHub, а възстановяването е локално четене. Запазете стъпката за .next/cache за задачите, които се изпълняват на нова VM; на отделната ви машина възстановяването оставя пазения кеш както е.
  • Повече ядра на фиксирана цена. Компилирането и генерирането на статичните страници ги използват, а минутите са неограничени.

Преминаването е един ред

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. Влезте в Skipbox с GitHub.
  2. Инсталирайте приложението Skipbox в GitHub и изберете хранилищата.
  3. Сменете runs-on и направете push.

Сигурност

  • Машината е само на вашия профил. Задачи на друга компания никога не се изпълняват на нея.
  • След всяка задача идентификационните данни, процесите и контейнерите на рънъра се изтриват, както и идентификационните данни на git в пазеното работно копие и непроследените му файлове, освен кешовете на компилацията като .next/cache. „Чиста VM за всяка задача“ дава вместо това на всяка задача нова машина.
  • Код от хора без права за запис (например pull request-и от форкове) се изпълнява на нова VM, която чете кешовете ви, но не може да ги променя.

Подробностите са в как са изолирани задачите.

Изпробвайте го с компилацията на Next.js

Пробният период е безплатен за 7 дни или 3000 минути на задачи, което настъпи първо, без карта. Той изпълнява runs-on: skipbox с 16 GB, 2× паметта на ubuntu-latest в частно хранилище: изпробвайте кеша и паметта там и преместете компилация, която се нуждае от повече, на план L (skipbox-16x32, 32 GB).

Често задавани въпроси

Защо next build е бавен в GitHub Actions?

Обикновено защото .next/cache започва празен. Next.js записва кеш на компилацията в .next/cache и го използва отново при следващата компилация, но задача, хоствана от GitHub, е нова VM, така че без стъпка, която пренася .next/cache, всяка компилация е студена, а логът предупреждава No Cache Detected. Добавете actions/cache за .next/cache с ключ по lockfile-а и изходните ви файлове. Останалото време е инсталирането и компилирането на 2 CPU.

Какъв размер рънър да използва компилацията на Next.js в GitHub Actions?

Достатъчно памет за пика на компилацията. ubuntu-latest в частно хранилище има 2 CPU и 8 GB, а компилацията с webpack, проверката на типовете и source maps на голямо приложение на Next.js могат да надхвърлят това. По-големите рънъри на GitHub имат 16 GB при 4 ядра и 32 GB при 8, само в GitHub Team или Enterprise Cloud, на минута. Skipbox дава 16 GB с 8 vCPU с runs-on: skipbox-8x16 за $79 на месец и 32 GB с 16 vCPU с skipbox-16x32 за $149.

Как да оправя JavaScript heap out of memory в компилация на Next.js в GitHub Actions?

Тази грешка е собственият лимит на heap на Node, не паметта на машината. Вдигнете го с NODE_OPTIONS=--max-old-space-size=<MiB>, зададен под паметта на машината. Ако после задачата завърши вместо това с exit code 137, на самата машина ѝ е свършила паметта: намалете паметта на компилацията (experimental.webpackMemoryOptimizations, без source maps в production) или изпълнете на машина с повече памет.

Как да намаля използваната памет при компилацията на Next.js?

От ръководството на Next.js за паметта: опитайте experimental.webpackMemoryOptimizations (v15 и по-нови), оставете build worker-а на webpack включен (по подразбиране без собствена конфигурация на webpack от v14.1.0), изключете productionBrowserSourceMaps и experimental.serverSourceMaps и измервайте с next build --experimental-debug-memory-usage. Прескачането на проверката на типовете с typescript.ignoreBuildErrors спестява памет, но пропуска грешките в типовете, така че го правете само когато друга задача в CI проверява типовете.

Пази ли Skipbox .next/cache между задачите?

Да. Отделната ви машина пази работното копие между задачите, а с него и .next/cache, където и да го е сложил Next.js (apps/web/.next/cache в monorepo), така че следващото next build започва от кеша на предишното без стъпка за кеша. Останалото от .next и другите непроследени файлове в работното копие се почистват след всяка задача. Кешът на npm или pnpm, версиите на Node, инсталирани от setup-node, и слоевете на Docker също остават на диска. Стъпка с actions/cache за .next/cache може да остане: задача на нова VM, например pull request от форк, възстановява от нея, а на отделната ви машина възстановяването оставя пазения кеш както е.

Колко струва да го изпробвам?

Нищо. Пробният период е 7 дни или 3000 минути на задачи, което настъпи първо, без карта, на 4 vCPU и 16 GB: 2× 8-те GB на ubuntu-latest в частно хранилище и колкото по-големия рънър на GitHub с 4 ядра. Изпробвайте кеширането и паметта там; за компилация, която се нуждае от повече, изберете план L и сменете етикета на skipbox-16x32 (32 GB).

Обновено на 19 ноември 2026 г.

По-бърз CI/CD с винаги топъл кеш

Вашият топъл рънър на фиксирана цена

Ние ги хостваме. Вие променяте един ред. 1/12 от цената на GitHub при пълно натоварване. Цената е фиксирана, затова пускайте задачи по цял ден. 7× повече място за кеш от GitHub.

  • Без карта
  • Вход с GitHub
  • Прекратяване по всяко време