Cloudflare Pages の各プロジェクトを GitHub または GitLab リポジトリに接続できます。接続すると、ブランチへの変更をプッシュするたびに、Cloudflare がコードを自動でデプロイします。
Git リポジトリを Cloudflare Pages プロジェクトに接続すると、次の機能も使えます。
- カスタムブランチのプレビューデプロイ。本番デプロイには影響せず、リポジトリ内の任意のブランチへのコミットにプレビュー URL を生成します。
- プルリクエスト(PR)内のプレビュー URL。
- Git リポジトリ内のビルドおよびデプロイのステータスチェック。
- コミットメッセージによるビルドのスキップ。
これらの機能により、チームの普段の開発フローを離れることなく、GitHub または GitLab 上でデプロイを管理できます。
Cloudflare は、Cloudflare Pages を GitHub および GitLab リポジトリに接続できます。現時点では、セルフホストの GitHub または GitLab インスタンスへの接続はサポートしていません。
別の Git プロバイダー(例: Bitbucket)やセルフホストインスタンスを使っている場合は、Direct Upload プロジェクトから始め、Wrangler CLI と CI/CD プロバイダー(例: GitHub Actions)でデプロイできます。
Cloudflare アカウントに Git アカウントが紐づいていない場合、初めて Git に接続 するとき、または新しい Git アカウントを追加するときに、GitHub または GitLab へのインストール設定を求められます。画面の指示に従い、Cloudflare の Git 連携を許可してください。
Git 連携がインストール済みかどうかは、次のページで確認できます。
- GitHub Applications ページ ↗(組織に所属している場合は、Switch settings context を選んで GitHub 組織の設定を開きます)
- GitLab Authorized Applications ページ ↗
組織アカウントへのアクセスの詳細は、GitHub および GitLab のガイドを参照してください。
リポジトリ接続に紐づく Git インストールは、Pages プロジェクトを開き、Settings > Builds で Git Repository の Manage を選ぶと管理できます。
リポジトリアクセスの管理や、再インストールによるインストール問題の切り分けに便利です。詳細は GitHub および GitLab のガイドを参照してください。
Git 連携済みのプロジェクトで、コミットをプッシュするたびにデプロイしたくない場合は、ブランチ制御 でビルドを無効化/一時停止できます。
-
Cloudflare ダッシュボードで Workers & Pages を開きます。
Workers & Pages を開く ↗ -
Pages プロジェクトを選びます。
-
Build > Branch control の編集へ進み、Enable automatic production branch deployments をオフにします。
-
プレビューの自動デプロイを止めるには、Preview branch を None (Disable automatic branch deployments) に変更することもできます。
そのあと、Wrangler から Pages プロジェクトへ直接デプロイすれば、Git リポジトリの変更でビルドが自動起動しません。