Kubernetes部署Hermes Agent需五步：一验环境权限，二克隆仓库并确认kubernetes/清单存在，三用kubectl部署基础资源，四用Helm参数化安装并指定agent.mode，五用Kustomize定制overlay配置并注入参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在Kubernetes集群中部署Hermes Agent，但尚未完成环境准备或配置集成，则可能是由于基础组件缺失、权限不足或配置路径不匹配所致。以下是部署此Agent的步骤：
一、验证Kubernetes环境与权限
确保集群满足最低运行要求，并具备执行部署操作所需的访问控制权限，这是避免后续Pod启动失败或资源调度异常的前提。
1、检查Kubernetes版本是否为1.21或更高版本：kubectl version --server --short
2、确认节点至少有2GB可用内存：kubectl describe nodes | grep -A 5 "Allocatable:"
3、验证当前用户具有集群管理员权限：kubectl auth can-i --list
4、若权限不足，需通过kubectl create clusterrolebinding授予必要权限：cluster-admin绑定必须由集群管理员执行，不可跳过
二、克隆并进入项目仓库
获取官方维护的Hermes Agent源码及配套Kubernetes清单，确保使用与目标边缘或云环境兼容的分支或标签。
1、执行克隆命令：git clone https://gitcode.com/GitHub_Trending/he/hermes-agent
2、切换至项目根目录：cd hermes-agent
3、确认kubernetes/目录存在且包含deployment.yaml、service.yaml等核心文件：若该目录为空或缺失，请切换至main分支或检查.gitmodules子模块状态
三、应用基础Kubernetes部署清单
使用原生kubectl直接部署标准化资源对象，适用于快速验证或轻量级边缘节点场景。
1、执行部署命令：kubectl apply -f kubernetes/deployment.yaml -f kubernetes/service.yaml
2、检查Pod状态：kubectl get pods -n default | grep hermes-agent
3、确认Service已正确暴露端口：kubectl get service | grep hermes-agent
4、若Pod处于Pending状态，需检查节点资源配额与污点容忍配置：默认部署未设置nodeSelector或tolerations，可能无法调度至带污点的边缘节点
四、使用Helm Chart部署
通过Helm实现参数化、可复用的部署，支持多环境差异化配置与版本回滚能力。
1、初始化Helm客户端并添加chart仓库（如已存在则跳过）：helm repo add hermes https://github.com/GitHub_Trending/he/hermes-agent/charts
2、更新本地repo索引：helm repo update
3、安装Chart并指定命名空间：helm install hermes-agent hermes/hermes-agent --namespace hermes-agent --create-namespace
4、覆盖自定义值：helm install hermes-agent hermes/hermes-agent -f my-values.yaml
5、my-values.yaml中必须显式声明agent.mode: edge或agent.mode: cloud，否则容器启动时将因配置缺失退出
五、使用Kustomize进行环境定制化部署
利用Kustomize的叠加机制，在不修改原始清单的前提下注入环境特定配置，适合CI/CD流水线集成。
1、确认项目中存在base/和overlays/目录结构：ls -R kubernetes/kustomize/
2、构建并查看渲染后清单：kustomize build kubernetes/kustomize/overlays/production | head -20
3、应用定制化配置：kustomize build kubernetes/kustomize/overlays/production | kubectl apply -f -
4、向ConfigMap注入运行时参数：在overlays/production/kustomization.yaml中添加configMapGenerator项
5、所有overlay必须包含patchesStrategicMerge字段以修正默认资源限制，否则CPU/Memory request将为空导致调度拒绝
