必须执行快速回滚操作：一、Kubernetes滚动更新历史回滚；二、手动替换DaemonSet模板并强制重启；三、通过ConfigMap切换运行时配置实现逻辑降级；四、离线环境下的本地包替换回滚。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在升级Hermes Agent后遇到功能异常、连接失败或指标上报中断等问题，需立即恢复至先前稳定版本，则必须执行快速回滚操作。以下是几种可独立实施的部署回滚方案：
一、使用Kubernetes滚动更新历史回滚
当Hermes Agent以Deployment形式部署在Kubernetes集群中，且revisionHistoryLimit未被设为0时，系统会自动保留历史ReplicaSet，可通过kubectl直接回退至上一版本镜像。
1、执行命令查看可用的历史修订版本：kubectl rollout history deployment/hermes-agent -n hermes-system
2、确认目标回滚版本对应的REVISION编号（例如：2）
3、执行回滚指令：kubectl rollout undo deployment/hermes-agent --to-revision=2 -n hermes-system
4、等待Pod重建完成，并验证新Pod中容器镜像标签是否已还原为v1.8.3
二、手动替换DaemonSet模板并强制重启
适用于Hermes Agent以DaemonSet方式部署且未启用自动滚动更新策略的场景。该方法绕过版本控制机制，直接覆盖当前生效的YAML定义并触发全节点Pod重建。
1、从备份目录中获取上一稳定版本的hermes-agent-daemonset.yaml文件
2、修改文件中image字段值为registry.example.com/hermes/agent:v1.8.3
3、执行应用命令：kubectl apply -f hermes-agent-daemonset.yaml -n hermes-system
4、检查各节点Pod状态：kubectl get pods -n hermes-system -o wide | grep Running
三、通过ConfigMap切换运行时配置实现逻辑降级
当无法立即变更Agent二进制或容器镜像时，可利用Hermes Agent支持的动态配置加载能力，临时禁用高风险模块并恢复兼容性参数，达到等效于旧版本行为的效果。
1、定位当前生效的配置ConfigMap：kubectl get configmap -n hermes-system | grep agent-config
2、编辑该ConfigMap，将enable_feature_x字段值由true改为false
3、将max_collection_interval_seconds数值调整为30（原v1.9.0默认为15）
4、保存后，所有Agent Pod将在60秒内自动重载配置，无需重启进程
四、离线环境下的本地包替换回滚
针对物理机或无容器运行时的部署模式，需直接替换主机上的Agent程序文件与服务配置，确保降级操作不依赖网络和镜像仓库。
1、停止当前运行的Hermes Agent服务：systemctl stop hermes-agent
2、备份当前二进制文件：cp /usr/local/bin/hermes-agent /usr/local/bin/hermes-agent.bak.$(date +%Y%m%d)
3、将已验证的旧版本二进制文件复制至目标路径：cp ~/downloads/hermes-agent-v1.8.3 /usr/local/bin/hermes-agent
4、恢复对应版本的配置模板与插件目录：cp -r ~/backups/hermes-v1.8.3/conf/ /etc/hermes/
5、重新启动服务并验证进程版本：systemctl start hermes-agent && hermes-agent --version
