Nexus Agent
69068e2e39
部署对齐三项后端能力：启动/周期收尾僵尸批量任务、30 天推送日志 purge、已安装且版本不低于主站时跳过批量安装 Agent。 Co-authored-by: Cursor <cursoragent@cursor.com>
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# 2026-06-08 — 批量安装 Agent 已安装且版本足够则跳过
|
||
|
||
## 摘要
|
||
|
||
批量/单机「安装 Agent」时：若子机已安装且 Agent 版本 **不低于** 主站 `web/agent/agent.py` 中的版本，则跳过 SSH 安装；仅当未安装或版本更低时才执行 `install.sh`。
|
||
|
||
## 动机
|
||
|
||
批量勾选已部署 Agent 的服务器会重复跑完整安装脚本，耗时长且可能短暂中断 Agent。
|
||
|
||
## 涉及文件
|
||
|
||
- `server/utils/agent_version.py` — 主站版本 SSOT + 版本比较
|
||
- `server/application/server_batch_common.py` — `agent_install_skip_result`、Redis/SSH 版本探测
|
||
- `server/application/services/server_batch_service.py` — `_run_install_agent` 跳过逻辑
|
||
- `server/api/servers.py` — 单机 `install-agent` 对齐
|
||
- `tests/test_agent_version.py`
|
||
|
||
## 迁移 / 重启
|
||
|
||
- 无 DB 变更；需重启 API
|
||
|
||
## 行为
|
||
|
||
| 子机状态 | 动作 |
|
||
|----------|------|
|
||
| 无 agent_api_key 且无 agent_version | 执行安装 |
|
||
| 已安装，版本 ≥ 主站 | 跳过（success，stdout 说明） |
|
||
| 已安装，版本 < 主站 | 执行安装（等同升级） |
|
||
|
||
版本来源优先级：Redis `heartbeat:{id}` → MySQL `agent_version` → SSH 读取 `/opt/nexus-agent/agent.py`。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
pytest tests/test_agent_version.py -q
|
||
bash scripts/local_verify.sh
|
||
```
|