跳转到内容

CLI:部署后端 Workers

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

部署前确保 node1-auth-service 的关键 secrets 已配置。查看服务的 wrangler.jsonc,使用:

Terminal window
npx wrangler secret put <SECRET_NAME>

对每个必要 secret 执行。在服务目录下运行,例如:

Terminal window
cd backend/node1-auth-service
npx wrangler secret put JWT_SECRET
# ... 其他需要的 secrets
cd ../..

wrangler secret put、以及在 wrangler.jsonc 中配置 vars 后执行 deploy,本质都是把配置写到 Cloudflare 上对应的 Worker。若你在 Dev ConsoleDeployEnvironment variables 里编辑并 Push 到某个 Worker,目标也是同一套线上环境,只是少了手敲命令、且常与一键部署放在同一工作流里。日常改非敏感变量时 CLI 与 Dev Console 二选一即可敏感密钥仍建议使用 secret put 或在 Dashboard / Dev Console 中以 Secret 形式保存,勿提交进仓库。

将迁移应用到 Cloudflare D1(非本地):

Terminal window
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 ../..

逐个部署后端服务。推荐顺序(auth 优先,其余按依赖):

Terminal window
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 ../..

或使用根目录脚本(如有):

Terminal window
pnpm deploy:auth
pnpm deploy:support
# 等等

4. 若出现「binding target not found」

Section titled “4. 若出现「binding target not found」”
  • 确认没有重命名任何 Worker(与 wrangler.jsonc 中 name 一致)
  • 确认已登录正确 Cloudflare 账号(npx wrangler whoami
  • 按依赖顺序部署(无 binding 的 Worker 先部署)
  • 必要 auth secrets 已填写
  • 远程 D1 迁移已完成
  • 所有 Worker 部署成功
  • 无 binding-not-found 错误