Skipbox

Build Next.js perlahan atau kehabisan memori dalam GitHub Actions: cache, memori, saiz runner

Build Next.js dalam GitHub Actions perlahan atas satu sebab dan kehabisan memori atas sebab lain. Ia perlahan apabila .next/cache tidak dibawa ke larian seterusnya: Next.js menggunakan semula cache itu antara build, job yang dihoskan GitHub bermula pada VM baharu, dan tanpa step cache setiap build ialah build sejuk (log menyatakan No Cache Detected). Ia kehabisan memori kerana ubuntu-latest repositori peribadi mempunyai 8 GB, dan kompilasi webpack, semakan jenis dan source map app yang besar boleh melepasinya. Betulkan yang pertama dengan actions/cache pada .next/cache. Untuk yang kedua, tetapan memori Next.js didahulukan (experimental.webpackMemoryOptimizations, tiada source map production); kemudian mesin dengan lebih banyak memori: 16 GB atau 32 GB.

Skipbox memberi build memori itu pada harga tetap: 16 GB dan 8 vCPU pada runs-on: skipbox-8x16 untuk $79 sebulan, 32 GB dan 16 vCPU pada skipbox-16x32 untuk $149. Pada mesin khusus untuk anda .next/cache kekal untuk build seterusnya, cache pakej kekal pada cakera, dan apa yang disimpan actions/cache dibaca secara setempat, dengan minit tanpa had.

Perlahan: .next/cache bermula kosong

Daripada panduan cache build CI Next.js: Next.js "saves a cache to .next/cache that is shared between builds", dan CI yang tidak mengekalkannya antara build menunjukkan ralat No Cache Detected. Step GitHub Actions-nya:

- 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') }}-

Key berubah dengan setiap perubahan sumber, jadi setiap larian menyimpan entri baharu, di dalam 10 GB GitHub bagi setiap repositori. Dalam Turborepo, kecualikan .next/cache daripada outputs tugas ("!.next/cache/**"), seperti yang dilakukan panduan GitHub Actions Turborepo.

Kehabisan memori: dua ralat yang berbeza

Menaikkan heap melebihi memori mesin menukar ralat pertama kepada ralat kedua.

Gunakan kurang memori: tetapan Next.js sendiri

Daripada panduan penggunaan memori Next.js:

  • experimental.webpackMemoryOptimizations: true (v15.0.0 dan kemudian) menurunkan puncak memori webpack, dengan kompilasi yang sedikit lebih lama.
  • Webpack build worker menjalankan kompilasi dalam worker Node yang berasingan, yang menurunkan memori. Ia dihidupkan secara lalai sejak v14.1.0 melainkan anda mempunyai konfigurasi webpack tersuai; jika ada, tetapkan experimental.webpackBuildWorker: true.
  • Source map dimatikan: productionBrowserSourceMaps: false dan experimental.serverSourceMaps: false. Jika build kehabisan memori semasa "Generating static pages", enablePrerenderSourceMaps: false juga.
  • Ukur: next build --experimental-debug-memory-usage (v14.2.0 dan kemudian) mencetak penggunaan heap sepanjang build, dan mengambil snapshot heap berhampiran had.
  • Semakan jenis: typescript.ignoreBuildErrors: true melangkau semakan jenis dan memorinya, dan membiarkan ralat jenis masuk ke build. Next.js memberi amaran terhadapnya melainkan step lain menyemak jenis.

Gunakan mesin dengan lebih banyak memori

Pada 20,000 minit sebulan, runner 8 teras GitHub ialah $422 dan Skipbox M ialah $79; pada 16 teras, $822 berbanding $149 untuk L. Angka GitHub ialah selepas penggunaan yang disertakan dalam GitHub Team.

Apa yang dilakukan Skipbox untuk build Next.js

Setiap pelan disertakan dengan mesin khusus akaun anda, dikekalkan antara job:

  • Memori yang diperlukan build, mengikut label: 16 GB pada M, 32 GB pada L. Tetapkan heap supaya sepadan, seperti --max-old-space-size=12288 pada M.
  • Cache pakej kekal pada cakera: ~/.npm, stor pnpm, ~/.cache setiap alat, dan versi Node yang dipasang oleh setup-node. npm ci membacanya dan bukannya registry.
  • .next/cache kekal untuk job seterusnya. Mesin mengekalkan checkout anda antara job, dan .next/cache di dalamnya, pada apa jua kedalaman yang diletakkan monorepo (apps/web/.next/cache). next build seterusnya bermula daripadanya, tanpa step cache dan tanpa No Cache Detected. Selebihnya .next dan fail lain yang tidak dijejak dalam checkout dibersihkan selepas setiap job.
  • Pemulihan actions/cache membaca mesin. Apa yang disimpannya kekal bersebelahan dengan mesin, dengan lebih banyak ruang daripada 10 GB GitHub bagi setiap repositori, dan pemulihan ialah bacaan setempat. Kekalkan step .next/cache untuk job yang berjalan pada VM baharu; pada mesin khusus untuk anda pemulihan itu membiarkan cache yang dikekalkan seperti sedia ada.
  • Lebih banyak teras pada harga tetap. Kompilasi dan penjanaan halaman statik menggunakannya, dan minit tanpa had.

Beralih hanya satu baris

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 berjalan pada pelan M; percubaan menjalankan runs-on: skipbox.

  1. Log masuk ke Skipbox dengan GitHub.
  2. Pasang GitHub App Skipbox dan pilih repositori.
  3. Tukar runs-on dan push.

Keselamatan

  • Mesin itu milik akaun anda seorang. Tiada job syarikat lain berjalan padanya.
  • Selepas setiap job, bukti kelayakan, proses dan container runner dipadam, begitu juga bukti kelayakan git dalam checkout yang dikekalkan dan fail tidak dijejaknya selain cache build seperti .next/cache. “VM baharu bagi setiap job” memberi setiap job mesin baharu sebaliknya.
  • Kod daripada orang tanpa akses tulis (seperti pull request daripada fork) berjalan pada VM baharu yang membaca cache anda tetapi tidak boleh mengubahnya.

Butirannya dalam cara job diasingkan.

Cuba pada build Next.js

Percubaan adalah percuma selama 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad. Ia menjalankan runs-on: skipbox, dengan 16 GB, 2× memori ubuntu-latest repositori peribadi: cuba cache dan memori di sana, dan pindahkan build yang memerlukan lebih ke pelan L (skipbox-16x32, 32 GB).

Soalan lazim

Kenapa next build perlahan dalam GitHub Actions?

Biasanya kerana .next/cache bermula kosong. Next.js menyimpan cache build ke .next/cache dan menggunakannya semula pada build seterusnya, tetapi job yang dihoskan GitHub ialah VM baharu, jadi tanpa step yang membawa .next/cache, setiap build ialah build sejuk dan log memberi amaran No Cache Detected. Tambah actions/cache untuk .next/cache dengan key berdasarkan lockfile dan fail sumber anda. Baki masa ialah pemasangan dan kompilasi pada 2 CPU.

Apakah saiz runner yang patut digunakan untuk build Next.js dalam GitHub Actions?

Memori yang cukup untuk puncak build. ubuntu-latest repositori peribadi mempunyai 2 CPU dan 8 GB, dan build webpack, semakan jenis dan source map app Next.js yang besar boleh melepasinya. Larger runner GitHub mempunyai 16 GB pada 4 teras dan 32 GB pada 8, hanya pada GitHub Team atau Enterprise Cloud, ikut minit. Skipbox memberi 16 GB dengan 8 vCPU pada runs-on: skipbox-8x16 untuk $79 sebulan, dan 32 GB dengan 16 vCPU pada skipbox-16x32 untuk $149.

Bagaimanakah cara membetulkan JavaScript heap out of memory dalam build Next.js di GitHub Actions?

Ralat itu ialah had heap Node sendiri, bukan memori mesin. Naikkannya dengan NODE_OPTIONS=--max-old-space-size=<MiB>, ditetapkan di bawah memori mesin. Jika job kemudian tamat dengan exit code 137, mesin itu sendiri kehabisan memori: kurangkan memori build (experimental.webpackMemoryOptimizations, tiada source map production) atau jalankan pada mesin dengan lebih banyak memori.

Bagaimanakah cara mengurangkan penggunaan memori build Next.js?

Daripada panduan memori Next.js: cuba experimental.webpackMemoryOptimizations (v15 dan kemudian), biarkan webpack build worker hidup (lalai tanpa konfigurasi webpack tersuai sejak v14.1.0), matikan productionBrowserSourceMaps dan experimental.serverSourceMaps, dan ukur dengan next build --experimental-debug-memory-usage. Melangkau semakan jenis dengan typescript.ignoreBuildErrors menjimatkan memori tetapi membiarkan ralat jenis lepas, jadi lakukannya hanya apabila job CI lain menyemak jenis.

Adakah Skipbox mengekalkan .next/cache antara job?

Ya. Mesin khusus untuk anda mengekalkan checkout antara job, dan .next/cache di dalamnya, di mana sahaja Next.js meletakkannya (apps/web/.next/cache dalam monorepo), jadi next build seterusnya bermula daripada cache build terakhir tanpa step cache. Selebihnya .next dan fail lain yang tidak dijejak dalam checkout dibersihkan selepas setiap job. Cache npm atau pnpm, versi Node yang dipasang setup-node dan lapisan Docker juga kekal pada cakera. Step actions/cache untuk .next/cache boleh kekal: job pada VM baharu, seperti pull request daripada fork, memulihkan daripadanya, dan pada mesin khusus untuk anda pemulihan itu membiarkan cache yang dikekalkan seperti sedia ada.

Berapakah kos untuk mencuba?

Tiada. Percubaan ialah 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad, pada 4 vCPU dan 16 GB: 2× 8 GB ubuntu-latest pada repositori peribadi, dan sama dengan larger runner 4 teras GitHub. Cuba cache dan memori di sana; untuk build yang memerlukan lebih, pilih pelan L dan tukar label kepada skipbox-16x32 (32 GB).

Dikemas kini 19 November 2026

CI/CD lebih pantas dengan cache yang sentiasa sedia

Runner anda yang sentiasa sedia pada harga tetap

Kami yang hoskan. Anda tukar satu baris. 1/12 daripada kos GitHub pada penggunaan penuh. Harga tetap, jadi jalankan sepanjang hari. 7× ruang cache GitHub.

  • Tanpa kad
  • Log masuk dengan GitHub
  • Batal bila-bila masa