Збирання 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.
Нестача пам’яті: дві різні помилки
| У лозі | Чого забракло | Що робити |
|---|---|---|
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 ціною трохи довшої компіляції.- Воркер збирання 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 застерігає від цього, якщо типи не перевіряє інший крок.
Використовуйте машину з більшою пам’яттю
| Ранер | CPU і пам’ять | Хто може користуватися |
|---|---|---|
GitHub ubuntu-latest, приватний репозиторій | 2 CPU, 8 ГБ | Усі |
GitHub ubuntu-latest, публічний репозиторій | 4 CPU, 16 ГБ | Публічні репозиторії |
| Більший ранер GitHub, 4 або 8 ядер | 16 ГБ або 32 ГБ | Організації в GitHub Team та Enterprise Cloud, похвилинно (larger runners) |
Skipbox skipbox-8x16 | 8 vCPU, 16 ГБ | Організації та особисті облікові записи, $79 на місяць |
Skipbox skipbox-16x32 | 16 vCPU, 32 ГБ | Організації та особисті облікові записи, $149 на місяць |
На 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для завдань, що працюють на новій ВМ; на вашій виділеній машині відновлення лишає збережений кеш як є. - Більше ядер за фіксованою ціною. Їх використовують компіляція і генерація статичних сторінок, а хвилини без обмежень.
| Мітка | Машина | Тариф |
|---|---|---|
skipbox | 4 vCPU · 16 ГБ | S, $39 на місяць |
skipbox-8x16 | 8 vCPU · 16 ГБ | M, $79 на місяць |
skipbox-16x32 | 16 vCPU · 32 ГБ | 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.
- Увійдіть у Skipbox через GitHub.
- Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
- Змініть
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 р.