ブランチデプロイメント制御

Gitリポジトリに接続されていると、Pagesは自動的にデプロイする環境とブランチを制御することを可能にします。デフォルトでは、Pagesは本番環境またはプレビュー環境にコミットするたびにデプロイをトリガーします。しかし、ブランチデプロイメント制御を使用することで、プロジェクトごとに自動デプロイを好みに合わせて設定できます。

本番ブランチ制御

直接アップロード

If your project is a Direct Upload project, you will not have the option to configure production branch controls. To update your production branch, you will need to manually call the Update Project endpoint in the API.

curl --request PATCH \
"https://api.cloudflare.com/client/v4/accounts/{account_id}/pages/projects/{project_name}" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data "{\"production_branch\": \"main\"}"

デプロイメントオプションを設定するには、Pagesプロジェクト > 設定 > ビルドとデプロイメント > 本番デプロイメントの設定に移動します。Pagesは最初にプッシュしたブランチを本番環境に設定するようにデフォルトで設定されますが、別のブランチに本番を設定することもできます。

また、自動本番ブランチデプロイメントを有効にするボックスをチェックすることで、本番ブランチの自動デプロイメント動作を有効または無効にすることができます。新しい本番ブランチ制御を有効にするには、設定を保存する必要があります。

プレビューブランチ制御

自動プレビューデプロイメントを設定する際には、選択できるオプションが3つあります。

• すべての非本番ブランチ: デフォルトでは、Pagesはプレビューブランチへのすべてのコミットを自動的にデプロイします。
• なし: すべてのプレビューブランチの自動ビルドをオフにします。
• カスタムブランチ: 特定のプレビューブランチの自動デプロイをカスタマイズします。

カスタムプレビューブランチ制御

カスタムブランチを選択することで、自動デプロイから含めたいブランチと除外したいブランチを指定できます。設定フィールドには2つの方法で入力できます。

• 静的ブランチ名: 含めたいまたは除外したいブランチの正確な名前を入力します（例: stagingやdev）。
• ワイルドカード構文: ワイルドカードを使用して複数のブランチに一致させます。ルールの先頭または末尾にワイルドカードを指定できます。設定の実行順序は（1）除外、（2）含む、（3）スキップです。Pagesは最初に除外設定を処理し、その後に含む設定に進みます。ブランチがどちらにも一致しない場合はスキップされます。

ワイルドカード構文

ワイルドカード（*）は、ルール内で使用される文字です。単独で配置して任意のものに一致させることも、ルールの先頭または末尾に配置してブランチ設定をより良く制御することもできます。ワイルドカードはゼロまたはそれ以上の文字に一致します。たとえば、fix/で始まるすべてのブランチに一致させたい場合は、fix/*というルールを作成して、fix/1、fix/bugs、またはfix/のような文字列に一致させます。

例1:

fix/、feat/、またはchore/のようなブランチプレフィックスをワイルドカード構文で強制したい場合、次のルールで特定のブランチを含めたり除外したりできます。

• プレビューブランチを含める: fix/*, feat/*, chore/*

• プレビューブランチを除外する: “

ここでは、指定されたプレフィックスを持つブランチを含め、他のすべてを除外します。この例では、除外オプションは空のままにされています。

例2:

dependabot ↗が作成する各PRのデプロイメントを防ぎたい場合、次のようにしてそれらのブランチを除外できます。

• プレビューブランチを含める: *

• プレビューブランチを除外する: dependabot/*

ここでは、Pagesはdependabotで始まるブランチを除外し、すべてのブランチを含めます。この例では、除外オプションはdependabot/で始まるブランチはビルドされないことを意味します。

例3:

リリースプレフィックスのブランチのみをデプロイしたい場合、次のルールを使用できます。

• プレビューブランチを含める: release/*

• プレビューブランチを除外する: *

これにより、release/で始まるブランチのみがデプロイされます。