SuperAPI AI 工具集

convex-backup

数据与分析

查看项目

更新于 10-16 03:06

技能介绍

用途:为一套 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。