1.1 KiB
1.1 KiB
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 调至 120s(pip install 首次可能较慢)
涉及文件: server/api/servers.py, web/agent/install.sh
是否需迁移: 否
验证方式:
- Python < 3.10 时返回 424 + 提示手动修复
- Python OK + 依赖完整时 pip install 跳过已装包,升级正常
- Python OK + 依赖缺失时 pip install 自动补装
- 升级失败时旧 agent.py 自动恢复