Minikube部署Kong Helm图表时报apiVersion未设置错误

核心报错的直接触发原因 #

你遇到的Error: unable to build kubernetes objects from release manifest: error validating "": error validating data: apiVersion not set报错，本质是Helm在渲染Chart时无法正确读取元数据，生成了无合法元信息的空K8s资源对象，最终被K8s API服务的校验逻辑拦截。
对照你提供的Chart配置文件，第一处致命配置笔误非常明确：

• 当前Chart.yaml里写的是全小写的apiversion: v2，完全不符合Helm 3的字段命名规范。Helm要求这个顶层元数据字段必须是apiVersion（V字母大写），全小写写法会被Helm直接判定为未知字段，完全无法读取Chart的apiVersion元信息，最终触发清单构建失败。

这和你描述的此前在EKS上能正常部署的场景不矛盾：实际在EKS上运行的Chart是字段命名正确的版本，本次在Minikube上安装的本地文件，刚好在编写Chart.yaml时把apiVersion的大写V错写为小写，属于笔误导致的元数据读取失败。

修正后的标准Chart.yaml格式参考：

apiVersion: v2
name: kong
description: A Helm chart for Kubernetes
type: application
version: 0.1.0

跨集群适配的隐性问题提醒 #

除了上述笔误，你当前Chart里硬编码的EKS专属节点组nodeSelector标签，和Minikube环境不兼容：

• Minikube的本地节点不存在你配置的EKS节点组专属标签，这个问题虽然不会触发当前的apiVersion报错，但在你修正完笔误完成安装后，会导致Kong相关的Pod一直处于Pending状态，无法完成调度。
• 建议把nodeSelector配置改成参数化形式，存放在values.yaml中：在EKS生产环境下注入对应节点标签，在Minikube本地测试环境下可以临时留空，或者匹配Minikube自带的节点标签。

安装前的校验操作流程 #

为了避免反复触发安装报错，可以按顺序做本地预校验：

• 修正完Chart.yaml的字段大小写后，先执行helm lint ./kong做Chart合法性检查，确认没有元数据解析类错误
• 再执行helm template kong ./kong本地渲染全量K8s清单，逐行确认每个渲染出来的资源块都有合法的apiVersion和kind字段，不存在空的资源定义
• 临时注释掉硬编码的EKS专属nodeSelector配置后，再执行helm install kong ./kong完成安装

你当前使用的组件版本（Minikube v1.19.0、kubectl v1.18.12、Helm v3.4.2）本身完全兼容，不存在版本适配导致的apiVersion不识别问题，所有报错根源都是本地Chart的配置笔误。

内容的提问来源于stack exchange，提问作者Humberto Lantero