agent_management/k8s

Agent Manager K8s 部署说明

本文档对应当前仓库的 Heicode Sub 模式 Runtime 部署方式。

当前接口边界：

• 主接口：/api/agent/sub-agile/*
• 主回调：/api/agent/callbacks/runtime-events
• 兼容接口：/api/agnet/*
• 兼容 Runtime 入口：/api/swarms/*

目录与用途

• agent-manager-namespace.yaml: 运行命名空间
• agent-manager-rbac.yaml: ServiceAccount、ClusterRole、ClusterRoleBinding
• agent-manager-secret.yaml: 运行时 Secret
• agent-manager-configmap.yaml: 运行时配置
• agent-manager-deployment.yaml: 主部署清单
• agent-manager-service.yaml: LoadBalancer 服务
• deploy.sh: 标准部署脚本
• deploy-with-kubeconfig.sh: 使用 kubeconfig-secret 的部署脚本

关键约定

• 命名空间统一使用 agent-manager
• K8s 探活统一检查 GET /api/agent/health
• 运行时配置中的 NAMESPACE_PREFIX 已更新为 agent
• /api/swarms 仅作为 sub-mode compatibility API 保留，不表示本仓库实现独立 Swarm 产品

标准部署

kubectl apply -f k8s/agent-manager-namespace.yaml
kubectl apply -f k8s/agent-manager-rbac.yaml
kubectl apply -f k8s/agent-manager-secret.yaml
kubectl apply -f k8s/agent-manager-configmap.yaml
kubectl apply -f k8s/acr-secret.yaml
kubectl apply -f k8s/agent-manager-deployment.yaml
kubectl apply -f k8s/agent-manager-service.yaml

或直接执行：

bash k8s/deploy.sh

使用 kubeconfig Secret 的部署

先生成 Secret：

bash k8s/create-kubeconfig-secret.sh

再执行：

bash k8s/deploy-with-kubeconfig.sh

部署后检查

kubectl get pods -n agent-manager
kubectl get svc -n agent-manager
kubectl logs -n agent-manager deployment/agent-manager
kubectl port-forward -n agent-manager svc/agent-manager 8000:80
curl http://127.0.0.1:8000/api/agent/health
curl http://127.0.0.1:8000/api/agnet/health

运行时配置项

agent-manager-configmap.yaml 中与本次对接直接相关的键：

• NAMESPACE
• REDIS_URL
• HEICODE_NEWAPI_BASE_URL
• LITELLM_BASE_URL
• NAMESPACE_PREFIX
• RUNTIME_ARTIFACT_*

agent-manager-secret.yaml 中至少需要正确配置：

• HEICODE_SERVICE_TOKEN
• AZURE_*
• AZURE_STORAGE_*
• VAULT_TOKEN（如果当前环境启用 Vault）

发布建议

更新代码后，建议同步修改：

1. 镜像 tag
2. agent-manager-deployment.yaml 中的 image
3. 对接文档中的版本记录
4. 部署后健康检查与契约测试结果