Azure DevOps+GitHub CI/CD执行Terraform时资源已存在错误问题

问题场景 #

手动删除Azure资源组后，首次Azure DevOps流水线运行成功重建资源组及容器实例；但推送代码变更后再次执行流水线，报错azurerm_resource_group.rg对应的资源ID已存在，Terraform未识别到已存在的资源。

可能原因 #

• 后端状态文件未同步：第一次运行后，Terraform状态未成功写入Azure存储后端，导致第二次运行时状态为空，Terraform尝试重新创建已存在的资源组。
• 状态文件锁定/损坏：第一次运行完成后状态文件被锁定，或存储的状态文件损坏，导致第二次运行无法读取正确的资源状态。
• 资源组定义冲突：代码中资源组配置存在重复定义，或使用count/for_each等动态逻辑时参数未匹配已创建资源。

解决步骤 #

1. 检查Terraform后端状态

   • 登录Azure门户，找到Terraform后端使用的存储账户和容器，确认terraform.tfstate文件存在，且内容包含已创建的资源组信息。
   • 若状态文件不存在，检查流水线中Terraform初始化步骤的配置，确保azurerm后端的存储账户、容器、密钥参数正确，且流水线服务主体拥有存储账户的写入权限。

2. 解锁或修复状态文件

   • 若状态文件存在但提示锁定，执行命令解锁：

     terraform force-unlock <LOCK_ID>
     

     （LOCK_ID可从报错日志中获取）
   • 若状态文件损坏，可手动导入已存在的资源组到状态：

     terraform import azurerm_resource_group.rg /subscriptions/<订阅ID>/resourceGroups/<资源组名称>
     

     执行完成后重新运行流水线。

3. 检查资源组代码定义

   • 确认代码中azurerm_resource_group.rg的配置无重复定义，且名称、位置等参数与已创建的资源组完全一致。
   • 若使用count或for_each，检查参数逻辑，避免触发重复创建。

4. 验证流水线步骤

   • 确保流水线中Terraform步骤顺序为init -> plan -> apply，且init步骤每次正确加载后端配置，未使用本地状态。

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