请求Ordercloud从现有US West沙箱迁移至新沙箱的操作流程指导

一、前期准备 #

• 确认权限：确保拥有新旧两个沙箱的管理员权限，包括API密钥、应用注册权限，避免迁移中出现权限拦截
• 数据备份：
  • 用Ordercloud API批量导出核心数据：
    • 店铺/站点：调用GET /v1/stores接口，带上pageSize=100参数批量拉取，导出JSON格式文件
    • 产品目录：依次拉取GET /v1/catalogs及关联的categories、products、variants数据
    • 用户与角色：导出GET /v1/users、GET /v1/securityroles及用户-角色映射关系
    • 订单记录：若需迁移历史数据，调用GET /v1/orders并分页处理大数量数据
  • 代码库备份：将本地或Git仓库的完整代码库（含前端、后端API集成代码）做分支备份，确认依赖包（如Ordercloud SDK版本）与新旧沙箱兼容
• 新沙箱验证：确认新沙箱的区域、Ordercloud版本与旧沙箱一致，避免版本差异引发兼容性问题

二、代码库迁移 #

• 替换沙箱配置：在代码中更新旧沙箱的ClientID、ApiUrl（新沙箱专属域名）、Scope参数，确保所有API请求指向新沙箱
• 依赖包校验：运行npm install（或对应包管理命令），验证Ordercloud SDK版本适配新沙箱，版本差异较大时同步升级/降级SDK
• 本地测试：启动代码，测试核心功能（店铺展示、产品浏览、用户登录），确认能正常调用新沙箱API

三、数据迁移 #

• 批量导入数据：
  • 调用Ordercloud批量API接口上传：
    • 店铺/站点：使用POST /v1/stores/batch，将导出的JSON数据按接口要求整理后批量上传
    • 产品与目录：先导入catalogs，再导入categories，最后导入products和variants，保持关联ID一致
    • 用户与角色：先导入securityroles，再导入users，最后通过POST /v1/userroles/batch绑定用户角色
  • 历史订单：先确认新沙箱是否支持导入历史订单，避免状态差异导致数据异常，可先导入测试订单验证
• 数据校验：导入完成后，通过API或Ordercloud后台逐一核对：
  • 店铺数量、配置信息与旧沙箱是否一致
  • 产品目录层级、关联关系是否正确
  • 用户角色权限是否匹配

四、切换与验证 #

• 访问地址切换：有自定义域名的话，将DNS解析指向新沙箱地址；内部测试环境直接修改配置文件中的地址
• 全流程测试：覆盖核心业务场景：
  • 用户注册/登录、权限验证
  • 产品搜索、加购、下单
  • 店铺管理、订单处理
• 旧沙箱保留：暂时保留旧沙箱7-14天作为回滚备份，确认新沙箱稳定后再删除旧沙箱数据

五、注意事项 #

• 迁移前暂停旧沙箱操作：通知团队停止在旧沙箱的写入操作，防止数据不一致
• 控制API调用速率：Ordercloud API有调用限制，批量导入时每批次请求间隔1-2秒，避免触发限流
• 自定义字段同步：若有自定义扩展字段，需先在新沙箱配置相同的字段定义，再导入对应数据

内容的提问来源于stack exchange，提问作者Vinay Sutrave