fix(deploy): 通过更新脚本恢复受控仓库镜像定义

2026-10-05 11:35:47 +08:00
parent 125b12a1d8
commit e3d760c5ab
5 changed files with 146 additions and 5 deletions
@@ -257,6 +257,17 @@ UPDATE_SERVICES='easyai-server easyai-web model-conversion-worker' ./update.sh

 Linux 旧部署如果因本地 Compose 修改无法拉取仓库，可在检查差异后设置 `UPDATE_ADOPT_LEGACY_CONFIG=1`。脚本需要 Python 3 和 PyYAML；先校验合并配置，再将原始配置和冲突文件备份到 `data/deployment-backups/`，本地差异保存在 `data/deployment-config/legacy-compose.json`，仓库继续管理新增服务和配置。其他业务代码修改、未支持的文件冲突或无法表示的删除会阻止迁移，不启动容器。活动 Nginx 配置不会被改写。

+迁移默认保留本地固定镜像。如果已确认某个核心服务的旧 digest 应恢复为部署仓库的镜像定义，可显式指定该服务；只允许本次更新范围中的 `easyai-server`、`easyai-web` 或 `ws-gateway`，其他镜像和本地配置继续保留：
+
+```bash
+UPDATE_MODE=full UPDATE_NON_INTERACTIVE=1 \
+UPDATE_SERVICES='easyai-server easyai-web' \
+UPDATE_ADOPT_LEGACY_CONFIG=1 \
+UPDATE_RESTORE_REPOSITORY_IMAGES='easyai-web' ./update.sh
+```
+
+该操作由脚本备份并迁移本地 Compose 差异，随后快进部署仓库；不需要直接编辑生产 Compose。执行前须检查所有有效 Compose 文件；如果已存在覆盖文件固定同一服务的镜像，不能仅恢复主文件就宣称已解除固定。更新后须检查有效配置中的镜像及容器实际 digest。
+
 没有自更新能力的历史脚本可先通过 Git 获取新版 `update.sh` 和 `scripts/` 到临时目录，再以 `UPDATE_PROJECT_DIR=/实际/easyai/目录` 执行新版脚本；配置迁移、仓库更新和容器操作仍由 `update.sh` 完成。已有 managed updater 应使用仓库分配的独立内网地址，避免在主后端暂时停止时占用其固定地址。

 - **查看帮助**：`./update.sh -h` 或 `./update.sh --help`