使用Terraform配置Azure Postgres灵活服务器pgBouncer的方案咨询

你当前采用azurerm_postgresql_flexible_server_configuration配合for_each批量传参的写法，是现阶段azurerm Provider未原生集成pgBouncer独立配置块场景下的最优方案，代码整洁度、可维护性都符合Terraform最佳实践，但有几个容易遗漏的配置要点需要注意：

• 不要漏写核心启用参数：你给出的示例参数里没有pgbouncer.enabled，这个是开关项，必须设置为"true"，其余pgBouncer相关参数才会生效。
• 严格注意参数名大小写：示例里写的pgBouncer.max_client_conn、pgBouncer.pool_mode大小写错误，Azure PostgreSQL灵活服务器所有pgBouncer相关参数的前缀都是全小写的pgbouncer.，大小写不匹配会直接导致参数下发失败。
• 统一参数值类型：所有参数值都要以字符串格式传入，不要直接传数字、布尔类型值。比如pgbouncer.enabled要传"true"而非原生布尔值true，连接数、超时类的数值也要用引号包裹为字符串，避免触发Terraform类型校验错误。
• 补全显式依赖声明：虽然代码里通过server_id引用服务器实例ID在多数场景下可以隐式推断依赖，还是建议在配置资源块里加上depends_on = [azurerm_postgresql_flexible_server.postgres-fs]，避免服务器未完全进入就绪状态就下发配置导致的参数应用失败。
• 提前适配连接端口：pgBouncer启用后默认监听实例的6432端口，而非PostgreSQL原生的5432端口，后续配置应用连接串、防火墙规则、关联云资源的时候，要注意把端口调整为6432，否则无法正常连接池化代理。
• 留意生效影响：首次开启pgbouncer.enabled时会拉起pgBouncer组件，会出现秒级连接闪断，建议把首次配置操作安排在业务低峰期执行；其余pgBouncer运行参数调整无需重启实例，即时生效。

修正后的参考配置代码如下：

locals {
  pg_config = {
    "pgbouncer.enabled"           : "true",
    "pgbouncer.pool_mode"         : "TRANSACTION",
    "pgbouncer.default_pool_size" : "50",
    "pgbouncer.max_client_conn"   : "5000",
    # 按需补充剩余pgBouncer参数，注意所有参数名全小写、值为字符串格式
  }
}

resource "azurerm_postgresql_flexible_server_configuration" "postgres_fs_config" {
  for_each  = local.pg_config
  name      = each.key
  value     = each.value
  server_id = azurerm_postgresql_flexible_server.postgres-fs.id

  depends_on = [azurerm_postgresql_flexible_server.postgres-fs]
}

等后续azurerm Provider正式在azurerm_postgresql_flexible_server主资源中支持pgBouncer专属配置块后，再迁移到原生配置方式即可，当前的批量循环写法比逐个声明独立配置资源要简洁得多，没有架构层面的问题。

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