デプロイフック（Deploy Hooks）を使うと、ソースリポジトリへのコミット以外のイベントからもデプロイを起動できます。イベントソースごとに固有の URL を発行でき、その URL へ HTTP POST リクエストを送ると新しいデプロイが始まります。既存または新規のワークフローに Pages を組み込めます。たとえば次の用途があります。
- ヘッドレス CMS のコンテンツが変わったときに、自動で新しいビルドをデプロイする
- 独自の CI/CD パイプラインを組み、条件を満たしたときだけデプロイする
- cron で決まった時刻にサイトを更新する
デプロイフックを作成する手順は次のとおりです。
-
Cloudflare ダッシュボードで Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
Pages プロジェクトを選びます。
-
Settings > Builds を開き、Add deploy hook を選んで設定を開始します。
デプロイフックを設定するには、次の 2 つのパラメーターを入力します。
- Deploy hook name: デプロイフックの一意な識別子（例:
contentful-site） - Branch to build: デプロイフックがビルドするリポジトリブランチ
設定が完了すると、デプロイフック固有の URL を使えるようになります。URL と、コピー用の POST リクエストスニペットの両方が表示されます。
デプロイフックへリクエストを送るたびに、新しいビルドが起動します。デプロイログの Source 列で、どのデプロイがデプロイフックから起動されたかを確認できます。
デプロイフックはプロジェクトに一意に紐づき、利用時に追加の認証は不要です。柔軟に使える一方で、これらの URL は機密情報やアプリケーションシークレットと同じ扱いで保護してください。
不正利用が疑われる場合は、そのデプロイフックを削除し、新しいものを発行してください。
CMS ごとに Pages のデプロイフックとの連携方法は異なります。ここでは、よく使われる CMS の手順を説明します。
Contentful は Webhooks 機能で Cloudflare Pages と連携できます。Contentful のプロジェクト設定で Webhooks を開き、新しい Webhook を作成し、URL 欄にデプロイフック固有の URL を貼り付けます。転送するイベントは任意で指定できます。デフォルトでは、Contentful はプロジェクトのすべての操作で Pages のデプロイを起動するため、頻度が高すぎることがあります。Create や Publish など、特定のイベントだけに絞れます。
Ghost サイトで Custom Integration を作成すると、Pages のデプロイを起動できます。Ghost サイトの設定で Integrations ページを開き、新しい Custom Integration を作成します。
作成した Custom Integration には、複数の webhooks を付けられます。Add webhook を選び、Event に Site changed (rebuild) を指定します。Target URL にデプロイフック固有の URL を貼り付けます。この webhook を作成すると、Ghost サイトが変わるたびに Cloudflare Pages アプリケーションが再デプロイされます。
Sanity プロジェクトの Settings ページで Webhooks セクションを開き、次の図のようにデプロイフック URL を追加します。デフォルトでは、Sanity プロジェクト内のすべてのデータセットに対して Pages のデプロイフックが起動します。Dataset 欄で production など、特定のデータセットだけに通知を絞れます。
無料の WP Webhooks プラグインを入れると、WordPress から Pages のデプロイフックを起動できます。プラグインには Send Data on New Post、Send Data on Post Update、Send Data on Post Deletion などのトリガーがあり、WordPress のデータが変わるたびに新しい Pages デプロイを起動できます。プラグイン設定のサイドバーでトリガーを選び、Add Webhook URL ↗ にデプロイフック固有の URL を貼り付けます。
Strapi Admin Panel で webhook を設定すると、Cloudflare Pages との連携を強化できます。Strapi Admin Panel で次の操作をします。
- Settings を開きます。
- Webhooks を選びます。
- Add New Webhook を選びます。
- Name 欄に、新しい webhook の一意な名前を入力します。
- URL 欄に、Cloudflare のデプロイフック固有の URL を貼り付けます。
Strapi Admin Panel では、イベントに応じて webhook を起動できます。Strapi のエントリやメディアアセットが作成、更新、削除されたときに、Cloudflare Pages サイトの新しいデプロイを自動で作るように設定できます。
webhook の設定は、Cloudflare サイトを動かしている production ↗ の Strapi アプリケーションに追加してください。
Storyblok でデプロイフックを設定すると、イベントを起動できます。Storyblok のスペースで Settings を開き、Webhooks までスクロールします。Story published & unpublished 欄にデプロイフックを貼り付け、Save を選びます。
