Cloudflare Pagesのプレビューデプロイを無効化してビルド回数を節約する

Cloudflare Pagesの無料プランでビルド回数を節約したいと思い、プレビューデプロイの無効化方法を調べたので備忘録です。

プレビューデプロイとビルド回数の関係

Cloudflare Pagesの無料プランには 月500回 のビルド制限があります^[1]。この制限はアカウント全体で共有されるため、複数のプロジェクトを運用している場合は特に注意が必要です。

プレビューデプロイとは、本番ブランチ以外（PRやfeatureブランチなど）へのpush時に自動で行われるデプロイのことです。デフォルトでは、すべてのブランチへのpushでビルドが走ります。

つまり、PRを作成するたびにプレビュー用のビルドが実行され、ビルド回数を消費します。個人ブログのように本番環境だけで十分な場合、プレビューデプロイは不要なビルド回数の消費になります。

プレビューデプロイを無効化する手順

Cloudflareダッシュボードから設定を変更します。

1. コンピューティングとAI セクションを開く

2. Workers & Pages > 対象プロジェクト > 設定 に移動しビルド環境をプレビューに変更

3. ブラントコントロールの編集（ペンのアイコン）をクリック

4. プレビューブランチ を なし に変更

5. 保存 をクリック

この設定により、本番ブランチ以外へのpushではビルドが実行されなくなります。

補足

ビルド回数の確認方法ですが、現時点ではダッシュボードで月間ビルド数を確認する機能は提供されていないようです^[2]。Deploymentsタブで個別のデプロイ履歴は確認できますが、月間の累計は自分で数える必要があります。

また、Direct Upload（Wranglerを使った直接アップロード）はビルド回数にカウントされません^[3]。CIからのデプロイを多用する場合は、Git連携ではなくDirect Uploadを使う方法も検討できます。