使用Terraform部署Neo4j Helm Chart遇K8s集群不可达错误求助

问题概述 #

部署Neo4j Helm Chart时触发以下错误：

Kubernetes cluster unreachable: exec plugin: invalid api version : "client.authentication.k8s.io/v1a1pha1"

环境信息：

• kubectl 1.2.1
• helm 3.0.3
• Terraform v1.6.6
• Terraform Helm Provider 2.11.0
• Neo4j Chart版本：4.1.3-1

解决方案 #

1. 修正kubeconfig中的API版本拼写错误 #

错误信息里的v1a1pha1是明显的拼写失误，正确的API版本应为client.authentication.k8s.io/v1alpha1。检查你的kubeconfig文件（默认路径~/.kube/config），找到exec插件配置段，修正版本号：

错误配置示例：

exec:
  apiVersion: client.authentication.k8s.io/v1a1pha1

修正后：

exec:
  apiVersion: client.authentication.k8s.io/v1alpha1

2. 升级kubectl和Helm到兼容版本 #

你的kubectl 1.2.1版本过于老旧，与Terraform v1.6.6、Helm Provider 2.11.0存在严重版本兼容问题：

• kubectl版本需与目标Kubernetes集群版本差不超过1个大版本（例如集群为1.28，kubectl可选用1.27-1.29）
• Helm升级至3.12+版本，确保与Helm Provider 2.11.0适配

3. 显式配置Helm Provider的集群连接 #

若kubeconfig不在默认路径，可在Terraform中显式指定路径，避免连接异常：

provider "helm" {
  kubernetes {
    config_path = "~/.kube/config"
  }
}

4. 重置Terraform环境缓存 #

执行以下命令清理旧配置缓存，重新初始化环境：

terraform init -reconfigure

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