通过Azure Pipeline运行Terraform时AKS用户节点池反复重建如何解决

第一步：定位触发重建的根本原因 #

• 先在Azure Pipeline的Terraform任务中新增terraform plan -out=plan.out步骤，执行完成后运行terraform show plan.out查看用户节点池资源的变更详情，找到标记为# forces replacement的字段，该字段就是触发重建的直接原因。

常见触发原因及对应修复方案 #

1. 节点池名称动态计算逻辑不一致触发重建 #

你当前的节点池名称是通过动态截取规则生成的：

name = each.value.node_os == "Linux" ? substr(each.key, 0, 6) : substr(each.key, 0, 12)

如果var.additional_node_pools的key值有调整、或者substr截取后的结果和已部署的节点池名称不匹配，就会触发强制重建。
修复方法：

• 固定节点池名称的生成规则，保证和已存在的节点池名称完全匹配，或者直接在var.additional_node_pools中显式定义节点池名称，避免动态计算。
• 如果名称规则无法调整，将name字段加入lifecycle的ignore_changes列表：

lifecycle {
  ignore_changes = [
    node_count,
    name
  ]
}

2. 版本参数不匹配触发重建 #

你在用户节点池中指定了orchestrator_version = var.kubernetes_version，如果AKS集群升级后var.kubernetes_version和节点池实际运行的版本不一致，或者集群的kubernetes_version和节点池的orchestrator_version的小版本不兼容，会触发重建。
修复方法：

• 将orchestrator_version设置为和AKS集群版本直接绑定，避免使用独立变量导致的不一致：

orchestrator_version = azurerm_kubernetes_cluster.aks_cluster.kubernetes_version

• 不需要强制对齐版本的话，把orchestrator_version加入ignore_changes列表：

lifecycle {
  ignore_changes = [
    node_count,
    orchestrator_version
  ]
}

3. 可选参数隐式变更触发重建 #

你代码中注释了vnet_subnet_id参数，如果你的AKS集群部署在自定义VNET中，但是节点池没有显式指定vnet_subnet_id，或者该参数的实际值和集群默认值不一致，也会触发重建。另外availability_zones、node_taints等参数如果变量传入的空值和Azure侧返回的默认值不一致也会触发变更。
修复方法：

• 补全所有和已部署节点池配置一致的参数，不要留隐含的默认值
• 确认不需要修改的参数加入ignore_changes列表，示例：

lifecycle {
  ignore_changes = [
    node_count,
    availability_zones,
    node_taints,
    vnet_subnet_id
  ]
}

4. for_each的key变更触发重建 #

你的用户节点池使用for_each = var.additional_node_pools，如果var.additional_node_pools的key发生了变化，即使value值完全相同，Terraform也会销毁旧key对应的节点池，创建新key对应的节点池。
修复方法：

• 固定var.additional_node_pools的key值，不要随意修改
• 如果需要调整key值，先使用terraform state mv命令修改state中对应的资源地址，再执行apply操作。

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