安装

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:

violet push \
  --platform-address=<platform-access-address> \
  --platform-username=<platform-admin> \
  --platform-password=<platform-admin-password> \
  kagenti-operator.ALL.xxxx.tgz
INFO

该 operator bundle 会在 CSV relatedImages 中记录其运行时镜像,因此 violet release 会将这些镜像迁移到平台 registry 中。这使得该 operator 能够在 air-gapped 集群上安装,而无需访问 docker.io 或 ghcr.io。

安装 Operator

在 管理员 视图中:

  1. 单击 Marketplace / OperatorHub。
  2. 在控制台顶部,从 Cluster 下拉菜单中选择目标集群。
  3. 搜索并选择 Kagenti Operator,然后单击 Install。
  4. 保持 Channel 不变(stable)。
  5. 检查 Version 是否与要安装的 release 匹配。
  6. 保持 Installation Location 不变——它默认使用 kagenti-system 命名空间。
  7. 选择一个 Upgrade Strategy(生产环境推荐 Manual)。
  8. 单击 Install。

创建 Kagenti operand

从 OperatorHub 安装该 operator 时会运行 OLM operator。要部署 agent controllers、CRDs 和 webhooks,请创建一个 Kagenti custom resource。空 spec 会选择 core profile:

kubectl apply -f - <<EOF
apiVersion: kagenti.alauda.io/v1alpha1
kind: Kagenti
metadata:
  name: kagenti
  namespace: kagenti-system
spec: {}
EOF

验证

确认 Kagenti Operator 磁贴显示 Installed,然后在集群上验证:

# the CSV reports Succeeded
kubectl get csv -n kagenti-system | grep kagenti

# the operator and agent controllers are Running
kubectl get pods -n kagenti-system

# the agent CRDs are registered
kubectl get crd | grep agent.kagenti.dev

你应该能看到 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;有关架构,请参见 安全架构。

INFO

Succeeded CSV 加上一个已协调的 Kagenti 资源,表示控制器正在运行。只有在你创建工作负载和 AgentRuntime resources 之后,Agent 和 tool 本身才会出现——请参见 使用 AgentRuntime 部署 Agent。