应用Istio YAML至K8s集群报错：需先安装对应CRDs

问题本质 #

报错的核心原因是你的Kubernetes集群里没装gateway.networking.k8s.io/v1beta1组对应的Gateway、HTTPRoute这两个CRD（自定义资源定义）。这俩是Istio依赖的Gateway API资源，必须先安装CRD才能创建对应的实例，改API版本没用——根本没有这个资源类型的定义，改版本自然解决不了问题。

具体解决步骤 #

• 安装Gateway API CRDs
  执行以下命令安装官方标准的Gateway API CRD：

  kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v0.6.2/standard-install.yaml
  

  注意：要和你的Istio版本匹配，比如Istio 1.16及以上推荐用v0.6.x版本的Gateway API。

• 确认CRD安装成功
  运行命令检查状态：

  kubectl get crd gateways.gateway.networking.k8s.io httproutes.gateway.networking.k8s.io
  

  输出里这两个CRD的状态显示Established就算安装完成。

• 重新应用Istio清单
  CRD装好后，再执行：

  kubectl apply -f ./release/istio-manifests.yaml
  

补充提示 #

• 如果用Istioctl安装Istio，可以直接在安装时启用Gateway API，加参数--set values.gateways.gatewayAPI.enabled=true，这样Istio会自动帮你装对应的CRD。
• 别乱改资源的API版本，每个CRD对应固定的API版本，改了只会更不兼容。

内容的提问来源于stack exchange，提问作者Saad Adil