3.9 KiB
52.118 Docker 升级记录(2026-11-10)
当前版本
- MaxKB 源码:
v3.2-refact,提交79fa2cf4a27c0363946317af8c8e5c49f50fee0d。 - markitdown 源码:
develop-mineru-2.7.6,提交94d2f22b3c3930e2c9bbcd9aaf1d85b0c1ff9ed5。 - 发布版本:
refact-276-20261110-1;容器airag、mineru-api、unis-hub-worker、unis-gateway。 - 离线包:
/home/tlw/unis/deploy_artifacts_upgrade/refact-276-20261109-1-cuda/package-refact-276-20261110-1。 - 原数据:
/home/tlw/unis/maxkb-fresh-init-20261109;当前运行的数据副本:/home/tlw/unis/maxkb-refact-276-20261110-1。 - 原模型目录:
/home/tlw/unis/mineru-models,只读挂载,未覆盖。 - 私有备份与回退状态:
/home/tlw/unis/releases/refact-276-20261110-1-cuda;含旧容器配置及敏感环境信息,勿公开。
打包调整
目标分支通过服务器远程仓库克隆到独立目录,未覆盖原源码目录。最终包由 build-compat-release.sh 基于已构建的 refact-276-20261109-1 镜像生成,BASE_IMAGES.txt 记录基础镜像 ID,SOURCES.txt 记录源码提交,SHA256SUMS.txt 覆盖交付文件。原基础发布包和构建文件仍保留在同一发布目录下的 package-retry8。
知识库镜像固定 Pydantic 2.12.3,避免 MCP 1.19.0 引用被 Pydantic 2.14 移除的接口。CUDA 镜像使用 Gradio 5.50.0 解决目标分支的 Gradio/Pydantic 版本冲突,并补装基础镜像缺少的 pycairo;构建时检查加速器依赖和 pip check。NVIDIA 容器需显式使用 nvidia runtime。
执行与验证
旧版 PostgreSQL 已正常关闭并以 pg_controldata 验证关闭状态,再制作归档和独立副本。新版本在副本上完成迁移,旧版四个容器已改名保留。airag 和 mineru-api 健康,网关与 Hub worker 在运行;GPU 检查识别到一块 NVIDIA 设备。
服务器侧 8989 的登录、注册、聊天入口返回 200;/mindmap/ 和 9898 返回工作台重定向。容器内 8080 登录及注册入口返回 200;宿主机 8080 未监听,不能将其描述为已在宿主机开放。浏览器已检查登录和注册页面;admin 首页引用的入口静态资源可访问。
通过 pipeline 调用 MinerU 2.7.6,使用临时生成的一页英文 PDF,接口返回 200 且识别出测试文字。未验证普通用户真实登录、向量检索、图片 OCR、Word、VLM、总结、保存和导出等端到端流程。平台默认解析服务和大模型仍需按需配置。
后续发现迁移只创建了统一角色表,没有执行旧版管理员导入。已在当前容器执行项目内 unify_platform_roles,恢复原有 admin 的统一管理员身份;实际登录页面已确认 AI 应用、工具、模型和系统管理入口恢复。升级脚本已增加这一初始化步骤;已有管理员角色时不会重新导入,避免撤销的管理员权限被重新授予。
按后续要求,已执行可选增量脚本 seed_local_v2_parsers.py,登记“传统管道”“混合引擎”“VLM引擎”三种 2.7.6 解析资源,分别授权内置管理员和普通用户角色查看、使用。重复执行未新增记录;三个资源的接口连接和角色权限已检查。Pipeline 已用测试 PDF 验证;Hybrid 和 VLM 的实际模型加载与推理尚未验收。脚本不设置工作台默认解析器。
回退
先停止新版本写入并确认新版数据处理方案。回退后旧版数据不会自动包含升级后新写入的数据:
cd /home/tlw/unis/deploy_artifacts_upgrade/refact-276-20261109-1-cuda/package-refact-276-20261110-1
sudo python3 upgrade.py rollback --release-dir /home/tlw/unis/releases/refact-276-20261110-1-cuda --start-old
脚本会校验容器身份、停止并保留新版容器及副本,恢复原容器名称并尝试启动原版;若旧数据存在其他使用方会拒绝启动。执行前应复核状态,不要手工删除备份、模型或新旧数据目录。