Terraform多Provider传递：如何控制模块用指定Provider创建AKS命名空间

要让模块明确使用指定的Kubernetes Provider，需从模块声明Provider别名和资源绑定指定Provider两个层面处理，以下是简洁实现步骤：

1. 更新模块的Provider声明（module_providers.tf） #

在模块的required_providers中，为Kubernetes Provider声明需要的别名（dev/prod），确保模块能识别传入的别名Provider：

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "3.20.0"
    }
    azuread = {
      source  = "hashicorp/azuread"
      version = "2.27.0"
    }
    kubernetes = {
      source  = "hashicorp/kubernetes"
      version = "2.12.1"
      # 声明模块接受的Provider别名
      aliases = ["dev", "prod"]
    }
  }
}

2. 方式一：固定绑定指定Provider（适合单用途模块） #

如果模块仅针对某一环境创建命名空间，可直接在资源块中指定Provider别名：

# namespace.tf
resource "kubernetes_namespace" "namespace-appteam" {
  # 明确指定使用dev别名的Provider
  provider = kubernetes.dev

  metadata {
    annotations = {
      name = var.application_name
    }
    labels = {
      appname = var.application_name
    }
    name = var.application_name
  }
}

3. 方式二：通过变量动态选择Provider（适配多环境，更灵活） #

若要让模块根据传入参数选择dev或prod Provider，按以下步骤操作：

3.1 在模块中新增变量文件（variables.tf） #

variable "target_environment" {
  type        = string
  description = "指定要使用的环境Provider别名，可选值：dev/prod"
  validation {
    condition     = contains(["dev", "prod"], var.target_environment)
    error_message = "target_environment必须是dev或prod。"
  }
}

3.2 在资源中动态引用Provider #

利用provider参数结合Terraform的索引语法，根据变量选择对应Provider：

# namespace.tf
resource "kubernetes_namespace" "namespace-appteam" {
  # 根据变量动态选择对应的Provider
  provider = kubernetes[var.target_environment]

  metadata {
    annotations = {
      name = var.application_name
    }
    labels = {
      appname = var.application_name
    }
    name = var.application_name
  }
}

3.3 在主模块中传递环境变量 #

# main.tf
module "appteam-dev" {
  source              = "../modules/aks-module"
  application_name    = "dev-app"
  target_environment  = "dev"
  providers = {
    kubernetes.dev = kubernetes.dev
    kubernetes.prod = kubernetes.prod
  }
}

module "appteam-prod" {
  source              = "../modules/aks-module"
  application_name    = "prod-app"
  target_environment  = "prod"
  providers = {
    kubernetes.dev = kubernetes.dev
    kubernetes.prod = kubernetes.prod
  }
}

关键说明 #

• 模块必须先在required_providers中声明对应的别名，才能接收根模块传入的别名Provider；
• 资源块的provider参数是指定使用哪个Provider的核心，要么固定写死别名，要么通过变量动态选择；
• 若不指定provider参数，Terraform会默认使用无别名的kubernetes Provider，这也是模块之前无法识别目标Provider的原因。

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