如何用Terraform参数化Confluent Cloud的集群类型（基础/标准/专属）

核心思路 #

利用Terraform的dynamic块结合变量，根据环境类型动态渲染对应的集群配置块（basic/standard/dedicated），同时实现其他参数的环境化复用。

1. 定义环境与集群的映射变量 #

先定义一个包含各环境配置的映射变量，把集群类型、环境ID、集群名称等参数统一管理：

variable "environment_config" {
  type = map(object({
    cluster_type = string
    env_id       = string
    display_name = string
    availability = string
  }))
  default = {
    development = {
      cluster_type = "basic"
      env_id       = confluent_environment.development.id
      display_name = "dev_kafka_cluster"
      availability = "SINGLE_ZONE"
    }
    staging = {
      cluster_type = "basic"
      env_id       = confluent_environment.staging.id
      display_name = "staging_kafka_cluster"
      availability = "SINGLE_ZONE"
    }
    uat = {
      cluster_type = "standard"
      env_id       = confluent_environment.uat.id
      display_name = "uat_kafka_cluster"
      availability = "MULTI_ZONE"
    }
    production = {
      cluster_type = "dedicated"
      env_id       = confluent_environment.production.id
      display_name = "prod_kafka_cluster"
      availability = "MULTI_ZONE"
    }
  }
}

# 可选：如果用Terraform工作区区分单环境，可单独定义集群类型变量
variable "cluster_type" {
  type        = string
  description = "Confluent集群类型：basic/standard/dedicated"
  validation {
    condition     = contains(["basic", "standard", "dedicated"], var.cluster_type)
    error_message = "集群类型必须是basic/standard/dedicated中的一个。"
  }
}

2. 动态生成集群配置块 #

方式一：单环境模式（配合工作区使用） #

针对单个环境，根据cluster_type变量动态渲染对应集群块：

resource "confluent_kafka_cluster" "main" {
  display_name = "${var.cluster_type}_kafka_cluster"
  availability = var.cluster_type == "dedicated" ? "MULTI_ZONE" : "SINGLE_ZONE"
  cloud        = "AZURE"
  region       = "centralus"

  # 动态渲染basic集群块
  dynamic "basic" {
    for_each = var.cluster_type == "basic" ? [1] : []
    content {}
  }

  # 动态渲染standard集群块
  dynamic "standard" {
    for_each = var.cluster_type == "standard" ? [1] : []
    content {}
  }

  # 动态渲染dedicated集群块（可添加专属配置）
  dynamic "dedicated" {
    for_each = var.cluster_type == "dedicated" ? [1] : []
    content {
      cku = 6 # 专属集群的CKU数量，按需调整
    }
  }

  environment {
    id = confluent_environment.current.id
  }

  lifecycle {
    prevent_destroy = true
  }
}

方式二：多环境批量创建模式 #

基于前面的environment_config变量，一次性创建所有环境的集群：

resource "confluent_kafka_cluster" "multi_env" {
  for_each = var.environment_config

  display_name = each.value.display_name
  availability = each.value.availability
  cloud        = "AZURE"
  region       = "centralus"

  dynamic "basic" {
    for_each = each.value.cluster_type == "basic" ? [1] : []
    content {}
  }

  dynamic "standard" {
    for_each = each.value.cluster_type == "standard" ? [1] : []
    content {}
  }

  dynamic "dedicated" {
    for_each = each.value.cluster_type == "dedicated" ? [1] : []
    content {
      cku = 6 # 按需调整专属集群的CKU数量
    }
  }

  environment {
    id = each.value.env_id
  }

  lifecycle {
    prevent_destroy = true
  }
}

关键说明 #

• dynamic块通过for_each的空列表/非空列表控制是否渲染：条件满足时用[1]生成一个元素，触发块渲染；不满足时用[]跳过。
• 可根据集群类型自动调整辅助参数，比如专属集群默认配置多可用区，基础/标准集群用单可用区。
• 单环境模式适合用Terraform工作区隔离环境，多环境模式适合批量管理所有集群资源。

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