Terraform部署K8s资源报错：server无法找到deployments.apps资源

核心原因分析 #

报错the server could not find the requested resource (post deployments.apps)本质是Terraform的Kubernetes类Provider没有正确连接到k3s集群，或者集群API访问配置存在问题——毕竟你手动用kubectl apply能正常部署，说明集群本身的deployments资源是正常的。

具体解决步骤 #

1. 补充Kubernetes Provider的集群连接配置 #

你当前的provider.tf只声明了依赖的Provider，但没有配置集群连接信息。k3s的kubeconfig默认路径分两种情况：

• 普通用户安装的k3s：~/.kube/config
• root用户安装的k3s：/etc/rancher/k3s/k3s.yaml

修改provider.tf，添加Provider配置块：

terraform {
  required_version = ">= 0.13"
  required_providers {
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = ">= 2.0.0"
    }
  }
}

# 新增这个配置块，指定k3s的kubeconfig路径
provider "kubernetes" {
  config_path = "~/.kube/config"
  # 如果是root用户部署的k3s，替换成下面的路径
  # config_path = "/etc/rancher/k3s/k3s.yaml"
}

2. 验证kubeconfig的有效性 #

先手动确认kubeconfig能正常访问k3s集群：

# 查看当前kubeconfig的上下文
kubectl config current-context
# 验证deployments资源是否存在
kubectl api-resources | grep deployments

如果输出包含deployments.apps，说明集群API正常；如果没有，检查k3s服务是否正常运行。

3. 针对gavinbunney/kubectl Provider的配置 #

如果你改用这个Provider，同样需要补充连接配置：

terraform {
  required_version = ">= 0.13"
  required_providers {
    kubectl = {
      source  = "gavinbunney/kubectl"
      version = ">= 1.14.0"
    }
  }
}

provider "kubectl" {
  config_path = "~/.kube/config"
  # root用户部署的k3s用这个路径
  # config_path = "/etc/rancher/k3s/k3s.yaml"
}

4. 确认命名空间配置（可选） #

如果你的deployment没有指定命名空间，默认会部署到default命名空间。可以在deployment的metadata里显式声明，避免潜在问题：

resource "kubernetes_deployment" "grafana" {
  metadata {
    name      = "grafana"
    namespace = "default" # 显式指定命名空间
    labels = {
      app = "grafana"
    }
  }
  # 其余配置...
}

5. 检查Provider与k3s版本兼容性 #

确保Terraform Kubernetes Provider版本和k3s内置的Kubernetes版本匹配：

• k3s 1.22+：推荐使用Provider 2.0+
• 更老的k3s版本：可能需要降低Provider版本（比如1.20.x的k3s用Provider 1.13.x）

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