用途:为一套 Convex 应用建立备份,并通过真实还原演练验证备份可恢复,而不仅是导出文件。
主要能力:
- 生成快照导出:npx convex export --path backup-<date>.zip;若应用存储文件,加 --include-file-storage。
- 制定备份计划:建议按数据变化速度与可容忍丢失量(RPO)设定节奏,例如经 CI/cron 每日执行导出并保存到用户可控的持久存储,设置保留窗口。Convex 平台自身备份之外,额外提供用户自有可移植副本。
- 还原演练:从当前代码创建一次性预览 npx convex deploy --preview-create restore-drill-<date>,再还原快照 npx convex import backup-<date>.zip --deployment restore-drill-<date> --replace(导入按部署名指定,无 --preview-name)。
- 断言恢复:读回数据核对关键表行数与真实记录样本;还原“成功”但 0 行即判定演练失败。
- 报告与恢复手册:说明备份内容、还原是否实际执行并验证、失败原因、建议计划与保留窗口,以及恢复到生产的命令 npx convex import backup.zip --replace --prod,需经 deploy-guard 把关并注明快照后写入丢失。
使用前提与限制:
- 预览部署密钥作为 CONVEX_DEPLOY_KEY 属付费层能力;不可用时改在全新个人开发部署上演练并说明。
- 演练只还原到一次性预览或开发部署,绝不指向生产;还原目标与备份来源必须是不同部署。
- 快照含敏感真实数据:完成后删除本地副本,绝不提交到版本库;演练预览会自动过期。
- 仅做恢复方向;正向 schema 变更属于 migrate-rehearse。