如何通过Terraform将Cloud SQL副本提升为主实例并受其管控

问题根因 #

通过gcloud API手动提升只读副本为主实例的操作属于Terraform生命周期外的变更，Terraform状态文件中仍保留该实例的「只读副本」属性记录，与实际实例的「主实例」属性不匹配，因此无法继续正常管控该资源。

修复步骤 #

• 步骤1：移除原只读副本资源的状态记录
  执行以下命令将原副本资源从Terraform状态文件中剔除，避免Terraform后续尝试重建或删除已提升的实例：
  terraform state rm google_sql_database_instance.<你的副本资源名>
  需将命令中的<你的副本资源名>替换为你在Terraform配置中定义的Cloud SQL副本资源的对应名称。
• 步骤2：调整Terraform配置匹配实例实际属性
  修改原副本的资源配置，移除副本专属参数，适配主实例属性：
  1. 删除配置中的master_instance_name参数
  2. 删除配置中的replica_configuration配置块
  3. 其余参数（实例规格、数据库版本、磁盘配置、地域、授权网络等）需与提升后实例的实际配置完全一致
• 步骤3：将提升后的主实例重新导入Terraform状态
  调整配置后执行导入命令，将GCP上实际运行的实例关联到Terraform配置中的对应资源：
  terraform import google_sql_database_instance.<你的新主实例资源名> <GCP项目ID>:<实例地域>:<实例实际名称>
• 步骤4：验证状态一致性
  执行terraform plan命令，确认输出无待变更、待新增、待删除的资源，即代表状态同步完成，后续可正常通过Terraform管控该实例。

临时规避方案 #

若暂时不需要调整配置，仅希望避免Terraform对已提升的实例做变更，可在原副本资源配置中新增生命周期忽略规则：

lifecycle {
  ignore_changes = [master_instance_name, replica_configuration]
}

该方案仅做临时规避，实例属性仍会存在状态不一致的问题，容灾场景验证完成后建议优先走正式修复步骤同步状态。

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