コンテンツにスキップ

Git統合

Cloudflareは、Cloudflare PagesをGitHubおよびGitLabリポジトリに接続して、プロジェクトの新しい変更を探すことをサポートしています。Pagesは現在、自己ホスト型のGitHubまたはGitLabインスタンスをサポートしていません。

カスタムブランチ

特定のブランチを使用してプロジェクトの本番ビルドを表すカスタムGitワークフローがある場合、Pagesダッシュボードでプロジェクトを作成（または既存のプロジェクトを管理）する際にカスタムブランチを指定できます。Settings > Builds & deploymentsに移動し、Configure Production deploymentsボタンをクリックします。production branchのドロップダウンメニューから、任意の他のブランチに本番ブランチを変更できます。

また、プレビュー展開を使用して、productionにマージする前にプロジェクトの新しいバージョンがどのように見えるかをプレビューできます。さらに、Pagesでは、ブランチビルドコントロールを使用して、どのプレビューブランチがビルドおよび展開されるかを構成できます。

Pagesプロジェクトでこれを構成するには、Settings > Builds & deployments > Configure preview deploymentに移動し、Custom branchesを選択します。ここで、自動展開から含めたいブランチと除外したいブランチを指定できます。詳細については、ブランチビルドコントロールのドキュメントを参照してください。

組織のアクセス

オープンソースチーム、会社、またはサイドプロジェクトからCloudflare Pagesにプロジェクトを展開できます。GitHubおよびGitLabの両方で利用可能です。

GitHub

Cloudflare PagesがGitHubアカウントにアクセスすることを承認する際、個人アカウントまたはGitHub上の所属組織へのアクセスを指定できます。その組織にCloudflare Pagesのインストールを追加できるようにするには、ユーザーアカウントがオーナーであるか、組織内で適切な役割（つまり、GitHub Apps Managerの役割）を持っている必要があります。これらの役割に関する詳細は、GitHubのドキュメント ↗で確認できます。

GitLab

Cloudflare PagesがGitLabアカウントにアクセスすることを承認することで、Cloudflare Pagesが使用するためにGitLabアカウントがアクセスできる組織、グループ、および名前空間へのアクセスが自動的に許可されます。これらの組織やグループへのアクセス管理はGitLabによって行われます。

GitHubアカウントへのアクセスを削除する

GitHubアカウントへのCloudflare Pagesのアクセスを削除するには、GitHubのApplicationsページ ↗を表示します。GitHubへのアクセスを削除すると、新しいビルドも無効になりますが、サイトの最後のビルドはCloudflare Pagesを介してホストされ続けます。

GitLabアカウントへのアクセスを削除する

GitLabアカウントへのCloudflare Pagesのアクセスを削除するには、User Settings > Applications > Authorized Applicationsに移動します。Cloudflare Pagesと呼ばれるアプリケーションを見つけ、Revokeボタンを選択してアクセスを取り消します。

コミットメッセージを介して特定のビルドをスキップする

特に設定を必要とせず、アドホックベースでデプロイメントをスキップすることができます。コミットメッセージのプレフィックスとして[CI Skip]、[CI-Skip]、[Skip CI]、[Skip-CI]、または[CF-Pages-Skip]フラグを追加すると、Pagesはそのデプロイメントを省略します。プレフィックスは大文字と小文字を区別しません。

Gitインストールを再インストールする

Git統合に関連する問題が発生した場合、1つの潜在的なトラブルシューティング手順は、Cloudflare Pagesインストールに関連するGitHubまたはGitLabアプリケーションをアンインストールして再インストールすることです。各Gitプロバイダーのプロセスは以下に示されています。

GitHub

  1. GitHubのインストール設定ページに移動します：
    1. 個人アカウントの場合はhttps://github.com/settings/installations。
    2. 組織アカウントの場合はhttps://github.com/organizations/<YOUR_ORGANIZATION_NAME>/settings/installations。
  2. Cloudflare Pagesのインストールがある場合は、Configureをクリックし、**Uninstall “Cloudflare Pages”**をクリックします（“Cloudflare Pages”のインストールがない場合、ユーザーは何もする必要はありません）。
  3. https://dash.cloudflare.com/[YOUR_ACCOUNT_ID]/workers-and-pagesのWorkers & Pagesの概要ページに戻ります。Create application > Pages > Connect to Gitをクリックします。
  4. + Add accountボタンをクリックし、追加したいGitHubアカウントをクリックして、Install & Authorizeをクリックします。
  5. GitHubアカウントまたは組織がアカウントリストに表示されるプロジェクト作成ページにリダイレクトされるはずです。
  6. 以前に壊れていたプロジェクトで新しいデプロイメントを試みます。

GitLab

  1. GitLabのアプリケーション設定ページに移動します： https://gitlab.com/-/profile/applications ↗
  2. Cloudflare Pagesのインストールが存在する場合は、“Revoke”ボタンをクリックします。
  3. https://dash.cloudflare.com/[YOUR_ACCOUNT_ID]/workers-and-pagesのWorkers & Pagesの概要ページに戻ります。Create application > Pages > Connect to Gitをクリックします。
  4. 上部のGitLabタブを選択し、+ Add accountボタンをクリックし、追加したいGitLabアカウントをクリックして、モーダル「Authorize Cloudflare Pages to use your account?」でAuthorizeをクリックします。
  5. GitHubアカウントまたは組織がアカウントリストに表示されるプロジェクト作成ページにリダイレクトされるはずです。
  6. 以前に壊れていたプロジェクトで新しいデプロイメントを試みます。

トラブルシューティング

プロジェクト作成

このリポジトリは別のCloudflareアカウントのCloudflare Pagesプロジェクトに使用されています。

異なるCloudflareアカウント間で同じGitHub/GitLabリポジトリを使用することは許可されていません。そのCloudflareアカウントでPagesプロジェクトにリポジトリを使用するには、他のCloudflareアカウントでそのリポジトリを使用しているPagesプロジェクトを削除する必要があります。

デプロイメント

デプロイメントや失敗に関連する問題が発生した場合、プロジェクトダッシュボードを確認して、表示されているSCMインストールの警告があるかどうかを確認してください。以下のスクリーンショットのように表示されます。

Pagesプロジェクトの設定でデプロイメントを一時停止する

Cloudflare Pagesダッシュボードに表示されるエラーを解決するには、以下の手順に従ってください。

このプロジェクトはあなたのGitアカウントから切断されています。これによりデプロイメントが失敗する可能性があります。

この問題を解決するには、適用可能なSCMプロバイダーのGitインストールの再インストールセクションに記載されている手順に従ってください。アンインストールして再インストールしても問題が解決しない場合は、サポートに連絡してください。

Cloudflare PagesはあなたのGitアカウントに正しくインストールされていません。これによりデプロイメントが失敗する可能性があります。

この問題を解決するには、適用可能なSCMプロバイダーのGitインストールの再インストールセクションに記載されている手順に従ってください。アンインストールして再インストールしても問題が解決しない場合は、サポートに連絡してください。

Cloudflare Pagesのインストールが一時停止されています。これによりデプロイメントが失敗する可能性があります。

GitHubのインストール設定に移動します：

  • 個人アカウントの場合はhttps://github.com/settings/installations
  • 組織アカウントの場合はhttps://github.com/organizations/<YOUR_ORGANIZATION_NAME>/settings/installations

Cloudflare PagesアプリケーションのConfigureをクリックします。ページの下部までスクロールし、Unsuspendをクリックして、Cloudflare Pagesが今後のデプロイメントを行えるようにします。

プロジェクトはもはや存在しないリポジトリにリンクされています。これによりデプロイメントが失敗する可能性があります。

このCloudflare Pagesプロジェクトに関連するリポジトリを削除または転送した可能性があります。削除されたリポジトリの場合、新しいCloudflare Pagesプロジェクトを削除されていないリポジトリで作成する必要があります。転送されたリポジトリの場合、リポジトリを元のGitアカウントに転送するか、転送されたリポジトリで新しいCloudflare Pagesプロジェクトを作成する必要があります。

リポジトリにアクセスできません。これによりデプロイメントが失敗する可能性があります。

このリポジトリをインストールのリポジトリアクセス設定から除外した可能性があります。GitHubのインストール設定に移動します：

  • 個人アカウントの場合はhttps://github.com/settings/installations
  • 組織アカウントの場合はhttps://github.com/organizations/<YOUR_ORGANIZATION_NAME>/settings/installations

Cloudflare PagesアプリケーションのConfigureをクリックします。Repository accessの下で、Cloudflare Pagesプロジェクトに関連するリポジトリがリストに含まれていることを確認してください。

Cloudflare Pages Gitインストールに内部的な問題があります。

これはCloudflare Pages SCMシステムの内部エラーです。Gitインストールを再インストールを試みることができますが、問題が解決しない場合は、サポートに連絡してください。

関連リソース

Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings