备份、升级与回滚
围绕配置、数据库、Redis 和网关数据准备可恢复的升级流程。
升级前准备一致性备份
保留原始 deploy/stack.env、MySQL 数据和迁移历史、Redis 数据、加密网关数据及 HTTPS 配置。备份应存放在服务器之外,并通过独立恢复演练确认可用。
- 不要直接复制运行中的 MySQL 数据目录。
- 缺失原加密密钥时,已有加密数据可能无法恢复。
- 记录当前源码版本、镜像 ID 和数据模式版本。
在维护窗口执行升级
先验证备份、目标版本、数据库迁移和关键客户端,再在维护窗口更新生产环境。--local 首次部署与更新共用同一安装命令:先拉取或上传新源码,再在原应用目录重跑,保留原配置和数据。它不自动获取目标版本;下载归档没有 .git 元数据,不应直接 git pull。
git pull --ff-only && ./install.sh --local --public --port 18080在原应用目录执行,先处理本地修改并确认当前跟踪分支。固定版本或手动上传时,准备目标源码后仅重跑原安装命令;仅本机或 HTTPS 部署沿用原参数。
./deploy/stack.sh status
./deploy/stack.sh logs在实际部署目录执行:--local 使用原应用源码目录,默认 root 下载方式使用 /opt/bosapi。Linux 按 Docker 权限加 sudo,Mac 上不要加。
按层验证,而不是只看容器状态
- 容器健康:应用、MySQL 与 Redis 均处于预期状态。
- 管理流程:管理员可以登录并完成 MFA。
- 业务调用:模型列表与真实模型请求成功。
- 数据核对:调用记录、用量和安全事件符合预期。
明确应用回滚与数据回滚的边界
恢复旧镜像不会自动撤销数据库迁移。只有在确认旧应用兼容当前数据库时才复用旧镜像,否则需要恢复成套备份。回滚后重新验证登录、模型调用和数据读取。
按部署版本核对具体能力与操作。 查看文档适用范围