Terraform部署Azure AKS集群时kube_config_raw无法导出kubeconfig文件

1 无法导出kubeconfig到本地文件的修复 #

你缺失了local provider的依赖声明，Terraform不会自动加载对应provider执行本地文件创建操作，按以下步骤修改：

• 第一步：更新terraform配置块，新增local provider声明

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = ">=2.79.1"
    }
    # 新增local provider依赖
    local = {
      source  = "hashicorp/local"
      version = ">=2.4.0"
    }
  }
}

• 第二步：执行terraform init重新初始化，下载对应provider
• 第三步：执行terraform apply，即可在当前工作目录生成kubeconfig文件

如果执行后仍未生成文件，可按以下方向排查：

• 检查当前执行terraform的用户对工作目录是否有写入权限
• 执行terraform taint local_file.kubeconfig标记资源需要重建，再重新执行apply
• 查看apply执行日志，确认local_file资源是否被正常创建

2 直接合并kubeconfig到~/.kube/config的实现 #

可以实现和az aks get-credentials相同的合并效果，分两种场景：

场景1：直接覆盖~/.kube/config（仅适用于本地无其他集群配置的情况） #

直接修改local_file的filename参数，用pathexpand解析家目录路径即可：

resource "local_file" "kubeconfig" {
  depends_on   = [azurerm_kubernetes_cluster.aks]
  filename     = pathexpand("~/.kube/config")
  content      = azurerm_kubernetes_cluster.aks.kube_config_raw
  file_permission = "0600"
}

场景2：合并新集群配置到现有~/.kube/config（保留原有集群配置） #

需要搭配null provider执行本地命令实现合并操作：

• 首先在required_providers中新增null provider声明：

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = ">=2.79.1"
    }
    local = {
      source  = "hashicorp/local"
      version = ">=2.4.0"
    }
    # 新增null provider依赖
    null = {
      source  = "hashicorp/null"
      version = ">=3.2.0"
    }
  }
}

• 新增null_resource资源执行配置合并：

resource "null_resource" "merge_kubeconfig" {
  depends_on = [azurerm_kubernetes_cluster.aks]
  provisioner "local-exec" {
    command = <<EOT
echo '${azurerm_kubernetes_cluster.aks.kube_config_raw}' > /tmp/aks_temp_kubeconfig
KUBECONFIG=/tmp/aks_temp_kubeconfig:${pathexpand("~/.kube/config")} kubectl config view --flatten > ${pathexpand("~/.kube/config")}
rm -f /tmp/aks_temp_kubeconfig
chmod 600 ${pathexpand("~/.kube/config")}
EOT
  }
}

执行init初始化后apply即可自动合并配置到本地kubeconfig文件。

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