Next.js ↗ は、Web サイトとアプリケーションを作るためのオープンソースの React フレームワークです。このガイドでは、静的な Next.js アプリケーションを作成し、Cloudflare Pages でデプロイします。
静的エクスポート ↗ を使う静的サイトの Next.js プロジェクトをデプロイする手順を説明します。
すべてのフレームワークガイドは、Git ↗ の基本的な理解があることを前提としています。Git を初めて使う場合は、この Git ハンドブックの要約 ↗ で、ローカルマシンへの Git のセットアップ方法を確認してください。
SSH でクローンする場合は、GitHub に対して push または pull する各コンピューターで SSH キーを生成 ↗ する必要があります。
詳細は GitHub のドキュメント ↗ と Git のドキュメント ↗ を参照してください。
すでにデプロイしたい Next.js プロジェクトがある場合は、静的エクスポート向けに設定 ↗ されていることを確認し、そのディレクトリに移動して次の手順へ進みます。ない場合は、create-next-app で新しい Next.js プロジェクトを作成します。
npx create-next-app --example with-static-export my-appプロジェクトを作成すると、公式の with-static-export ↗ 例をテンプレートとして、新しい my-app ディレクトリが生成されます。作業を続けるには、このディレクトリに移動します。
cd my-apprepo.new ↗ にアクセスして新しい GitHub リポジトリを作成します。リポジトリの準備ができたら、ターミナルで次のコマンドを実行し、ローカルのアプリケーションを GitHub にプッシュします。
git remote add origin https://github.com/<GH_USERNAME>/<REPOSITORY_NAME>.git
git branch -M main
git push -u origin mainサイトを Pages にデプロイする手順は次のとおりです。
-
Cloudflare ダッシュボードで Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
Create application を選択します。
-
Pages タブを選択します。
-
Import an existing Git repository を選択します。
-
作成した新しい GitHub リポジトリを選択し、Begin setup を選択します。
-
Build settings セクションで、Framework preset に Next.js (Static HTML Export) を選びます。選ぶと、次の情報が表示されます。
| 設定項目 | 値 |
|---|---|
| 本番ブランチ | main |
| ビルドコマンド | npx next build |
| ビルドディレクトリ | out |
サイトの設定が終わったら、最初のデプロイを開始できます。Cloudflare Pages は next とプロジェクトの依存関係をインストールし、サイトをビルドしてからデプロイします。
サイトをデプロイすると、プロジェクト専用の *.pages.dev サブドメインが割り当てられます。
Next.js サイトに新しいコードをコミットするたびに、Cloudflare Pages はプロジェクトを自動で再ビルドしてデプロイします。新しいプルリクエストでは プレビューデプロイ も利用できるので、本番に出す前に変更後の見た目を確認できます。
Cloudflare Pages への初回サイトデプロイの手順は、はじめに を参照してください。