Cloudflare の Git 連携 では、新規または既存の Worker を GitHub または GitLab リポジトリに接続できます。プッシュ時に Worker のビルドとデプロイが自動で走ります。
新しい Worker を作成し、GitHub または GitLab リポジトリに接続するには、次の手順を行います。
-
Cloudflare ダッシュボードで、Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
Create application を選びます。
-
Import a repository の横の Get started を選びます。
-
Import a repository で Git account を選びます。
-
一覧からインポートするリポジトリを選びます。検索バーで結果を絞ることもできます。
-
プロジェクトを設定し、Save and Deploy を選びます。
-
割り当てられた
workers.devサブドメインで Worker をプレビューします。
既存の Worker を GitHub または GitLab リポジトリに接続するには、次の手順を行います。
-
Cloudflare ダッシュボードで、Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
リポジトリに接続する Worker を選びます。
-
Settings、続けて Builds を選びます。
-
Connect を選び、案内に従ってリポジトリを Worker に接続し、ビルド設定 を構成します。
-
Git リポジトリにコミットをプッシュすると、ビルドが走り、Worker にデプロイされます。
Wrangler 設定ファイルがないリポジトリを接続すると、autoconfig がフレームワークを検出し、Cloudflare Workers 向けにプロジェクトを設定する プルリクエスト を作成します。
- Autoconfig がフレームワークを検出し、必要な設定を生成します
- 必要な設定変更を含むプルリクエストがリポジトリに作成されます
- マージ前に確認できるプレビューデプロイが生成されます
- PR をマージすると、プロジェクトはデプロイできる状態になります
対応フレームワークと作成されるファイルの詳細は、既存プロジェクトのデプロイ を参照してください。作成される PR の詳細は 自動プルリクエスト を参照してください。
ビルドの状態とビルドログは、Worker の Deployments タブ下部にある View build history から確認できます。
ビルドが成功した場合は、Version History に作られた新しい バージョン の View build を選ぶと、ビルドの詳細を確認できます。そこには、Version ID の下に、そのバージョンが生成した プレビュー URL もあります。
Containers を使う Worker では、本番ブランチで wrangler deploy を使い、コンテナイメージとコンテナインスタンスを更新できるようにします。プレビュービルドは引き続きデフォルトで wrangler versions upload を使い、コンテナイメージは更新しません。各コンテナは Durable Object から管理されるため、これらの Worker ではプレビュー URL は生成されません。Containers のデプロイ を参照してください。
Worker と GitHub または GitLab リポジトリの接続を切るには、次の手順を行います。
-
Cloudflare ダッシュボードで、Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
リポジトリから切断する Worker を選びます。
-
Settings、続けて Builds を選びます。
-
Disconnect を選びます。
Worker のリポジトリを切り替えたい場合は、先にビルドを無効にしてから再接続し、新しいリポジトリを選びます。
自動デプロイだけを止め、ビルドは自動で走らせて バージョン として保存する（Active Deployment には昇格させない）場合は、デプロイコマンドを npx wrangler versions upload に更新します。