Sandbox アプリケーションをデプロイする

Sandbox は Containers 上で動きます。デプロイコマンド、Workers Builds、ロールアウトフラグについては、Containers のデプロイ と Rollouts を参照してください。

exposePort() をカスタムドメインで使うには、カスタムドメインでプレビュー URL を設定する を参照してください。

Worker は @cloudflare/sandbox（または @cloudflare/sandbox@next）に依存します。コンテナイメージは、同じリリースラインから取得してください（そのバージョンのテンプレートまたはドキュメントにある Dockerfile とベースイメージタグ）。

npm パッケージを上げるときは:

1. 同じライン向けに Dockerfile またはイメージ参照を更新します。

2. wrangler deploy を実行し、新しいイメージを公開します。

3. Worker とイメージを同時に切り替える必要がある場合は、即時ロールアウトでデプロイします。

   npmyarnpnpm

   npx wrangler deploy --containers-rollout=immediate

   安定版から @next への切り替えや、その他の破壊的なパッケージ／イメージの組み合わせに使います。移行 と Rollouts を参照してください。

安定版パッケージと @next イメージを混在させないでください。逆も同じです。

1. image が Dockerfile のパスである場合は、Docker を起動します。レジストリのイメージ参照では、デプロイ時に Docker は不要です。

2. プロジェクトのルートから次を実行します。

   npmyarnpnpm

   npx wrangler deploy

3. Worker の URL が応答することを確認し、サンドボックスのルートを試します。

初回デプロイは、イメージのプロビジョニング中に数分かかることがあります。

本番では wrangler deploy を使い、パッケージとイメージを一緒に更新できるようにします。

本番以外の Workers Builds は、デフォルトで wrangler versions upload を使います。このコマンドは新しいイメージを公開しません。これらの Worker では Preview URLs は生成されません（Durable Objects を実装しているため）。wrangler dev でテストするか、wrangler deploy を実行するステージング Worker または environment でテストしてください。

詳細: 本番の前に。

• Containers のデプロイ
• Rollouts
• カスタムドメインでプレビュー URL を設定する
• Sandbox SDK 1.0 プレビューへ移行する