需采用滚动更新策略：一、配置Deployment的RollingUpdate类型，设置maxSurge=1、maxUnavailable=0，并确保readinessProbe指向/actuator/health/readiness；二、设minReadySeconds=60以等待注册与元数据加载完成；三、通过PreStop Hook调用/shutdown接口实现优雅下线，配合terminationGracePeriodSeconds=90；四、ConfigMap版本变更须同步更新Pod模板触发重建。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 Kubernetes 集群中部署了 Hermes Agent，并希望在不中断消息转发与元数据同步能力的前提下完成版本升级，则需避免使用全量停机式更新。以下是实现 Hermes Agent 滚动更新的具体方法：
一、配置 Deployment 的 RollingUpdate 策略
滚动更新依赖于 Kubernetes Deployment 控制器对 ReplicaSet 的有序管理，通过控制新旧 Pod 的增删节奏，确保 Hermes Agent 始终有活跃实例维持连接注册、心跳上报及消息路由功能。关键在于显式声明更新类型并合理设置扩缩容边界参数。
1、编辑 Hermes Agent 的 Deployment YAML 文件，在 spec.strategy.type 字段设置为 RollingUpdate。
2、在 spec.strategy.rollingUpdate 下定义 maxSurge 和 maxUnavailable 参数，例如：
maxSurge: 1
maxUnavailable: 0
3、确保 readinessProbe 已正确配置，路径应指向 Hermes Agent 提供的健康检查端点（如 /actuator/health/readiness），且 initialDelaySeconds 与 periodSeconds 足够覆盖启动与初始化耗时。
4、执行 kubectl apply -f hermes-agent-deployment.yaml 触发更新，Kubernetes 将按策略逐步替换 Pod。
二、利用 minReadySeconds 控制就绪节奏
minReadySeconds 可防止新 Pod 在刚就绪后立即被纳入服务流量，尤其适用于 Hermes Agent 这类需完成 ZooKeeper/Nacos 注册、Topic 元数据加载、消费者组协调器同步等前置动作的中间件代理。该字段强制控制器等待指定秒数后再将其视为“稳定可用”，从而规避灰度期间的路由抖动或元数据不一致问题。
1、在 Deployment 的 spec 段添加 minReadySeconds: 60（建议值，依据 Hermes Agent 实际初始化时间调整）。
2、确认 Hermes Agent 启动日志中已输出 "Agent registered successfully" 或类似标识后，再允许其进入 Service Endpoints 列表。
3、验证 Endpoint 数量变化：执行 kubectl get endpoints hermes-agent-svc，观察旧 Pod 退出与新 Pod 加入是否呈阶梯式交替发生。
三、结合 PreStop Hook 执行优雅下线
Hermes Agent 在被终止前需主动注销服务发现节点、清空本地缓存、提交最后偏移位点并断开下游连接，否则可能导致消息重复消费、元数据残留或客户端短暂不可达。PreStop Hook 提供容器生命周期钩子，在 SIGTERM 发送前执行自定义命令或 HTTP 请求，保障下线动作原子性。
1、在容器定义的 lifecycle.preStop.exec.command 中写入关闭脚本路径，例如：
["/bin/sh", "-c", "curl -X POST http://localhost:8080/actuator/shutdown"]
2、若 Hermes Agent 未暴露 shutdown 端点，可改用 lifecycle.preStop.httpGet 调用其内置的优雅退出接口，路径需与实际监听地址一致。
3、同步设置 terminationGracePeriodSeconds: 90，确保预留足够时间完成钩子执行与容器终止流程。
四、基于 ConfigMap/Secret 版本联动更新
Hermes Agent 的配置常通过挂载 ConfigMap 或 Secret 注入，但 ConfigMap 更新默认不会触发 Pod 重建。若 Agent 支持运行时重载（如监听文件变更），仍需配合滚动更新机制确保所有实例统一加载新版配置；否则必须将配置版本嵌入 Pod 模板，使每次配置变更成为 Deployment 的显式更新事件。
1、为 ConfigMap 添加唯一标签，例如 version: v2.4.1-config，并在 Deployment 的 volumes 中引用该标签。
2、修改 Deployment 的 spec.template.spec.volumes.configMap.name 或使用 configMapKeyRef 显式绑定带版本后缀的 ConfigMap 名称。
3、更新 ConfigMap 内容后，**必须同步修改 Deployment 的 pod template（如添加注解 configmap-version: v2.4.1）**，以触发 Kubernetes 识别模板变更并发起滚动更新。
