Terraform向本地Kubernetes部署资源出现超时错误问题求助

问题排查与解决方案 #

1. 优先修正配置错误 #

你代码中存在镜像名拼写错误，这是导致Pod启动超时的核心原因之一：
原配置的镜像名为hashicorp/http-eco:0.2.3，正确官方镜像名为hashicorp/http-echo:0.2.3，修改镜像名后Pod才能正常拉取镜像启动。

2. 补全Kubernetes Provider配置 #

你没有显式配置Terraform Kubernetes Provider的集群访问信息，会导致Provider读取不到正确的kubeconfig配置，出现连错集群、找不到命名空间、请求超时的问题。请在Terraform代码开头添加如下配置：

terraform {
  required_providers {
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = ">= 2.20.0"
    }
    helm = {
      source  = "hashicorp/helm"
      version = ">= 2.10.0"
    }
  }
}

provider "kubernetes" {
  # 替换为你环境中kubeconfig的绝对路径，WSL2环境建议写绝对路径避免环境变量读取错误
  config_path = "/home/你的用户名/.kube/config"
}

provider "helm" {
  kubernetes {
    config_path = "/home/你的用户名/.kube/config"
  }
}

配置完成后先在当前环境执行kubectl cluster-info确认集群连通正常，再执行Terraform操作。

3. 解决命名空间识别问题 #

你使用了变量var.ingress_nginx_namespace作为资源的命名空间，若该命名空间是你手动通过kubectl创建、未纳入Terraform管理，会出现Terraform资源创建时找不到命名空间的问题。建议将命名空间纳入Terraform管理：

resource "kubernetes_namespace" "ingress_nginx" {
  metadata {
    name = var.ingress_nginx_namespace
  }
}

之后所有依赖该命名空间的资源（Pod、Service、Ingress、Helm Release）都在depends_on中添加kubernetes_namespace.ingress_nginx，确保命名空间创建完成后再创建下游资源。

4. 适配新版本Kubernetes API #

你当前使用的kubernetes_ingress资源对应已废弃的旧版本Ingress API，若你的集群版本 >= 1.19，需要替换为kubernetes_ingress_v1资源，适配networking.k8s.io/v1版本API规范，避免API请求失败导致超时。

5. 自定义超时配置 #

你可以为Kubernetes资源手动调整超时时间，无需等待默认的5分钟超时：

resource "kubernetes_pod" "foo-app" {
  # 原有配置保持不变
  timeouts {
    create = "90s"
    update = "90s"
    delete = "30s"
  }
}

关于兼容问题说明 #

官方维护的HashiCorp Kubernetes Provider与所有主流稳定版Kubernetes（1.20~1.28版本范围）完全兼容，你遇到的问题均为配置错误导致，不属于框架间兼容问题。

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