Files
Nexus/docs/changelog/2026-05-24-agent-upgrade-deps-check.md
2026-07-08 22:31:31 +08:00

1.1 KiB
Raw Permalink Blame History

2026-05-24 Agent 升级依赖检测 + 自动安装 + 回滚 + 版本锁定

日期: 2026-05-24 动机: upgrade-agent 只下载 agent.py 不检查/更新依赖,新版引入新 pip 包会导致服务启动失败;install.sh 依赖不锁版本,子机可能装到与中心不一致的版本 变更摘要:

  • upgrade-agent 增加 Python 版本预检:SSH 检测 venv Python >= 3.10,不满足返回 424 + 提示手动修复
  • Python 版本 OK 后自动 pip install 更新依赖(锁版本,与中心 requirements.txt 对齐)
  • 升级前备份旧 agent.py.bak,失败自动回滚
  • install.sh 依赖版本锁定:fastapi==0.115.6 uvicorn==0.34.0 httpx==0.28.1 python-multipart==0.0.19
  • 升级 SSH 超时从 60s 调至 120spip install 首次可能较慢)

涉及文件: server/api/servers.py, web/agent/install.sh

是否需迁移: 否

验证方式:

  • Python < 3.10 时返回 424 + 提示手动修复
  • Python OK + 依赖完整时 pip install 跳过已装包,升级正常
  • Python OK + 依赖缺失时 pip install 自动补装
  • 升级失败时旧 agent.py 自动恢复