Kubernetes是生产环境中高可用、可伸缩运行Hermes Agent的首选平台。操作路径包括：一、确认集群满足v1.21+版本、≥2GB内存及相应权限；二、使用社区Helm Chart或原生YAML部署；三、创建hermes-agent命名空间并应用RBAC与工作负载；四、验证Pod就绪、日志输出、Service可达性；五、通过Ingress/LB暴露gateway，配置TLS并验证外部访问。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在生产环境中以高可用、可伸缩的方式运行Hermes Agent，Kubernetes 是首选编排平台。以下是将 Hermes Agent 部署至 Kubernetes 集群的具体操作路径，涵盖环境准备、资源定义、部署验证等关键环节。
一、确认集群前置条件
Kubernetes 集群需满足最低运行要求，确保 Hermes Agent 的核心组件（如 gateway、agent-core、memory-store）能稳定调度与通信。未达标准可能导致 Pod 持续 CrashLoopBackOff 或服务不可达。
1、执行命令检查 Kubernetes 版本：kubectl version --short，确认 Server 版本 ≥ v1.21。
2、检查节点资源：运行 kubectl describe nodes | grep -A 5 "Allocatable:"，确认至少一个工作节点提供 ≥ 2GB 可用内存及 2 核 CPU。
3、验证集群权限：执行 kubectl auth can-i create pods -n default，返回 yes 表示具备基础资源创建权限；若需部署至独立命名空间，须拥有 admin 或 cluster-admin 角色绑定。
二、准备 Helm Chart 或原生 YAML 清单
Hermes Agent 官方未发布正式 Helm 仓库，但社区维护的 hermes-agent-chart（GitCode @GitHub_Trending/he/hermes-agent）提供标准化部署能力。该方式支持参数化配置，避免手动编辑多份 YAML 文件。
1、添加社区 Helm 仓库：helm repo add hermes https://github.com/GitHub_Trending/he/hermes-agent/tree/main/charts。
2、更新本地索引：helm repo update。
3、拉取并解压 chart 至本地：helm pull hermes/hermes-agent --untar，进入生成的 hermes-agent/ 目录。
4、根据实际需求修改 values.yaml：启用 gateway.enabled: true，设置 model.provider: kimi，指定 memory.storage: persistentVolumeClaim。
三、部署至命名空间 hermes-agent
为隔离 Hermes Agent 运行环境并便于资源配额管理，所有资源应部署于专用命名空间。该步骤创建命名空间、应用 RBAC 策略，并启动核心工作负载。
1、创建命名空间：kubectl create namespace hermes-agent。
2、应用最小化 RBAC 清单（含 ServiceAccount、Role、RoleBinding）：kubectl apply -f manifests/rbac-minimal.yaml -n hermes-agent。
3、使用 Helm 安装（推荐）：helm install hermes-agent ./hermes-agent -n hermes-agent --create-namespace。
4、若采用纯 YAML 方式，依次应用：kubectl apply -f manifests/configmap.yaml -n hermes-agent，kubectl apply -f manifests/deployment.yaml -n hermes-agent，kubectl apply -f manifests/service.yaml -n hermes-agent。
四、验证 Pod 启动与就绪状态
部署完成后，需逐层确认各组件是否成功调度、初始化完成且通过就绪探针。任一组件未就绪将导致网关无法接收消息或技能无法持久化。
1、列出命名空间下所有 Pod：kubectl get pods -n hermes-agent，确认所有 Pod 的 STATUS 列显示为 Running，READY 列为 1/1。
2、查看某 Pod 日志以确认模型加载成功：kubectl logs -n hermes-agent -l app=hermes-agent --tail=20，输出中应包含 "Model loaded: kimi-2.5" 或类似标识。
3、检查 Service 是否分配 ClusterIP：kubectl get service -n hermes-agent，确认 hermes-gateway 类型为 ClusterIP 且 IP 非 None。
4、从集群内调试容器测试连通性：kubectl run debug --image=busybox:1.35 --rm -it --restart=Never -- sh -c "telnet hermes-gateway.hermes-agent.svc.cluster.local 8000"，成功返回连接建立表示服务可达。
五、暴露 Gateway 供外部访问
默认部署仅在集群内部可达。若需从飞书、Discord 等平台回调 Hermes Agent，必须通过 Ingress 或 LoadBalancer 暴露 /webhook 路径，且确保 TLS 终止配置正确。
1、创建 TLS Secret（使用已有证书）：kubectl create secret tls hermes-tls --cert=tls.crt --key=tls.key -n hermes-agent。
2、应用 Ingress 清单，指定 host 为 hermes.yourdomain.com，rules 中 path 必须匹配 /webhook/.* 并关联 hermes-gateway Service 的 8000 端口。
3、验证 DNS 解析与证书有效性：在集群外执行 curl -v https://hermes.yourdomain.com/webhook/health，响应状态码应为 200，且 SSL 握手无警告。
4、检查 Ingress Controller 日志确认路由注入：kubectl logs -n ingress-nginx deploy/ingress-nginx-controller | grep hermes，应出现 "successfully added server hermes.yourdomain.com"。
