Helm 是官方推荐的 Kubernetes 部署 Hermes Agent 工具，支持三种方式：一、使用社区 Helm Chart 快速验证；二、基于官方镜像构建自定义 Chart 以完全可控适配；三、通过计算巢 ACR+ROS+FluxOciHelmDeploy 实现生产级安全交付。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Kubernetes 集群中以声明式、可复现的方式部署 Hermes Agent，Helm 是官方推荐的包管理工具。以下是使用 Helm Chart 部署 Hermes Agent 的具体方法：
一、使用社区维护的第三方 Hermes Agent Helm Chart
部分开源贡献者已将 Hermes Agent 封装为 Helm Chart 并托管于公开仓库，适用于快速验证和非生产环境部署。该方式无需自行编写模板，但需确认 Chart 内容与当前 Hermes Agent 版本兼容。
1、添加包含 Hermes Agent Chart 的第三方仓库，例如：helm repo add hermes-community https://charts.hermes-community.dev
2、更新本地仓库索引：helm repo update
3、搜索可用 Chart：helm search repo hermes-agent
4、查看 Chart 详情及默认 values：helm show values hermes-community/hermes-agent
5、使用自定义 values 文件执行安装：helm install hermes-agent hermes-community/hermes-agent -f values-prod.yaml --namespace hermes-system --create-namespace
二、基于官方 Docker 镜像构建自定义 Hermes Agent Chart
当无现成 Chart 可用时，可利用 helm create 初始化结构，并注入 Hermes Agent 所需的 Deployment、Service、ConfigMap 及 Secret 资源定义。该方法完全可控，适配任意 Hermes Agent 发行版（如 v0.8.3+）及飞书/Gateway 集成模式。
1、创建新 Chart：helm create hermes-agent-chart
2、编辑 hermes-agent-chart/Chart.yaml，设置 name、version、appVersion 与 description 字段，其中 appVersion 应匹配目标 Hermes Agent 镜像标签
3、替换 hermes-agent-chart/templates/deployment.yaml 为 Hermes Agent Deployment 模板，确保包含 env 变量 HERMES_GATEWAY_URL、HERMES_MODEL_PROVIDER 及 volumeMounts 挂载配置文件
4、在 hermes-agent-chart/values.yaml 中定义可覆盖参数，包括镜像仓库地址、tag、resources limits、飞书 App ID/Secret Base64 编码值、日志级别等
5、打包并本地安装：helm package hermes-agent-chart && helm install hermes-agent ./hermes-agent-chart-0.1.0.tgz --namespace hermes-system --create-namespace
三、使用计算巢 Helm Chart 部署物部署 Hermes Agent
若需在阿里云计算巢环境中安全、私密地部署 Hermes Agent，可将自定义 Helm Chart 托管至计算巢 ACR 仓库，并通过 ROS 模板调用 FluxOciHelmDeploy 模块完成部署。该方式支持 Oci 格式 Chart 仓库，适用于生产级交付场景。
1、准备 Helm Chart 包并推送至计算巢 ACR 仓库，确保格式为 Oci
2、在服务 ROS 模板中声明 Helm Chart 部署物占位符：{{computenest::helmchart::hermes-agent}}
3、声明仓库拉取密钥占位符：{{computenest::helm::dockerconfigjson}}
4、在 Resources 中调用公共模块 MODULE::ACS::ComputeNest::FluxOciHelmDeploy，指定 ClusterId、ReleaseName、Namespace 与 HelmChartUrl
5、传入 ChartValues 覆盖项，例如设置 image.repository、image.tag、env.HERMES_GATEWAY_URL 等关键参数
