HermesAgent蓝绿部署实战教程

本文深入解析了在生产环境中安全升级Hermes Agent的蓝绿部署实战方案，涵盖Kubernetes命名空间隔离、Docker Compose双栈编排、阿里云计算巢实例替换以及环境变量+运行时路由四种灵活适配不同基础设施的落地方式，每种方法均提供可直接执行的命令、配置要点与验证步骤，确保零停机、可回滚、全链路可控，是运维与AI工程团队实现高可用Agent升级不可或缺的实操指南。

如果您希望在生产环境中安全升级 Hermes Agent 而不中断服务，则需采用蓝绿部署策略。该策略通过并行维护两套独立运行环境（蓝色为当前稳定版本，绿色为待上线新版本），在验证无误后将流量瞬间切换，从而规避部署风险。以下是具体实现方式：

一、基于 Kubernetes 的蓝绿部署

利用 Kubernetes 命名空间与 Service 标签选择器，可隔离蓝绿两套 Hermes Agent 实例，实现零停机升级。该方法适用于已接入 K8s 集群的云原生部署场景。

1、为蓝色环境创建独立命名空间：
执行命令 kubectl create namespace hermes-blue。

2、在 hermes-blue 命名空间中部署当前稳定版 Hermes Agent，使用标签 version: blue 与 app: hermes-agent 标识。

3、为绿色环境创建另一命名空间：
执行命令 kubectl create namespace hermes-green。

4、在 hermes-green 命名空间中部署新版本 Hermes Agent，使用相同 app 标签但 version: green。

5、配置两个独立的 Service，均匹配 selector app: hermes-agent，但分别限定 version=blue 与 version=green。

6、将入口网关（如 Ingress 或 LoadBalancer）的后端服务指向 hermes-blue Service，作为当前生产流量出口。

7、待绿色环境完成健康检查与功能验证后，修改网关配置，将后端服务切换至 hermes-green Service。

8、确认切换成功且无异常日志后，可保留或销毁 hermes-blue 命名空间。

二、基于 Docker Compose 的双栈蓝绿部署

适用于轻量级服务器或测试环境，通过两组隔离的 docker-compose.yml 文件分别定义蓝绿服务栈，配合反向代理实现流量切换。所有容器数据卷、网络与环境变量完全分离。

1、准备两个 compose 文件：docker-compose.blue.yml 与 docker-compose.green.yml，内容结构一致但服务名、镜像标签、环境变量 HERMES_ENV 设置为 blue/green。

2、启动蓝色环境：
执行命令 docker-compose -f docker-compose.blue.yml up -d。

3、验证蓝色环境运行状态，确保 hermes-agent 容器健康且可通过 http://localhost:8000/health 检查接口返回 success。

4、启动绿色环境：
执行命令 docker-compose -f docker-compose.green.yml up -d。

5、配置 Nginx 反向代理，初始 upstream 指向蓝色容器的 8000 端口。

6、对绿色环境执行完整功能测试，包括模型调用、技能执行、消息网关连通性等。

7、测试通过后，编辑 Nginx 配置，将 upstream 指向绿色容器的 8001 端口（或对应 green 服务暴露端口）。

8、重载 Nginx 配置：
执行命令 nginx -s reload。

三、基于阿里云计算巢的蓝绿发布流程

依托计算巢（Compute Nest）服务编排能力，可将 Hermes Agent 封装为带版本标识的可复用服务实例，通过实例替换实现蓝绿语义。适用于使用阿里云 ECS 自动化部署的用户。

1、在计算巢控制台中，将 Hermes Agent 当前版本导出为服务模板，并标记版本号 v1.2.0-blue。

2、基于该模板创建首个部署实例，命名为 hermes-prod-blue，地域与可用区固定。

3、对 Hermes Agent 代码仓库拉取新分支，更新 requirements.txt 与配置项，构建新镜像并推送至阿里云 ACR。

4、基于新镜像生成新版服务模板，标记为 v1.3.0-green。

5、使用该模板创建第二个部署实例，命名为 hermes-prod-green，参数配置（ECS 规格、安全组、VPC）与蓝色实例完全一致。

6、登录 hermes-prod-green 实例，执行 hermes health --full 验证全链路可用性。

7、进入阿里云 ALB 控制台，编辑目标组，将原绑定 hermes-prod-blue 的 ECS 实例移除，添加 hermes-prod-green 的 ECS 实例 IP。

8、调整权重：先设为 10% 流量导入 green 实例观察 15 分钟，无错误日志后调整为 100%。

四、基于环境变量与运行时路由的轻量蓝绿

不依赖基础设施层变更，仅通过 Hermes Agent 内部配置与外部网关规则实现逻辑蓝绿。适用于单机部署或资源受限环境，切换粒度为请求级。

1、在同一台服务器上启动两个 Hermes Agent 进程，分别监听不同端口（如 8000 与 8001）。

2、进程 1 启动时指定环境变量：
HERMES_ENV=blue HERMES_INSTANCE_ID=inst-blue-01。

3、进程 2 启动时指定环境变量：
HERMES_ENV=green HERMES_INSTANCE_ID=inst-green-01。

4、配置 Traefik 或 Nginx，依据 HTTP Header 中的 X-Env-Target 值进行路由：
若 Header 包含 X-Env-Target: green，则转发至 8001；否则默认至 8000。

5、编写简易 Shell 脚本，通过 curl -H "X-Env-Target: green" http://localhost/health 实现灰度探活。

6、在飞书或 Telegram 群中向内部用户发送带 X-Env-Target: green 的测试链接，收集反馈。

7、确认 green 实例响应准确率 ≥99.9% 后，将 Nginx 默认 upstream 改为 8001 端口。

8、停止 blue 进程：
执行命令 pkill -f "hermes.*8000"。

本篇关于《HermesAgent蓝绿部署实战教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于科技周边的相关知识，请关注golang学习网公众号！