如何将Terraform管理的Azure资源组整体迁移至新订阅

你可以通过批量修改Terraform状态的方式实现全量资源适配，无需逐个执行terraform rm/terraform import操作，操作步骤如下：

前置操作 #

• 先完成Azure门户侧的资源组跨订阅迁移，确认所有资源在新订阅下运行正常，务必先备份当前Terraform状态文件，不管是本地存储还是远程Backend存储的状态，都先拉取一份本地备份，避免操作异常丢失数据。
• 切换Azure CLI凭证到新订阅，或者直接更新Terraform Azure Provider配置中的subscription_id参数为新订阅ID，执行terraform init确认Provider配置正常加载。

核心状态适配操作 #

步骤1：更新状态关联的Provider实例 #

Terraform状态中会记录每个资源绑定的Provider实例信息，先执行以下命令将状态中的旧订阅关联Provider替换为当前新订阅的Provider：

terraform state replace-provider "registry.terraform.io/hashicorp/azurerm" "registry.terraform.io/hashicorp/azurerm"

步骤2：批量替换状态中的资源订阅ID #

Azure资源的唯一ID格式固定为/subscriptions/旧订阅ID/resourceGroups/xxx/...，跨订阅迁移后仅ID中的订阅ID段会变更，你可以直接导出状态批量替换后导回：

1. 导出当前状态到本地文件：
   terraform state pull > terraform.tfstate.bak
2. 复制备份文件生成新状态文件：
   cp terraform.tfstate.bak terraform_new.tfstate
3. 批量替换状态文件中的旧订阅ID为新订阅ID：
   sed -i 's/旧订阅ID字符串/新订阅ID字符串/g' terraform_new.tfstate
4. 强制将新状态推送回原Backend：
   terraform state push -force terraform_new.tfstate

步骤3：验证适配结果 #

执行terraform plan，正常情况下不会返回任何基础设施变更的提示，仅会输出配置与实际资源、状态完全匹配的结果。如果存在少量不支持跨订阅迁移、已经重新创建的资源，单独对这几个资源执行terraform state rm+terraform import即可，无需处理全量资源。

注意：如果你的Terraform配置中硬编码了旧订阅ID作为参数或者变量，需要先把这部分配置更新为新订阅ID再执行上述操作，否则会出现配置与状态不匹配的报错。如果使用了Terraform工作区管理多环境，记得先切换到对应目标工作区再操作。

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