如何通过Gitlab Pipeline使用Terraform Kubernetes Provider连接Kubernetes

问题根源在于Terraform的Kubernetes Provider默认不会自动适配GitLab Agent注入的临时kubeconfig上下文，而kubectl是依赖GitLab CI自动设置的KUBECONFIG环境变量正常工作的。要让Terraform正常连接，需要显式指定kubeconfig路径。

步骤1：配置Terraform Kubernetes Provider #

修改你的Provider配置，直接引用GitLab CI中自动设置的KUBECONFIG环境变量路径：

provider "kubernetes" {
  config_path = getenv("KUBECONFIG")
}

这个环境变量由GitLab Agent自动注入到CI作业中，指向临时生成的集群配置文件，和kubectl使用的是同一个配置。

步骤2：验证CI作业中的kubeconfig可用性 #

在GitLab CI的job脚本里，可以先添加验证步骤，确保kubeconfig存在且有效：

deploy:
  stage: deploy
  image: hashicorp/terraform:1.5.3
  before_script:
    - echo "Kubeconfig path: $KUBECONFIG"
    - kubectl config view # 验证kubectl能正常读取配置（需确保镜像包含kubectl）
  script:
    - terraform init
    - terraform plan
    - terraform apply -auto-approve

如果使用的Terraform镜像没有预装kubectl，可在before_script中临时安装，或者使用包含Terraform和kubectl的自定义镜像。

备选方案：手动指定kubeconfig路径 #

如果KUBECONFIG环境变量未自动设置（极少数情况），可以直接引用GitLab Agent生成的默认路径：

provider "kubernetes" {
  config_path = "${path.module}/.kube/config"
}

版本兼容性说明 #

你使用的Terraform 1.5.3和Kubernetes Provider 2.23.0完全支持上述配置，无需升级版本。

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