部署 Sandbox 应用

Sandbox 运行在 Containers 上。有关部署命令、Workers Builds 和 rollout 标志，请参阅 部署 Containers 和 Rollouts。

要将 exposePort() 放到自定义域名上，请参阅 在自定义域名上配置预览 URL。

Worker 依赖 @cloudflare/sandbox。容器镜像必须来自同一发行线（该版本模板或文档中的 Dockerfile 与基础镜像标签）。

当你升级 npm 包时：

1. 更新同一发行线的 Dockerfile 或镜像引用。

2. 运行 wrangler deploy，以便发布新镜像。

3. 如果 Worker 和镜像必须一起切换，请使用立即 rollout 部署：

   npmyarnpnpm

   npx wrangler deploy --containers-rollout=immediate

   对破坏性的包与镜像组合使用此方式。请参阅 Rollouts。

1. 如果 image 是 Dockerfile 路径，请先启动 Docker。注册表镜像引用在部署时不需要 Docker。

2. 在项目根目录执行：

   npmyarnpnpm

   npx wrangler deploy

3. 确认 Worker URL 可响应，然后实际调用一条 sandbox 路由。

首次部署可能需要数分钟，以便镜像完成预配。

生产环境请使用 wrangler deploy，以便包与镜像可以一起更新。

非生产环境的 Workers Builds 默认使用 wrangler versions upload，这不会发布新镜像。这些 Worker 不会生成 版本 URL（它们实现了 Durable Objects）。请使用 wrangler dev，或使用运行 wrangler deploy 的预发布 Worker 或 environment 进行测试。

更多详情：生产前。

• 部署 Containers
• Rollouts
• 在自定义域名上配置预览 URL