如何将手动创建的CloudSQL实例纳入Terraform状态管理？

1. 确保Terraform配置与实例完全匹配 #

先检查你的instance.tf文件中定义的google_sql_database_instance资源参数，必须和已存在的CloudSQL实例完全一致，包括但不限于：

• 实例名称（name）
• 区域（region）
• 机器类型（settings.tier）
• 磁盘类型/大小（settings.disk_type、settings.disk_size）
• 数据库版本（database_version）
• 网络配置（settings.ip_configuration）

如果配置和实际实例有差异，后续执行terraform plan会出现不必要的变更，甚至导致实例被修改。

2. 使用terraform import导入实例到状态文件 #

执行以下命令将现有CloudSQL实例导入Terraform状态：

terraform import google_sql_database_instance.<你的资源名称> <GCP项目ID>:<实例区域>:<实例名称>

举个实际例子：
假设你的Terraform资源名称是prod_sql，GCP项目ID是my-gcp-project，实例位于us-central1区域，实例名称是prod-mysql-instance，命令就是：

terraform import google_sql_database_instance.prod_sql my-gcp-project:us-central1:prod-mysql-instance

3. 验证导入结果 #

导入完成后，运行terraform plan命令，正常情况下应该输出No changes. Your infrastructure matches the configuration.，这说明状态文件和配置、实际实例已经完全对齐。

如果有变更提示，说明配置文件和实例参数不匹配，需要调整instance.tf的配置，直到plan显示无变更为止。

额外注意事项 #

• 如果你的CloudSQL还有关联资源（比如数据库用户、指定数据库），需要用对应的terraform import命令导入这些资源，例如：
  • 导入数据库：terraform import google_sql_database.<资源名称> <项目ID>:<区域>:<实例名称>:<数据库名称>
  • 导入用户：terraform import google_sql_user.<资源名称> <项目ID>:<区域>:<实例名称>:<用户名>
• 导入后建议备份一次Terraform状态文件（terraform state pull > state-backup.tfstate），避免操作失误丢失状态。

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