SuperAPI AI 工具集

kortix-rollback

部署与运维

查看项目

更新于 10-15 23:47

技能介绍

用途:将 Kortix 生产环境回滚到更早的已发布版本 vX.Y.Z,是发布的逆操作,复用该版本已有的构建产物,不重新构建。回滚是临时的,不会改动 VERSION 或主干,下一次发布即自动覆盖。

主要能力:一条命令同时处理前端与后端。前端通过 Vercel API 立即重新提升旧构建;后端(api、gateway)打开一个需评审的 PR 固定 image.tag,合并后由 Argo CD 滚动到 :vX.Y.Z 镜像。因此回滚共两步:派发工作流,再合并后端 PR。

使用方式: gh workflow run rollback-prod.yml --repo kortix-ai/suna --ref main
-f version=vX.Y.Z -f reason="<incident summary>" -f confirm="ROLLBACK PROD"

回滚前必须人工检查数据库漂移,工作流无法检测: git diff vX.Y.Z..origin/prod -- packages/db/migrations 若全为增量迁移(ADD、CREATE IF NOT EXISTS)则安全;出现 DROP、RENAME、ALTER TYPE 或新增 NOT NULL 需停下评估。

限制与注意:不能回滚到某表面尚不存在的版本,工作流会检查镜像并跳过缺失表面。不要手动把 Argo 的 targetRevision 指向回滚分支,否则后续发布会静默卡住;仅支持基于 Git 的镜像标签 PR 方式。后端合并需人工评审,无强制推送路径。恢复方式是走正常发布流程,无需手动撤销回滚。