コンテンツへスキップ

GitHub ActionsでNext.jsを高速化する

最終更新

Next.jsをGitHub Actionsで最も速く高速化する方法は、.next/cacheを実行間で永続化し、すべてのジョブで同じものを毎回インストールしてビルドしないようにすることです。コールドなnext buildは、すべてを再コンパイルして再最適化します。ウォームな状態では、コンパイラーと画像のキャッシュを再利用し、変更されたファイルの分の作業だけを行います。

このガイドでは、Next.jsパイプラインにおける実際のコストを扱います。インストール、ビルド、型チェック、ユニットテスト、エンドツーエンドテストが対象です。これは当社の一般的なGitHub Actionsの高速化ガイドのNext.js版です。

時間がかかっている箇所

一般的なNext.jsのワークフローでは、依存関係のインストール、lint、型チェック、ビルド、テストの5つを行います。2 vCPUのランナーでは、ビルドが最も長いステップになることが多く、next buildは修正可能な理由で遅い場合に警告を出します。それが「No Cache Detected」というメッセージです。このメッセージは.next/cacheが空だったことを意味します。Next.jsはCIビルドキャッシュのガイドでこれを説明しています。

まずステップごとの所要時間を確認してください。インストールに60秒、ビルドに3分かかっている場合は、他の何よりも先にビルドキャッシュを修正してください。

.next/cacheとパッケージマネージャーをキャッシュする

Next.jsはコンパイラーと最適化の出力を.next/cacheに保存します。公式ガイドでは、ロックファイルのハッシュとソースファイルのハッシュから作成したキーに、restore-keysによるフォールバックを組み合わせる方法を示しています。このフォールバックが重要です。ソースファイルを変更すると完全一致のキーは外れますが、リストアキーが前回のキャッシュを復元するため、変更されたファイルだけを再ビルドできます。

name: ci
on:
  pull_request:
  push:
    branches: [main]

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}

jobs:
  build:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version: 24
          cache: npm
      - uses: actions/cache@v6
        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: npm run build

詳細は2点です。第一に、actions/setup-nodeにcache: npmを指定すると、キャッシュされるのはnode_modulesではなくnpmのダウンロードキャッシュです。そのためnpm ciはクリーンインストールを行いますが、ダウンロードは省略されます。pnpmやyarnの場合はcache: pnpmまたはcache: yarnを使用してください。第二に、GitHubのキャッシュエントリーは変更不可です。実行が保存できるのは、まだ存在しないキーだけです。ソースのハッシュを含むキーは、ほぼすべてのPRで新しいエントリーを作成するため、クォータを使い切ってしまいます。削除ルールについてはGitHub Actionsのキャッシュの制限を参照し、他のキーを試すにはキャッシュキービルダーを使ってください。

作業を並列ジョブに分割する

lint、型チェック、ユニットテストはビルドの出力を必要としません。ビルドと重なるよう、別々のジョブとして実行してください。

  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version: 24
          cache: npm
      - run: npm ci
      - run: npx eslint . --cache --cache-location .eslintcache
      - run: npx tsc --noEmit --incremental
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version: 24
          cache: npm
      - run: npm ci
      - run: npx vitest run

各ジョブではチェックアウトとインストールを繰り返すため、インストールがキャッシュされ短い場合にのみ効果があります。ユニットテストが遅い場合は、Jestが遅いまたはVitestが遅いを参照してください。

Turbopackとビルド時間

新しいNext.jsのリリースでは、next devとnext buildにRust製のバンドラーであるTurbopackを使用しています。next buildがデフォルトでTurbopackを使うかどうか、また有効化・無効化のフラグは、リリースごとに変わっているため、お使いのバージョンのリリースノートで確認してください。Turbopackはマルチスレッドで動作するため、標準のホストランナーの2コアより多くのコアの恩恵を受けます。ただし、.next/cacheの必要性がなくなるわけではありません。自分のアプリで、next buildをキャッシュありとなしの両方で計測してください。推測で判断しないでください。

確認する価値のある、そのほかのビルド時間のコストは次のとおりです。

  • テレメトリー。ビルドで余分な通信が発生しないよう、CIではNEXT_TELEMETRY_DISABLED=1を設定してください。
  • APIを呼び出す静的生成。 generateStaticParamsが低速なバックエンドにアクセスすると、ビルドはその応答を待つことになります。CIは高速なフィクスチャーまたはモックを参照するように設定してください。
  • 画像の最適化。固有のリモート画像が多いとビルドが遅くなります。キャッシュは同じ実行を繰り返すときに効果があります。
  • ソースマップ。本番用のブラウザーソースマップは時間を追加します。テストにしか使わないCIビルドでは無効にしてください。

PlaywrightによるエンドツーエンドテストI

Playwrightは通常、Next.jsリポジトリで最も長いジョブです。一度だけビルドし、.nextの出力をactions/upload-artifactでアップロードし、シャードごとにビルドし直すのではなく、各シャードでnext startを実行してください。マトリックスとともにPlaywrightの--shard=1/4フラグを使います。ブラウザーのキャッシュを含む完全な手順は、Playwrightテストが遅いとGitHub Actionsでのテストのシャーディングにあります。シャード数の選定にはテストシャード計算ツールが役立ちます。

CPU コア数を増やす効果

next build、tsc、Turbopack、Playwrightのワーカーはいずれも複数のコアを使用します。2 vCPUのランナーでは、その多くが未使用のままになります。当社のベンチマークには、2つのNext.jsスタックが含まれており、2026年10月8日に、10個のテストシャードと実際のデータベースを用いた完全なCI実行として計測しました。Turborepo + Next.js + tRPC + MySQLは、GitHub提供のランナーでの3m29sから、compiler.dev上で1m53sへと短縮されました(1.9x)。Next.js + SupabaseとPlaywrightの構成では、4m03sから2m48sへ(1.4x)短縮されました。これらはビルドステップだけでなくパイプライン全体の計測結果ですので、あくまで目安として捉え、お使いのリポジトリで同じ結果が得られるとは限らない点にご留意ください。

試すには、GitHubアプリをインストールしたあと、runs-on: [self-hosted, Linux, compiler-ci]の1行を変更するだけです。デフォルトのマシンは8 vCPU・16 GBで、料金は1分あたり$0.008です。何らかの失敗が起きた場合、ジョブは元のランナーにフォールバックします。詳細は料金ページと比較に掲載しています。Next.jsテンプレートと一般的なNodeテンプレートもあります。

チェックリスト

  1. .next/cacheに対して、ロックファイルとソースのキー、およびリストアキーを指定したactions/cacheを追加する。
  2. パッケージマネージャーにはsetup-nodeのキャッシュを使用する。
  3. lint、型チェック、ユニットテスト、ビルドを並列ジョブとして実行する。
  4. Playwright用に一度ビルドし、テストをシャーディングする。
  5. concurrencyとtimeout-minutesを追加する。
  6. ビルドジョブにより多くのコアを試し、実行ごとのコストを比較する。

よくある質問

next buildが「No Cache Detected」と表示するのはなぜですか?

ビルド時点で.next/cacheが空でした。上で示したようにactions/cacheでこのフォルダーを実行間で保持すると、次の実行からこのメッセージは表示されなくなります。

GitHub Actionsでnode_modulesをキャッシュすべきですか?

通常は不要です。actions/setup-nodeでパッケージマネージャーのダウンロードキャッシュをキャッシュし、クリーンなnpm ciを実行してください。復元されたnode_modulesはロックファイルの問題を隠してしまうことがあります。

Turbopackを使えばキャッシュは不要になりますか?

いいえ。Turbopackはコンパイルを高速化しますが、.next/cacheには引き続き結果が保存され、同じビルドを繰り返す際の速度向上に役立ちます。どちらも、お使いのアプリで計測してください。

モノレポでNext.jsのビルドを高速化するには、どうすればよいですか。

影響を受けたアプリのみをビルドし、リモートキャッシュを利用してください。NxまたはTurborepoを使ったモノレポのCIを参照してください。

このワークフローを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す