03. 部署后端 Workers

路径 B（Dev Console） — 本章适用于 Dev Console 工作流。若偏好命令行，请参阅 路径 A：部署后端 Workers。

仅部署 10 个核心 Worker（node1-auth 到 node10-ai）。增值服务（如 zship-provider1-service）不包含在内。

1. 先填写必要密钥

在 Dev Console → Deploy 标签 → Environment / Secrets 区块：

1. 填写 node1-auth-service 的 auth 相关密钥（登录和初始化必需）。
2. 填写其他必需的后端启动变量。
3. 可选：支付提供商密钥（Stripe、Creem）和 AI 提供商密钥可稍后添加，若上线不依赖这些功能。

2. 通过 Dev Console 执行远程迁移

在部署代码前，先执行远程数据库迁移：

1. 在 Dev Console → Deploy 标签 → Migration 区块。
2. 点击 Migrate All（全部迁移），或逐个迁移各后端。
3. 等待所有迁移完成。Worker 依赖已存在的 schema 和表，未迁移就部署常会导致难以排查的运行时错误。

3. 通过 Pipeline 部署后端 Workers

在 Dev Console → Deploy 标签 → Pipeline：

1. 确认上一章已完成步骤 0（pnpm install）和 1（Provision Resources）。
2. 步骤 2（Remote Migration）应已在上一步完成。
3. 点击 Run All 执行整条流水线，或仅执行步骤 3（Deploy Backend）。
4. Dev Console 会依次部署各 Worker，可在控制台日志中查看进度和错误。

备选：逐个部署 Worker

也可以从画布上的服务卡片逐个部署，点击每个后端服务卡片上的 Deploy 按钮。

4. 若出现「binding target 找不到」

常见原因：

• 改了 Worker 名 — 若修改了默认 Worker 名称，binding 会无法匹配。
• 部署顺序 — Worker 在首次部署时创建。若 service binding 失败，目标 Worker 可能尚未存在；可尝试点击 Run All，让 Pipeline 按依赖顺序部署。
• 账号不一致 — 资源在账号 A 创建，但 Wrangler 登录的是账号 B。

5. 本章结束前检查清单

• 必需的 auth 密钥已填写
• 若需要，支付/AI 密钥已填写
• 远程迁移已成功执行
• 10 个 Worker 均已部署成功
• 无 binding-not-found 错误阻塞启动

以上均满足后，即可进入前端部署。