Agent 升级与版本回退

发起一次升级

1. 进入“Agent 管理 → 版本升级”，选择“发起升级”。按维护计划选择推荐稳定版本或其他已发布版本。
2. 选择在线、平台兼容且当前版本低于目标版本的节点。不可选择的节点会保留并显示原因，不表示平台没有发现它们。
3. 核对每批数量与失败阈值，先从小批次开始。确认目标后提交升级；普通升级不要求额外流程审批。
4. 等待准备、下发、切换和重启验证，最后核对目标版本心跳。不要把下载完成当作升级成功。

常见升级状态

如何处理失败

下载、连接、准备或切换前自检失败，会停止对应节点升级；这些失败不会要求其他已成功升级的节点一起回滚。失败阈值针对可能已进入版本切换之后的失败，不能只看批次失败数量判断影响。

“暂无可用版本”通常意味着环境尚未发布可信版本或目录校验失败。联系交付管理员检查版本目录，不要注销 Agent 或重新生成注册令牌。

何时使用版本回退

只有明确需要安装较旧版本时，才由具备独立回退权限的人员使用“版本回退”。该入口要求目标版本低于当前版本、再次输入目标版本，并经过独立高风险审批。它不同于升级失败后由系统处理的自动回滚。