Cloudflare Pages へのデプロイ
Nextra 3 サイトを Cloudflare Pages にデプロイしましょう。特にmacOSでの開発時にはいくつかの注意点があります。
1. プロジェクト設定
静的エクスポート
next.config.js で静的エクスポートが有効になっていることを確認してください。
next.config.js
module.exports = withNextra({
output: 'export', // 静的サイト生成に必須
images: {
unoptimized: true, // Next.js Image最適化を無効化(静的エクスポート用)
},
})2. GitHubへのプッシュ
コードをリポジトリにプッシュします。
git add .
git commit -m "Ready for deployment"
git push origin main3. Cloudflare Pages の設定
- Cloudflare Dashboard にログイン。
- Workers & Pages > アプリケーションを作成 > Pages > Gitに接続 へ進みます。
- リポジトリを選択します。
ビルド設定(重要)
- フレームワーク プリセット:
Next.js (Static HTML Export)を選択。 - ビルド出力ディレクトリ:
out(自動設定)。
⚠️ 重要な設定変更
-
ビルドコマンド: デフォルトの
npx next buildから以下に変更してください:npm install && npm run build理由: クロスプラットフォーム(Mac vs Linux)の依存関係エラーを防ぐため、毎回クリーンにインストールさせます。
-
ルートディレクトリ:
- Nextraアプリがサブフォルダにある場合(例:
cloudflarepages-nextra/my-nextra3)、そのパスを指定します。
- Nextraアプリがサブフォルダにある場合(例:
4. デプロイ
「保存してデプロイ」をクリックすれば完了です!