AKS重新部署Splunk Connect for Kubernetes遇values.yaml验证错误求助

问题描述 #

修改配置后，在AKS上重新部署Splunk Connect for Kubernetes时，遇到values.yaml文件验证错误：

Error validating "values.yaml": error validating data: [apiVersion not set, kind not set]

此前部署一切正常，且该values.yaml文件经通用YAML校验工具验证为有效格式。

解决方法 #

• 检查Helm命令是否误用：该错误的核心原因通常是误将values.yaml当作Kubernetes资源清单文件使用（比如执行kubectl apply -f values.yaml），而非通过Helm传递给Chart。正确的部署命令应为：

  helm upgrade --install splunk-connect splunk/splunk-connect-for-kubernetes -f ./values.yaml
  

  确保通过Helm的-f参数指定自定义values文件，而非直接用kubectl处理。

• 确认Helm版本兼容性：核对当前Helm版本与Splunk Connect for Kubernetes Chart的要求是否匹配。若使用Helm 3，需确保Chart支持Helm 3；若为Helm 2，检查Tiller相关配置是否正常。

• 清理values.yaml中的空字段：虽然通用校验工具认可空值，但部分Helm Chart对未赋值字段的处理存在限制。尝试为必填字段补充完整配置，或删除完全未设置的空字段，避免模板渲染异常。

• 重新拉取官方Chart：若本地Chart模板存在损坏或版本不匹配，重新拉取最新版本：

  helm repo add splunk https://splunk.github.io/splunk-connect-for-kubernetes/
  helm repo update
  helm pull splunk/splunk-connect-for-kubernetes --untar
  

  基于新拉取的Chart中的values.yaml重新修改配置后再部署。

• 提前验证模板渲染结果：使用Helm模板命令生成渲染后的资源清单，再用kubectl预验证：

  helm template splunk-connect splunk/splunk-connect-for-kubernetes -f ./values.yaml > rendered.yaml
  kubectl apply --dry-run=client -f rendered.yaml
  

  以此排查是values配置导致模板渲染错误，还是其他部署环节问题。

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