SuperAPI AI 工具集

convex-backup

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:同时完成备份的两半工作——定期导出快照,以及通过恢复演练证明数据确实可恢复,而非只做导出就假定安全。

主要能力:

  1. 演练前用 deploy-guard 分类并声明所备份的部署(读取/导出安全,恢复目标为一次性预览,绝不指向生产)。
  2. 生成快照:npx convex export --path backup-<date>.zip;若应用存储文件,可加 --include-file-storage。
  3. 制定计划:按数据变化速度与可容忍丢失量(RPO)推荐频率,例如通过 CI/cron 每日执行 npx convex export 到用户自有的持久存储,并设定保留窗口。Convex 平台自带备份,本能力补充用户自有、可迁移的副本。
  4. 恢复演练:需要 Preview Deploy Key 作为 CONVEX_DEPLOY_KEY(付费层功能);不可用时改为针对新的个人 dev 部署演练并说明。用 npx convex deploy --preview-create restore-drill-<date> 从当前代码创建一次性预览,再用 npx convex import backup-<date>.zip --deployment restore-drill-<date> --replace 导入(import 用 --deployment 按名称指定,没有 --preview-name)。
  5. 校验恢复:读回数据(MCP 表看行数、data/runOneoffQuery 抽查),确认关键表行数符合预期且样本真实存在;恢复成功但落地 0 行即视为失败演练。
  6. 报告结果:说明备份内容、是否真正恢复并验证(或失败及原因)、建议的计划与保留策略,以及恢复到生产的手册:npx convex import backup.zip --replace --prod,由 deploy-guard 把关,并注明快照之后写入的数据会丢失。
  7. 卫生:完成后删除本地快照副本(属敏感真实数据),演练预览自动过期,绝不提交备份文件。

适用场景:Convex 项目需要可验证的备份与恢复流程,尤其是上线前确认灾难恢复能力。

限制:恢复演练需要 Preview Deploy Key(付费层),否则只能在 dev 部署演练;快照为敏感真实数据;恢复演练绝不指向生产。