Skipbox

Збирання Next.js у GitHub Actions повільне або без пам’яті: кеш, пам’ять, розмір ранера

Збирання Next.js у GitHub Actions повільне з однієї причини, а закінчує пам’ять з іншої. Воно повільне, коли .next/cache не переходить у наступний запуск: Next.js перевикористовує цей кеш між збираннями, завдання на хостованому ранері GitHub стартує на новій ВМ, і без кроку кешу кожне збирання холодне (лог пише No Cache Detected). Пам’ять закінчується, бо ubuntu-latest приватного репозиторію має 8 ГБ, а компіляція webpack, перевірка типів і source maps великого застосунку можуть це перевищити. Першу проблему виправляє actions/cache на .next/cache. Для другої спершу йдуть параметри пам’яті Next.js (experimental.webpackMemoryOptimizations, без production source maps), а потім машина з більшою пам’яттю: 16 ГБ або 32 ГБ.

Skipbox дає збиранню цю пам’ять за фіксованою ціною: 16 ГБ і 8 vCPU на runs-on: skipbox-8x16 за $79 на місяць, 32 ГБ і 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 ГБ на репозиторій від GitHub. У Turborepo виключіть .next/cache з outputs завдання ("!.next/cache/**"), як це робить посібник Turborepo для GitHub Actions.

Нестача пам’яті: дві різні помилки

Якщо підняти heap вище за пам’ять машини, перша помилка перетвориться на другу.

Використовуйте менше пам’яті: власні параметри Next.js

З посібника Next.js про використання пам’яті:

  • experimental.webpackMemoryOptimizations: true (v15.0.0 і новіші) знижує пікову пам’ять webpack ціною трохи довшої компіляції.
  • Воркер збирання webpack виконує компіляцію в окремому воркері Node, що знижує пам’ять. Він увімкнений за замовчуванням з 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 біля межі.
  • Перевірка типів: typescript.ignoreBuildErrors: true пропускає перевірку типів і її пам’ять, але пропускає й помилки типів у збирання. Next.js застерігає від цього, якщо типи не перевіряє інший крок.

Використовуйте машину з більшою пам’яттю

На 20 000 хвилинах на місяць 8-ядерний ранер GitHub коштує $422, а Skipbox M — $79; на 16 ядрах — $822 проти $149 за L. Суми GitHub — після використання, що входить у GitHub Team.

Що Skipbox робить для збирання Next.js

Кожен тариф дає виділену машину вашого облікового запису, яка лишається між завданнями:

  • Пам’ять, яка потрібна збиранню, за міткою: 16 ГБ на M, 32 ГБ на L. Задайте heap відповідно, наприклад --max-old-space-size=12288 на M.
  • Кеші пакетів лишаються на диску: ~/.npm, сховище pnpm, ~/.cache кожного інструмента та версії Node, які встановив setup-node. npm ci читає їх замість реєстру.
  • .next/cache лишається для наступного завдання. Машина зберігає ваш checkout між завданнями, а з ним і .next/cache, на будь-якій глибині, куди його кладе монорепозиторій (apps/web/.next/cache). Наступний next build стартує з нього, без кроку кешу і без No Cache Detected. Решта .next та інші невідстежувані файли checkout прибираються після кожного завдання.
  • Відновлення actions/cache читають машину. Те, що він зберігає, лишається поряд із машиною, з більшим місцем, ніж 10 ГБ на репозиторій у 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. Увійдіть у Skipbox через GitHub.
  2. Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
  3. Змініть runs-on і зробіть push.

Безпека

  • Машина належить лише вашому обліковому запису. Завдання жодної іншої компанії на ній не працюють.
  • Після кожного завдання стираються облікові дані ранера, процеси й контейнери, а також облікові дані git у збереженому checkout і його невідстежувані файли, крім кешів збирання, як-от .next/cache. «Чиста ВМ для кожного завдання» натомість дає кожному завданню нову машину.
  • Код від людей без права запису (наприклад, pull requests з форків) запускається на новій ВМ, яка читає ваші кеші, але не може їх змінити.

Подробиці — у розділі Як ізольовано завдання.

Спробуйте на збиранні Next.js

Пробний період безкоштовний: 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, без картки. Він запускає runs-on: skipbox з 16 ГБ, у 2× більше пам’яті, ніж у ubuntu-latest приватного репозиторію: спробуйте там кеш і пам’ять, а збирання, якому потрібно більше, перенесіть на тариф L (skipbox-16x32, 32 ГБ).

Запитання й відповіді

Чому next build повільний у GitHub Actions?

Зазвичай тому, що .next/cache стартує порожнім. Next.js зберігає кеш збирання в .next/cache і перевикористовує його в наступному збиранні, але завдання на хостованому ранері GitHub — це нова ВМ, тож без кроку, який переносить .next/cache, кожне збирання холодне, і лог попереджає No Cache Detected. Додайте actions/cache для .next/cache з ключем за lock-файлом і вашими вихідними файлами. Решта часу — це встановлення й компіляція на 2 CPU.

Якого розміру ранер потрібен збиранню Next.js у GitHub Actions?

Із пам’яттю, якої вистачить на пік збирання. ubuntu-latest приватного репозиторію має 2 CPU і 8 ГБ, а збирання webpack, перевірка типів і source maps великого застосунку Next.js можуть це перевищити. Більші ранери GitHub мають 16 ГБ на 4 ядрах і 32 ГБ на 8, лише в GitHub Team або Enterprise Cloud, похвилинно. Skipbox дає 16 ГБ з 8 vCPU на runs-on: skipbox-8x16 за $79 на місяць і 32 ГБ з 16 vCPU на skipbox-16x32 за $149.

Як виправити JavaScript heap out of memory у збиранні Next.js у GitHub Actions?

Ця помилка — власний ліміт heap у Node, а не пам’ять машини. Підніміть його через NODE_OPTIONS=--max-old-space-size=<MiB>, нижче за пам’ять машини. Якщо після цього завдання закінчується кодом виходу 137, пам’яті забракло самій машині: зменште споживання пам’яті збиранням (experimental.webpackMemoryOptimizations, без production source maps) або запускайте на машині з більшою пам’яттю.

Як зменшити споживання пам’яті збиранням Next.js?

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

Чи зберігає Skipbox .next/cache між завданнями?

Так. Ваша виділена машина зберігає checkout між завданнями, а з ним і .next/cache, хоч куди його поклав Next.js (apps/web/.next/cache у монорепозиторії), тож наступний next build стартує з кешу попереднього без жодного кроку кешу. Решта .next та інші невідстежувані файли checkout прибираються після кожного завдання. Кеш npm чи pnpm, версії Node, які встановив setup-node, і шари Docker теж лишаються на диску. Крок actions/cache для .next/cache можна лишити: завдання на новій ВМ, як-от pull request з форку, відновлюється з нього, а на вашій виділеній машині відновлення лишає збережений кеш як є.

Скільки коштує спробувати?

Нічого. Пробний період триває 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, без картки, на 4 vCPU і 16 ГБ: у 2× більше за 8 ГБ у ubuntu-latest приватного репозиторію і стільки ж, скільки в 4-ядерного більшого ранера GitHub. Спробуйте там кешування й пам’ять; для збирання, якому потрібно більше, виберіть тариф L і змініть мітку на skipbox-16x32 (32 ГБ).

Оновлено 19 листопада 2026 р.

Швидший CI/CD із завжди прогрітим кешем

Ваш прогрітий ранер за фіксовану ціну

Хостинг наш. Ви змінюєте один рядок. 1/12 вартості GitHub за повного навантаження. Ціна фіксована, тож запускайте хоч цілий день. Місця для кешу в 7× більше, ніж у GitHub.

  • Без картки
  • Вхід через GitHub
  • Скасування будь-коли