部署管理

默认情况下，使用以下任一方式时会创建新版本并立即部署到 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 页面。

   Go to Workers & Pages ↗

2. 选择你的 Worker > Edit code（编辑代码）。

3. 进行更改，然后选择 Deploy（部署） 旁边的 down arrow（向下箭头） > Save（保存）。

上传版本后，你可以创建将流量路由到该版本的部署。

使用 wrangler versions deploy 命令，按照交互式提示选择版本并将其设置为 100%：

npx wrangler versions deploy

yarn wrangler versions deploy

pnpm wrangler versions deploy

你也可以将流量百分比设置为低于 100%，以启动渐进式部署。

1. 在 Cloudflare 仪表板中，前往 Workers & Pages 页面。

   Go to 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 Workers 迁移到 ES modules 了解如何将 Worker 从 service worker 格式迁移到 ES modules 格式。

不支持上传更改 Durable Object 类生命周期的版本。这适用于声明式 exports 字段和旧版 migrations 数组——任何创建、删除、重命名或转移 Durable Object 类的更改都必须通过 wrangler deploy 应用。