Terraform更换模块/升级版本时如何避免资源触发替换重建

这种模块替换时因为资源命名/地址不匹配导致Terraform判定要删旧建新的场景，直接用terraform state mv做状态绑定就行，不用改新模块内部代码，按下面步骤操作零重建：

前置准备 #

先确认代码里已经把旧模块引用全换成新模块，参数都配好能正常跑出plan结果，你现在已经有plan输出了直接用就行：

操作前一定先备份state：用S3等远程后端的就先开版本桶或者拉一份最新state存本地，用本地state的直接复制一份tfstate文件留底，手滑写错地址随时能回滚。

操作步骤 #

1. 从plan结果里逐个抠出4对不匹配资源的完整旧资源地址和完整新资源地址
   地址就是Terraform输出里的资源全路径，对应你给的KMS别名新旧标识：
   
   
   举个实际例子：假设旧模块调用名叫module.old_s3，模块内部KMS别名的资源定义名是aws_kms_alias.bucket，那旧资源全地址就是module.old_s3.aws_kms_alias.bucket；新模块调用名叫module.new_s3，模块内部对应KMS别名的资源定义名是aws_kms_alias.bucket_dev，新资源全地址就是module.new_s3.aws_kms_alias.bucket_dev。这个地址必须和plan输出的字符串完全一致，多一层少一层module前缀、拼错资源名都会直接执行失败。
2. 逐对执行state mv命令，语法固定：

   terraform state mv <旧资源完整地址> <新资源完整地址>
   

   对应上面KMS别名的例子，实际执行命令就是：

   terraform state mv module.old_s3.aws_kms_alias.bucket module.new_s3.aws_kms_alias.bucket_dev
   

   剩下3个命名不匹配的资源，按一模一样的规则找对新旧地址，挨个跑mv命令就行。
3. 结果校验
   4个资源全迁完之后重新跑terraform plan，正常不会再出现这几个资源成对的「销毁+新建」提示。你说新旧模块功能逻辑完全一致，理想状态下plan会直接显示No changes. Your infrastructure matches the configuration.

踩坑提醒 #

• 如果新模块里的资源属性（比如KMS别名的name字段）和云上旧资源的实际值不一致，mv完第一次plan可能会出原地更新（in-place update）提示，这个是正常的，不会触发资源删除重建，只是把云上资源的属性更新成新模块定义的值，完全符合你不改新模块代码的要求。
• 要是资源在多层嵌套模块里，地址要把每层module前缀都写全，比如module.prod.module.storage.aws_kms_alias.bucket，漏写任何一层都会报找不到资源。
• 跑state迁移的时候别同时改其他资源配置，不然plan出来一堆额外变更，你都分不清是不是迁移出问题了。

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