安装
Kagenti Operator 以 OLM Operator 形式交付,并从平台 OperatorHub 安装。
前提条件
- ACP version: v4.0 或更高版本(已在 v4.3 上验证)。
- 目标集群架构为
linux/amd64或linux/arm64(该 operator 提供 multi-arch 镜像)。 - 目标集群可用 Operator Lifecycle Manager (OLM)(由 ACP 提供)。
- 目标集群已安装 cert-manager。该 operator 的 admission webhooks 从 cert-manager 获取其服务证书。
上传 Operator
从 Customer Portal / Marketplace 下载 Kagenti Operator bundle,然后使用 violet 命令行工具将其发布到平台 repository:
该 operator bundle 会在 CSV relatedImages 中记录其运行时镜像,因此 violet release 会将这些镜像迁移到平台 registry 中。这使得该 operator 能够在 air-gapped 集群上安装,而无需访问 docker.io 或 ghcr.io。
安装 Operator
在 管理员 视图中:
- 单击 Marketplace / OperatorHub。
- 在控制台顶部,从 Cluster 下拉菜单中选择目标集群。
- 搜索并选择 Kagenti Operator,然后单击 Install。
- 保持 Channel 不变(
stable)。 - 检查 Version 是否与要安装的 release 匹配。
- 保持 Installation Location 不变——它默认使用
kagenti-system命名空间。 - 选择一个 Upgrade Strategy(生产环境推荐
Manual)。 - 单击 Install。
创建 Kagenti operand
从 OperatorHub 安装该 operator 时会运行 OLM operator。要部署 agent controllers、CRDs 和 webhooks,请创建一个 Kagenti custom resource。空 spec 会选择 core profile:
验证
确认 Kagenti Operator 磁贴显示 Installed,然后在集群上验证:
你应该能看到 agentruntimes、agentcards 和 authorizationpolicies CRDs(group agent.kagenti.dev)、kagenti-controller-manager 和 kagenti-helm-operator-controller-manager pods 处于 Running 状态,以及 agent-label-protection ValidatingAdmissionPolicy。
该 operator 会监视所有 namespace,因此你可以在任意 namespace 中注册 agent 和 tool。
Profile:Core vs Secure
上面的空 spec Kagenti 资源选择的是 core profile——agent 注册、动态发现和 MCP tool integration,不包含任何 identity sidecars。这是默认配置,只需要 cert-manager。
secure profile 在此基础上增加了零信任工作负载身份(SPIRE mTLS)、Keycloak OAuth2/JWT authentication,以及 Istio ambient mesh——由 AuthBridge sidecar 强制执行。它需要额外的集群组件(SPIRE、Keycloak、Istio ambient)和若干 Kagenti spec 设置,并且每个 agent namespace 都必须标记 kagenti-enabled=true。要启用它,请参见 启用 Secure Profile;有关架构,请参见 安全架构。
Succeeded CSV 加上一个已协调的 Kagenti 资源,表示控制器正在运行。只有在你创建工作负载和 AgentRuntime resources 之后,Agent 和 tool 本身才会出现——请参见 使用 AgentRuntime 部署 Agent。