technical

Staging Migration / Seed 顺序与回滚说明

固定 Toolplane 当前默认的 staging 发布顺序、空库 bootstrap 规则,以及代码回退时的 redeploy 路径。

Audience

开发者 / 测试 / 部署维护

Updated

2026-03-28

Source

docs/staging-release-sequence.zh-CN.md

当前结论

  • 模块四 Day 4 已完成,默认 staging 发布命令现已固定为 npm run release:staging
  • 默认发布顺序是 d1:migrate:staging -> deploy:staging -> verify:smoke
  • 默认 deploy:staging 现在会固定使用 opennextjs-cloudflare deploy --cacheChunkSize 5
  • seed 只保留给 bootstrap;代码回退与纯重发则走 release:staging:redeploy

当前命令分流

  • 默认重复发布:npm run release:staging
  • 空库 bootstrap:npm run release:staging:bootstrap
  • 代码回退 / 重新部署:npm run release:staging:redeploy
  • 若再次出现 R2 incremental cache 上传波动,先确认没有绕开默认低并发 deploy 路径
  • 当前不应把 d1:seed:staging 混进每次正常发布

默认下一步

  • 模块四 Day 5 已完成:完整 staging 发布演练与部署操作文档都已收口
  • 模块五 Day 4 已完成:subscription、credits、usage 与 accepted execution 已进入共享 foundation,并接到 Billing / Usage 工作台
  • 模块五 Day 6 已完成:provider endpoint access model 已进入共享 foundation,并接到 Developers 工作台
  • 模块五 Day 7 已完成:marketplace 的 listing、category、version、install 数据结构已进入共享 foundation,并接到 Marketplace 工作台
  • 模块五 Day 10 已完成:扩展框架验收文档已入库;下一轮真正实现优先级已锁定为组织、成员、权限,其次才是 Auth / RBAC enforcement