Terraform Provider Azurerm 创建 MySQL 灵活服务器副本的注意事项

在使用 Terraform Provider Azurerm 创建 MySQL 灵活服务器副本时，开发者可能会遇到一个常见但文档中未明确说明的限制条件。本文将详细介绍这一问题及其解决方案。

问题现象

当尝试使用 azurerm_mysql_flexible_server 资源创建 MySQL 副本服务器时，即使正确指定了 source_server_id 参数，Terraform 仍会返回错误："Invalid value given for parameter SourceServerId. Specify a valid parameter value"。

根本原因

经过深入分析和测试验证，发现这与 PostgreSQL 灵活服务器的行为不同：MySQL 灵活服务器的副本必须与其主服务器位于同一个资源组(Resource Group)中。这一限制在 Azure 门户界面中也有所体现 - 当通过 UI 创建副本时，资源组字段是灰色不可编辑状态。

解决方案

要成功创建 MySQL 灵活服务器副本，必须确保：

1. 副本服务器的 resource_group_name 参数值与主服务器相同
2. 副本服务器的 location 参数值也应与主服务器一致

正确的配置示例如下：

resource "azurerm_mysql_flexible_server" "primary" {
  name                = "mysql-primary-server"
  resource_group_name = "my-resource-group"
  location            = "eastus"
  # 其他必要配置...
}

resource "azurerm_mysql_flexible_server" "replica" {
  name                = "mysql-replica-server"
  resource_group_name = "my-resource-group" # 必须与主服务器相同
  location            = "eastus"            # 必须与主服务器相同
  create_mode         = "Replica"
  source_server_id    = azurerm_mysql_flexible_server.primary.id
  # 其他必要配置...
}

最佳实践建议

1. 资源组规划：在设计 MySQL 灵活服务器架构时，提前规划好资源组结构，为主服务器和其副本预留同一个资源组

2. 模块化设计：如果使用 Terraform 模块，可以考虑将主服务器和副本服务器放在同一个模块中管理，确保资源组一致性

3. 文档参考：虽然当前官方文档未明确说明此限制，但在实现时应以实际测试结果为准

4. 错误排查：遇到类似参数无效的错误时，首先检查服务间的依赖关系和限制条件

总结

Azure 的 MySQL 灵活服务器在副本创建时有着与 PostgreSQL 不同的资源组限制要求。了解这一差异对于成功部署高可用架构至关重要。希望本文能帮助开发者避免在此问题上浪费时间，更高效地完成基础设施部署。