安全升级Hermes Agent需采用蓝绿部署策略，即并行维护蓝（稳定）绿（新）两套环境，验证无误后瞬时切换流量。具体包括K8s命名空间隔离、Docker Compose双栈、阿里云计算巢实例替换及环境变量+运行时路由四种实现方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在生产环境中安全升级 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"。
