デプロイ管理

既定では、次のいずれかを使うと、新しいバージョンが作成され、すぐにトラフィックの 100% へデプロイされます。

• wrangler deploy
• Workers Builds
• Workers Script Upload API

これらの手順を分け、バージョンのアップロードとデプロイを独立した操作にできます。新しいバージョンをいつ本番に出すかを、正確に制御できます。

wrangler versions upload コマンドを使います。

npx wrangler versions upload

yarn wrangler versions upload

pnpm wrangler versions upload

1. Cloudflare ダッシュボードで、Workers & Pages ページを開きます。

   Workers & Pages を開く ↗

2. Worker を選び、Edit code を開きます。

3. 変更を加えたら、Deploy の横の 下向き矢印 を選び、Save を選びます。

バージョンをアップロードしたあと、そのバージョンへトラフィックを流すデプロイを作成できます。

wrangler versions deploy コマンドを使い、対話プロンプトに従ってバージョンを選び、100% に設定します。

npx wrangler versions deploy

yarn wrangler versions deploy

pnpm wrangler versions deploy

トラフィックの割合を 100% 未満にして、段階的デプロイ を始めることもできます。

1. Cloudflare ダッシュボードで、Workers & Pages ページを開きます。

   Workers & Pages を開く ↗

2. Worker を選び、Deployments を開きます。

3. Promote deployment を選び、デプロイするバージョンを選びます。

API、ライブラリ SDK、Terraform からも、バージョンとデプロイを直接作成できます。例は Infrastructure as Code を参照してください。

デプロイを作成できるのは、Worker にアップロードした直近 100 バージョンだけです。

新しい Workers プロジェクトを初めて作るときは、C3 または wrangler deploy を使う必要があります。Worker の初回アップロードに wrangler versions upload を使うと失敗します。

wrangler versions upload でアップロードするバージョンでは、Service Worker 構文はサポートされません。ES modules 形式を使う必要があります。

Service Worker 形式から ES modules 形式への移行方法は、Service Workers から ES modules へ移行する を参照してください。

Durable Object クラスのライフサイクルを変えるバージョンのアップロードはサポートされていません。宣言的な exports フィールドと、レガシーの migrations 配列の両方に当てはまります。Durable Object クラスの作成、削除、名前変更、移譲を行う変更は、wrangler deploy で適用してください。