CLI:部署后端 Workers
本步骤仅部署10 个核心 Worker(node1-auth 到 node10-ai)。增值服务(如 zship-provider1-service)不包含在内。
1. 先填写必要 secrets
Section titled “1. 先填写必要 secrets”部署前确保 node1-auth-service 的关键 secrets 已配置。查看服务的 wrangler.jsonc,使用:
npx wrangler secret put <SECRET_NAME>对每个必要 secret 执行。在服务目录下运行,例如:
cd backend/node1-auth-servicenpx wrangler secret put JWT_SECRET# ... 其他需要的 secretscd ../..1.5 与 Dev Console 推送变量的关系
Section titled “1.5 与 Dev Console 推送变量的关系”wrangler secret put、以及在 wrangler.jsonc 中配置 vars 后执行 deploy,本质都是把配置写到 Cloudflare 上对应的 Worker。若你在 Dev Console → Deploy → Environment variables 里编辑并 Push 到某个 Worker,目标也是同一套线上环境,只是少了手敲命令、且常与一键部署放在同一工作流里。日常改非敏感变量时 CLI 与 Dev Console 二选一即可;敏感密钥仍建议使用 secret put 或在 Dashboard / Dev Console 中以 Secret 形式保存,勿提交进仓库。
2. 执行远程 D1 迁移
Section titled “2. 执行远程 D1 迁移”将迁移应用到 Cloudflare D1(非本地):
cd backend/node1-auth-service && npx wrangler d1 migrations apply zship-auth --remote && cd ../..cd backend/node2-support-service && npx wrangler d1 migrations apply zship-support --remote && cd ../..cd backend/node3-pay-service && npx wrangler d1 migrations apply zship-pay --remote && cd ../..cd backend/node4-notify-service && npx wrangler d1 migrations apply zship-notify --remote && cd ../..cd backend/node5-blog-service && npx wrangler d1 migrations apply zship-blog --remote && cd ../..cd backend/node7-site-service && npx wrangler d1 migrations apply zship-site --remote && cd ../..cd backend/node8-prompt-service && npx wrangler d1 migrations apply zship-prompt --remote && cd ../..cd backend/node9-checkin-service && npx wrangler d1 migrations apply zship-checkin --remote && cd ../..cd backend/node10-ai-service && npx wrangler d1 migrations apply zship-ai --remote && cd ../..3. 按顺序部署 Worker
Section titled “3. 按顺序部署 Worker”逐个部署后端服务。推荐顺序(auth 优先,其余按依赖):
cd backend/node1-auth-service && pnpm run deploy && cd ../..cd backend/node2-support-service && pnpm run deploy && cd ../..cd backend/node3-pay-service && pnpm run deploy && cd ../..cd backend/node4-notify-service && pnpm run deploy && cd ../..cd backend/node5-blog-service && pnpm run deploy && cd ../..cd backend/node6-cdn-service && pnpm run deploy && cd ../..cd backend/node7-site-service && pnpm run deploy && cd ../..cd backend/node8-prompt-service && pnpm run deploy && cd ../..cd backend/node9-checkin-service && pnpm run deploy && cd ../..cd backend/node10-ai-service && pnpm run deploy && cd ../..或使用根目录脚本(如有):
pnpm deploy:authpnpm deploy:support# 等等4. 若出现「binding target not found」
Section titled “4. 若出现「binding target not found」”- 确认没有重命名任何 Worker(与 wrangler.jsonc 中
name一致) - 确认已登录正确 Cloudflare 账号(
npx wrangler whoami) - 按依赖顺序部署(无 binding 的 Worker 先部署)
5. 检查清单
Section titled “5. 检查清单”- 必要 auth secrets 已填写
- 远程 D1 迁移已完成
- 所有 Worker 部署成功
- 无 binding-not-found 错误