Terraform 存量资源手动导入IaC管控方案

一、适用场景解析

在云资源管理过程中，以下场景均需通过 Terraform 导入存量资源以实现统一管理：

场景一：初次使用 Terraform 管理资源，此前通过控制台、云厂商 CLI、资源编排服务或 API 直接创建和维护资源。
场景二：已长期使用 Terraform 但临时通过控制台修改了单个资源属性，需同步变更至 Terraform 状态文件（State）以保持一致性。
场景三：资源模板过于庞大，需通过拆分重构降低模板与 State 文件的管理复杂度。
场景四：Provider 版本升级后，需将新增参数同步至现有资源定义文档。

Terraform 不仅能通过模板创建、变更和删除新资源，还能通过简洁命令将游离于管理体系外的存量资源纳入管控，实现全量资源的统一生命周期管理。

二、核心操作逻辑

存量资源导入需遵循 "识别 - 声明 - 补全" 三步法则：

获取资源唯一标识（ID）

通过控制台、云厂商 CLI、API 或 Terraform DataSource 查询获取目标资源的 ID。

Terraform 存量资源手动导入IaC管控方案_ide

模板声明待导入资源

即使是导入操作，也需在 Terraform 模板中预先声明资源类型和标识，定义其在 State 文件中的存储路径。

补齐资源完整配置

导入后需根据资源实际属性完善模板定义，确保模板与 State 文件、实际资源状态完全一致。

三、详细操作步骤

3.1 获取资源 ID

方法一：通过 Web 控制台直接获取

登录云厂商控制台，进入目标资源详情页即可查看 ID（如腾讯云实例 ID 格式为ins-xxxxxx）。

方法二：通过 Terraform DataSource 查询

编写 DataSource 配置查询资源 ID，以腾讯云实例为例：

provider "tencentcloud" {region = "ap-hongkong"  # 资源所在区域
}
terraform {required_providers {tencentcloud = {source  = "tencentcloudstack/tencentcloud"version = "1.79.3"    # 适配的 Provider 版本}}
}
# 定义数据源查询条件
data "tencentcloud_instances" "default" {instance_name     = "tf-vault-server-dev"  # 资源名称availability_zone = "ap-hongkong-2"        # 可用区project_id        = 0                      # 项目 ID
}
# 输出查询到的资源 ID
output "instance_ids" {value = data.tencentcloud_instances.default.instance_list[0].instance_id
}

执行 terraform apply 后，控制台将输出资源 ID（如 ins-ma6c3q2u）：

data.tencentcloud_instances.default: Reading...
data.tencentcloud_instances.default: Read complete after 2s [id=1809210221]
Changes to Outputs:+ instance_ids = "ins-ma6c3q2u"
Apply complete! Resources: 0 added, 0 changed, 0 destroyed.

3.2 模板声明与执行导入

步骤 1：在模板中声明资源

仅需定义资源类型和标识，无需填写具体属性：

# 声明待导入的腾讯云实例
resource "tencentcloud_instance" "this" {}

步骤 2：执行导入命令

使用 terraform import 命令将资源纳入管理，格式为：

terraform import <资源类型>.<资源标识> <资源ID>

示例：

terraform import tencentcloud_instance.this ins-ma6c3q2u

步骤 3：验证导入结果

Terraform 存量资源手动导入IaC管控方案_后端_02

查看 State 文件确认资源已导入：

terraform state list（输出应包含 tencentcloud_instance.this）。

查看资源详细信息：

terraform state show 'tencentcloud_instance.this'

Terraform 存量资源手动导入IaC管控方案_后端_03

3.3 补齐资源配置并校验

步骤 1：检查配置差异

Terraform 存量资源手动导入IaC管控方案_API_04

导入后模板与 State 文件存在差异，执行 terraform plan 会提示需更新的属性（黄色警告项）。

步骤 2：补充资源属性

根据 terraform state show 输出的实际属性，完善模板定义。例如：

resource "tencentcloud_instance" "this" {image_id           = "img-l8og963d"       # 镜像 IDavailability_zone  = "ap-hongkong-2"      # 可用区allocate_public_ip = true                 # 是否分配公网 IPinstance_name      = "tf-vault-server-dev" # 实例名称system_disk_type   = "CLOUD_BSSD"         # 系统盘类型tags = {                                  # 标签"tagkey" = "xuel_tf_20240110"}
}

Terraform 存量资源手动导入IaC管控方案_腾讯云_05