用途:该能力解决备份的两个环节——定期导出 Convex 数据快照,以及证明快照确实可恢复。它复用 migrate-rehearse 的快照导出、preview 部署、快照导入机制,但目标指向恢复而非前向变更。
主要能力与用法:先由 deploy-guard 对要备份的部署做分类与告知(读取/导出是安全的,演练恢复目标是丢弃型 preview,绝不动生产环境)。取快照:npx convex export --path backup-<date>.zip,若应用存储文件需加 --include-file-storage。备份计划:按数据变化速度与可容忍丢失量(RPO)推荐节奏,例如经 CI/cron 每日执行 npx convex export 并落到用户可控的持久存储,设定保留窗口;Convex 平台自带备份,此方式额外提供用户自有的可移植副本。
恢复演练:(a) 前置条件为 CONVEX_DEPLOY_KEY 形式的 Preview Deploy Key(付费档功能),不可用时改为对新建的个人 dev 部署演练并说明;(b) 用当前代码创建一次性 preview:npx convex deploy --preview-create restore-drill-<date>;(c) 导入快照:npx convex import backup-<date>.zip --deployment restore-drill-<date> --replace(import 用 --deployment 按名称指定,没有 --preview-name);(d) 断言恢复:读回数据核验关键表行数与真实记录样本,落地 0 行即为失败演练。最后如实报告演练结果、推荐计划与保留策略、以及恢复手册(npx convex import backup.zip --replace --prod,须经 deploy-guard 把关,并说明快照后写入丢失的注意事项)。
限制与卫生:从未恢复过的备份只是希望,务必运行或提议运行演练;演练目标必须是一次性 preview 或 dev,绝不指向生产;快照属于敏感真实数据,完成后删除本地副本、禁止提交,演练 preview 会自动过期。