SuperAPI AI 工具集

convex-migrate-rehearse

部署与运维

查看项目

更新于 10-16 03:06

技能介绍

用途:把 Convex 的模式变更与数据回填先在预览部署上演练,确认数据符合新校验器后再推广到生产,避免直接在生产推送时不通过校验而失败。

主要能力:组合 deploy-guard(目标分类与确认)、migrate(先可选后收紧的改进模式)和 @convex-dev/migrations(分批、可恢复的回填)。流程为:只读导出快照 npx convex export --path snapshot.zip;在改动代码前用变更前代码创建预览并导入快照;在预览上按“新字段设为可选并推送→编写并运行回填→收紧校验器再推送”的顺序演练;在预览上验证应用函数;取得明确确认后再对生产重复同一序列。

使用方式与关键命令:预览需要 Preview Deploy Key(控制台 Project Settings → Deploy Keys → Preview)导出为 CONVEX_DEPLOY_KEY,属付费功能;创建预览 npx convex deploy --preview-create migrate-<slug>,导入 npx convex import snapshot.zip --deployment migrate-<slug>,预览推送 npx convex deploy --preview-name migrate-<slug>(不要用 convex dev)。回滚用 npx convex import snapshot.zip --replace --prod,且快照写入之后的数据会丢失,应缩短推广窗口。

限制与注意:快照含真实数据,属敏感信息,完成后本地删除、切勿提交;预览约 5 天自动过期;回填须走 @convex-dev/migrations 而非整表一次性 mutation;若无预览密钥,可在个人 dev 部署上演练并说明。此项为“演练并推广”流程,仅需讲解可选后收紧、无真实数据的场景对应 migrate。其他细节(如定价、额外配置)暂未提供。