Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

GitLab 連携

最終更新 Markdown で表示Agent セットアップ

Cloudflare Pages の各プロジェクトを GitLab リポジトリに接続できます。ブランチへ変更をプッシュするたびに、Cloudflare がコードを自動でデプロイします。

機能

自動デプロイに加え、Cloudflare の GitLab 連携では、デプロイの監視、管理、プレビューを GitLab 上で直接行えます。いつもの作業の流れを離れずに状況を把握できます。

カスタムブランチ

Pages は、最初にプッシュしたブランチを 本番環境 に設定します。デフォルトブランチ（例: main）以外がプロジェクトの本番ブランチである場合は、Settings > Builds > Branch control を開き、Production branch のドロップダウンから別のブランチを選びます。

プレビューデプロイ を使うと、本番ブランチへマージして本番へデプロイする前に、プロジェクトのバージョンを確認できます。どのプレビューブランチを自動デプロイするかは、ブランチビルド制御 で設定します。設定するには、Settings > Builds > Branch control を開き、Preview branch のオプションを選びます。Custom branches を使うと、自動プレビューデプロイに含めるブランチと除外するブランチを指定できます。

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

追加の設定なしで、都度デプロイをスキップできます。コミットメッセージの先頭に [CI Skip]、[CI-Skip]、[Skip CI]、[Skip-CI]、[CF-Pages-Skip] のいずれかのフラグを付けると、Pages はそのデプロイを省略します。プレフィックスの大文字・小文字は区別しません。

チェックランとプレビュー URL

1 つのリポジトリに 1 つまたは複数のプロジェクトを接続している場合（モノレポ など）、各ビルドの状況は GitLab 上の GitLab コミットステータス ↗ で確認できます。

状況は、コミット横のステータスアイコンを選ぶか、GitLab リポジトリの Build > Pipelines から確認できます。次の例では、緑のチェックマークを選ぶとチェックランの結果を確認できます。

GitLab のステータス

リポジトリでは、チェックランは次のように表示されます。いずれかのステータスを選ぶと、そのデプロイの プレビュー URL を表示できます。

GitLab のコミットステータス

何らかの理由（CI Skip、ビルドウォッチパス、ブランチデプロイ制御など）でビルドがスキップされた場合、チェックラン／コミットステータスは表示されません。

アクセスを管理する

GitLab 上の会社プロジェクトや個人プロジェクトから、Cloudflare Pages アプリを使って Cloudflare Workers へプロジェクトをデプロイできます。

組織へのアクセス

GitHub と GitLab のどちらでも、会社プロジェクトや個人プロジェクトから Cloudflare Pages へデプロイできます。

Cloudflare Pages に GitLab アカウントへのアクセスを許可すると、そのアカウントがアクセスできる組織、グループ、名前空間へのアクセスも自動で付与されます。これらの組織とグループへのアクセス管理は GitLab 側で行います。

アクセスを削除する

GitLab アカウントへの Cloudflare Workers のアクセスは、GitLab の Authorized Applications ページ ↗ から削除できます。Cloudflare Workers という名前のアプリケーションを探し、Revoke を選んでアクセスを取り消します。

GitLab アプリケーションの Cloudflare Workers は Workers と Pages のプロジェクトで共有されています。GitLab へのアクセスを削除すると、Workers と Pages の新規ビルドは無効になります。ただし、以前のデプロイは引き続き Cloudflare Pages でホストされます。

Cloudflare の GitLab アプリを再インストールする

Git 連携に関する問題が起きたときは、Cloudflare Pages に関連付けた GitHub または 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. プロジェクト作成ページにリダイレクトされ、アカウント一覧に GitLab アカウントまたは組織が表示されます。
  6. 以前壊れていたプロジェクトで、新しいデプロイを試します。

役に立ちましたか？