Azure DevOps中Terraform使用betr-io/mssql执行init持续失败如何解决

一、配置错误排查与修复 #

你遇到的报错核心是Terraform在默认的hashicorp命名空间下查找betrio-mssql provider，而非你指定的betr-io命名空间，常见原因及修复方法如下：

• 子模块未声明provider源
  如果你的mssql_user资源定义在子模块中，子模块必须同样声明required_providers块指定betrio-mssql的源，否则Terraform会默认从hashicorp命名空间拉取。在子模块的terraform块中添加如下配置即可：

terraform {
  required_providers {
    betrio-mssql = {
      source  = "betr-io/mssql"
      version = "0.2.1"
    }
  }
}

• 残留缓存导致的识别错误
  之前错误init生成的缓存文件可能会导致provider源识别异常，先删除本地的.terraform目录和.terraform.lock.hcl文件，再重新执行terraform init即可。
• 拼写校验
  确认所有配置中betrio-mssql的拼写完全一致，没有大小写或字符错误。

二、替代方案推荐 #

如果第三方provider的兼容性问题无法解决，推荐以下两种更稳定的方案适配你的业务场景：

方案1：使用AzureRM官方资源（优先推荐） #

新版AzureRM provider已经原生支持SQL数据库用户、权限分配的管理能力，无需依赖第三方provider，配置示例如下：

# 创建SQL数据库用户
resource "azurerm_mssql_database_user" "example" {
  name        = var.username
  database_id = azurerm_mssql_database.example.id
  password    = random_password.password[0].result
}

# 分配db_owner角色
resource "azurerm_mssql_database_role_assignment" "example" {
  database_id  = azurerm_mssql_database.example.id
  role_name    = "db_owner"
  principal_id = azurerm_mssql_database_user.example.id
}

该方案和Azure生态原生集成，稳定性、兼容性远高于第三方provider，完全满足你为每个ADF创建专属用户、密码存入Key Vault的业务需求。

方案2：使用local-exec执行SQL命令 #

如果有更复杂的权限配置需求，可通过local-exec调用sqlcmd工具执行创建用户的SQL语句，示例如下：

resource "null_resource" "create_sql_user" {
  triggers = {
    username = var.username
    password = random_password.password[0].result
  }
  provisioner "local-exec" {
    command = <<EOT
sqlcmd -S ${var.sql_host_name} -d ${var.sqldb_name} -U ${var.sql_admin_user} -P ${var.sql_admin_pass} -Q "CREATE USER ${var.username} WITH PASSWORD = '${random_password.password[0].result}'; ALTER ROLE db_owner ADD MEMBER ${var.username};"
EOT
  }
}

使用该方案需要确保执行Terraform的环境（包括Azure DevOps代理）已安装sqlcmd工具，且具备SQL Server的管理员权限。

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