重构Terraform代码使用for_each时如何保留原有资源不被销毁

问题原因 #

你原有单实例资源的状态地址为google_cloud_scheduler_job.job，改用for_each改造后，每个实例的状态地址会变成带索引的格式google_cloud_scheduler_job.job["<键值>"]，Terraform默认无法自动关联旧实例和新的索引地址，因此会判定旧资源需要销毁、两个新资源需要创建。

解决方案 #

你可以通过两种方式实现状态映射，避免重建第一个资源：

方法1：手动迁移状态（兼容所有Terraform版本） #

先执行状态迁移命令，将旧实例的状态关联到新的desc1对应的实例地址：

terraform state mv 'google_cloud_scheduler_job.job' 'google_cloud_scheduler_job.job["desc1"]'

执行完成后再运行terraform plan，就只会显示新增desc 2对应的实例，不会触发旧资源销毁。

如果你实际使用的是对象列表作为for_each数据源，只需要将命令中索引部分替换为你实际使用的唯一键值即可。

方法2：使用moved代码块（Terraform 1.1+ 支持） #

不需要手动操作状态，直接在你的Terraform代码中添加迁移声明块：

moved {
  from = google_cloud_scheduler_job.job
  to   = google_cloud_scheduler_job.job["desc1"]
}

添加完成后直接运行terraform plan，Terraform会自动识别状态迁移逻辑，完成旧实例地址到新索引地址的映射。待迁移生效后，这个moved块可以保留也可以删除。

注意事项 #

• 执行状态操作前建议先备份状态文件，可运行terraform state pull > tfstate_backup.json完成备份。
• 建议不要用容易变动的字段（比如示例中的description）作为for_each的键，优先选择固定不变的唯一标识（比如任务ID、固定名称），避免后续字段修改触发不必要的资源重建。

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