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

> Збирання Next.js у GitHub Actions повільне, коли .next/cache не переходить у наступний запуск, і закінчує пам’ять на ubuntu-latest приватного репозиторію з 8 ГБ, щойно webpack, перевірка типів і source maps складаються докупи. Що кешувати, які параметри Next.js зменшують пам’ять і який розмір ранера потрібен: 16 ГБ за $79 на місяць або 32 ГБ за $149 на Skipbox, де .next/cache лишається між завданнями, а хвилини без обмежень.

Збирання 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` лишається на вашій виділеній машині: наступне збирання перевикористовує останню компіляцію, без кроку кешу
- 16 ГБ за $79 на місяць або 32 ГБ за $149 проти 8 ГБ на приватному `ubuntu-latest`
- Кеші пакетів лишаються на вашій машині, а відновлення кешу читає її диск замість завантаження

**GitHub Actions за фіксовану ціну, хвилини без обмежень** Skipbox запускає ваші завдання GitHub Actions на вашій власній виділеній машині: $39 на місяць, скільки б хвилин ви не використали. Шари Docker і кеші залежностей зберігаються між завданнями, тож наступне завдання стартує одразу.

Ранер на 4 vCPU, 20 000 хвилин на місяць: GitHub $222 → Skipbox $39. Ви заощаджуєте $183 щомісяця.

Достатньо змінити один рядок: `runs-on: skipbox`.

[Почати безкоштовний пробний період на 7 дн.](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-uk)

## Повільно: .next/cache стартує порожнім

З [посібника Next.js про кешування збирання в CI](https://nextjs.org/docs/app/guides/ci-build-caching): Next.js зберігає в `.next/cache` кеш, спільний для збирань, а CI, який не зберігає його між збираннями, показує помилку `No Cache Detected`. Його крок для GitHub Actions:

```yaml
- 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](https://turborepo.dev/docs/guides/ci-vendors/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 про використання пам’яті](https://nextjs.org/docs/app/guides/memory-usage):

- **`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](https://docs.github.com/en/actions/concepts/runners/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 на місяць |

## Перехід — це один рядок

```yaml
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 з форків) запускається на новій ВМ, яка читає ваші кеші, але не може їх змінити.

Подробиці — у розділі [Як ізольовано завдання](https://docs.skipbox.dev/uk/isolation).

## Спробуйте на збиранні 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 ГБ).

Оновлено 2026-11-19 · https://skipbox.dev/uk/guides/nextjs-build-slow-out-of-memory-github-actions
