Terraform实现azurerm_service_fabric_cluster的node_type条件配置

核心问题 #

通过Terraform创建Azure Service Fabric集群时，需要动态控制资源内嵌的node_type配置块数量：当自定义布尔值为false时仅保留固定的"first"主节点类型；布尔值为true时追加"second"节点类型配置。
由于node_type是资源内部的嵌套配置块、不是独立顶层资源，无法直接套用独立资源常用的count = 条件 ? 1 :0语法实现条件部署。

硬编码的初始资源定义 #

resource "azurerm_service_fabric_cluster" "example" {
  name                 = "example-servicefabric"
  resource_group_name  = "${var.cluster_name}-group"
  location             = var.location
  reliability_level    = "Bronze"
  upgrade_mode         = "Manual"
  cluster_code_version = "7.1.456.959"
  vm_image             = "Windows"
  management_endpoint  = "https://example:80"

  node_type{
        name                 = "first"
        instance_count       = 3
        is_primary           = true
        client_endpoint_port = 2020
        http_endpoint_port   = 80
  }

  node_type{
        name                 = "second"
        instance_count       = 3
        is_primary           = true
        client_endpoint_port = 2020
        http_endpoint_port   = 80
  }
}

实现方案 #

Terraform 0.12及以上版本内置了 dynamic 动态块语法，专门用于生成资源内部可重复定义的嵌套配置块，完全支持通过循环集合控制块的生成与否、生成数量，刚好匹配这类内嵌配置块的条件部署需求。
针对上述场景的改写逻辑：

• 对永远存在、无配置变化的"first"节点类型，直接保留原有的硬编码写法即可，无需额外改造。
• 对需要按条件启停的"second"节点类型，用dynamic "node_type"块包裹，通过for_each的取值控制是否生成对应配置：
  • 当布尔变量为true时，给for_each传入单元素集合，Terraform会生成1个对应配置的node_type块，效果和硬编码完全一致；
  • 当布尔变量为false时，给for_each传入空集合，Terraform不会生成任何对应的node_type块，相当于完全省略这段配置。

改写后的可运行代码 #

# 定义控制逻辑的布尔变量
variable "enable_second_node_type" {
  type        = bool
  description = "是否部署第二个扩展节点类型"
  default     = false
}

resource "azurerm_service_fabric_cluster" "example" {
  name                 = "example-servicefabric"
  resource_group_name  = "${var.cluster_name}-group"
  location             = var.location
  reliability_level    = "Bronze"
  upgrade_mode         = "Manual"
  cluster_code_version = "7.1.456.959"
  vm_image             = "Windows"
  management_endpoint  = "https://example:80"

  # 固定存在的first主节点类型，直接硬编码
  node_type {
    name                 = "first"
    instance_count       = 3
    is_primary           = true
    client_endpoint_port = 2020
    http_endpoint_port   = 80
  }

  # 动态块实现second节点类型的条件生成
  dynamic "node_type" {
    # 条件控制：开启时传入单元素集合，关闭时传入空集合
    for_each = var.enable_second_node_type ? [1] : []

    # 定义生成的node_type块的具体配置，语法和普通硬编码块完全一致
    content {
      name                 = "second"
      instance_count       = 3
      is_primary           = false
      client_endpoint_port = 2021
      http_endpoint_port   = 8081
    }
  }
}

注意事项 #

• 原示例中两个node_type配置的客户端端口、HTTP端口完全重复，实际部署时会触发端口冲突错误，非主节点类型需要分配独立的端口段。
• 原示例中两个node_type都设置了is_primary = true，和Service Fabric集群仅允许单个主节点类型的规则冲突，非主节点需要将该参数设置为false。
• 如果后续需要扩展更多可配置节点类型，不需要为每个节点写单独的动态块，可以把所有可变节点的参数存在本地变量map中，通过循环批量生成全部node_type配置，进一步减少冗余代码。

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