Kubernetes 集群中缺少 kagent.dev/v1alpha2

Error log

bash 复制代码

ensure CRDs are installed first, resource mapping not found for name: "cilium-debug-agent" namespace: "haiou" from "": no matches for kind "Agent" in version "kagent.dev/v1alpha2"
ensure CRDs are installed first, resource mapping not found for name: "cilium-manager-agent" namespace: "haiou" from "": no matches for kind "Agent" in version "kagent.dev/v1alpha2"
ensure CRDs are installed first, resource mapping not found for name: "cilium-policy-agent" namespace: "haiou" from "": no matches for kind "Agent" in version "kagent.dev/v1alpha2"

错误原因与解决方案

这个报错的核心原因是：Kubernetes 集群中缺少 kagent.dev/v1alpha2 版本的 Agent 自定义资源定义（CRD） ，你直接部署 Agent 类型的资源时，K8s 无法识别这个自定义资源，因此抛出了资源映射未找到的错误。

关键信息解读

no matches for kind "Agent" in version "kagent.dev/v1alpha2"
K8s 不认识 Agent 这个资源类型，因为对应的 CRD 没有安装。
ensure CRDs are installed first
系统明确提示：必须先安装 CRD，再部署依赖它的自定义资源。
报错的资源：cilium-debug-agent/cilium-manager-agent/cilium-policy-agent
这些是 Cilium 相关的 Agent 自定义资源，依赖 kagent.dev CRD。

解决方案（分步骤执行）

步骤1：检查集群中是否存在目标 CRD

执行命令查看 kagent.dev 相关的 CRD：

bash 复制代码

kubectl get crds | grep kagent.dev

预期结果：无任何输出 → 证明 CRD 确实缺失。

步骤2：安装缺失的 CRD

kagent.dev/v1alpha2/Agent 是 Cilium 依赖的 CRD，直接安装 Cilium 官方提供的完整 CRD 清单即可解决：

方式1：在线安装（推荐，能联网的集群）

bash 复制代码

# 下载并应用 Cilium 全套 CRD
kubectl apply -f https://raw.githubusercontent.com/cilium/cilium/main/install/kubernetes/cilium/crds.yaml

方式2：离线安装（无外网集群）

先在有网机器下载 CRD 文件：

bash 复制代码

wget https://raw.githubusercontent.com/cilium/cilium/main/install/kubernetes/cilium/crds.yaml

将文件拷贝到集群节点，执行：
bash 复制代码
```
kubectl apply -f crds.yaml
```

步骤3：验证 CRD 安装成功

再次执行检查命令：

bash 复制代码

kubectl get crds | grep kagent.dev

成功输出示例：

复制代码

agents.kagent.dev                          2025-XX-XX XX:XX:XX

步骤4：重新部署你的资源

CRD 安装完成后，重新 apply 你的 Cilium Agent 资源配置：

bash 复制代码

# 替换为你的资源yaml路径
kubectl apply -f your-cilium-agent-resources.yaml -n haiou

补充方案：如果是 Helm 部署 Cilium

如果你是用 Helm 安装 Cilium，直接升级/重装会自动处理 CRD：

bash 复制代码

helm repo add cilium https://helm.cilium.io/
helm repo update
helm upgrade --install cilium cilium/cilium -n kube-system

总结

根本问题：缺少自定义资源定义（CRD） ，K8s 无法识别 Agent 资源；
核心操作：先装 CRD，再部署业务资源；
快速修复：直接应用 Cilium 官方 CRD 清单即可解决所有相关报错。

也可以下载国内链接：

bash 复制代码

# 方式1：使用 jsDelivr CDN 镜像（推荐，稳定）
kubectl apply -f https://cdn.jsdelivr.net/gh/cilium/cilium@main/install/kubernetes/cilium/crds.yaml

# 方式2：指定版本（避免 main 分支变动，推荐固定 v1.15 稳定版）
kubectl apply -f https://cdn.jsdelivr.net/gh/cilium/cilium@v1.15.0/install/kubernetes/cilium/crds.yaml