Files
CyberGril/docs/r1/DEPLOY-ROLLBACK.md
T

2.6 KiB

HEL-780 · 8310独立部署/回滚材料(总工执行,尚未部署)

  1. 审核确切任务分支和提交,复核8310空闲;保持8300和其他既有服务不动。建立 /opt/cybergril-api/releases/<release>/,构建生产前端和独立Python≥3.11虚拟环境,按 IMPLEMENTATION 安装。服务账号示例为 cybergril,由总工按主机现有规范准备,不默认root。
  2. 准备代码目录外的 /opt/cybergril-data/,仅服务账号可写。首次上线保持数据库没有真实档案,不运行创建POST、不替用户创建。已有数据升级前,停止该API,用 SQLite backup API 做一致快照至独立回滚目录;禁止只复制正在写入中的主DB文件而漏WAL。
  3. 将 current 指向已审核release,审查 deploy/cybergril-api.service.example 后再安装服务。模板限制单进程,端口8310,持久数据目录独立;模板不改防火墙、证书或反向代理。按现场systemd版本核对保护项和目录权限。uvicorn直连SSE无代理缓冲;若后续接代理,需另行配置关闭SSE缓冲。
  4. 启动前确认 web/dist/index.html、models配置、虚拟环境可读和数据目录可写。启动时自动执行幂等增量建表、epoch加一和pending取消。使用 GET /api/health、GET /api/companion(首装预期404)与普通页面做无副作用检查;模型健康异常先记录,不改共享网关、不循环调参。不要以调用preview之外的写接口作为上线健康检查。
  5. 审核通过后由总工记录服务URL、release、SHA、journalctl -u cybergril-api 日志位置,再交用户创建。普通入口 /,演示 /?demo=1。本轮不切换8300入口,不合并、不部署。

回滚:

  • 停止 cybergril-api,记录当时release与数据快照;把 current 切回上一已审核release,重新启动。数据目录保持原样,不随release回退或删除。R1迁移仅增表,保留旧表;每次重新启动epoch递增。回滚到纯前端版本时真实API将不可用,应明确告知,服务器数据仍保留。
  • 数据恢复与代码回滚分别处理。需恢复快照时先再次备份当前数据,由总管确认可接受的数据时间点,再由总工停服恢复;禁止把本地测试库覆盖用户库。
  • 取消部署的清理只针对新建8310服务及明确release;不删除 /opt/cybergril-data/,不停止8300或其他项目服务。

限制:单用户内网、无新增鉴权体系;应沿既有内网访问边界使用。尚无产品级备份功能,本文的升级快照属于部署运维操作;真实页面不会声称已自动备份。SQLite单worker是当前约束,后续扩展需独立设计。