Импорт существующих ресурсов

Иногда облачные ресурсы создаются вручную или с помощью других инструментов. Импорт Terraform позволяет передать эти существующие ресурсы под управление Terraform.

После этого Terraform будет отслеживать их состояние, а будущие изменения можно будет применять через файлы конфигурации. Это важный шаг при внедрении инфраструктуры как кода (IaC) в среде «brownfield».

Импорт полезен в нескольких ситуациях:

• Перенос существующей инфраструктуры: добавление ресурсов, созданных вне Terraform, в рабочий процесс IaC.
• Постепенное внедрение Terraform: начало работы с существующими ресурсами вместо пересоздания всего с нуля.
• Восстановление после потери состояния: повторная связь Terraform с ресурсами, если файл состояния был утрачен (хотя при использовании удалённого состояния такое случается редко).

Базовая структура команды terraform import проста. Она указывает Terraform найти существующий ресурс у Вашего облачного провайдера и добавить его в файл состояния, связав с блоком ресурса в конфигурации.

Для этого требуются две основные части информации: Terraform-адрес ресурса и ID этого ресурса у облачного провайдера.

Адрес ресурса — это способ, которым Terraform идентифицирует определённый ресурс в конфигурации. Он соответствует шаблону resource_type.resource_name.

• resource_type: тип ресурса (например, aws_s3_bucket, azurerm_resource_group).
• resource_name: локальное имя, которое Вы присваиваете ресурсу в конфигурации Terraform (например, my_bucket, web_app).

Этот адрес уже должен существовать в Ваших файлах .tf.

Каждый ресурс у облачного провайдера (например, AWS, Azure, GCP) имеет уникальный идентификатор, который часто называют ID. Этот ID понадобится, чтобы указать Terraform, какой именно существующий ресурс следует импортировать.

Найти ID можно в консоли облачного провайдера, с помощью его CLI или через API. Например, ID корзины AWS S3 — это её имя, а у экземпляра EC2 есть ID экземпляра, например i-0abcdef1234567890.

Критически важный шаг: перед запуском terraform import в файлах конфигурации Terraform (.tf) должен быть определён соответствующий блок ресурса.

Этот блок сообщает Terraform, какой тип ресурса следует ожидать и какие атрибуты он должен иметь. При импорте Terraform использует это определение, чтобы понять схему ресурса.

Предположим, у Вас уже есть корзина AWS S3 с именем my-existing-coddykit-bucket-123. Сначала определите для неё блок ресурса в файле main.tf:

Теперь, когда у Вас есть определение HCL, можно выполнить команду terraform import. Замените my-existing-coddykit-bucket-123 фактическим именем/ID существующей корзины.

Убедитесь, что Вы уже выполнили terraform init в своём каталоге!

После успешного импорта Terraform добавит ресурс в файл состояния. Проверить это можно с помощью команды terraform state show, которая отображает атрибуты импортированного ресурса с точки зрения Terraform.

Затем обязательно выполните terraform plan, чтобы убедиться в отсутствии неожиданных различий между HCL и фактическим состоянием импортированного ресурса.

Вы хотите импортировать существующий экземпляр AWS EC2 в Terraform. Какой из перечисленных шагов MUST быть выполнен до запуска команды terraform import?

Вы узнали, как передавать существующие облачные ресурсы под управление Terraform с помощью terraform import.

• Сначала определите блок ресурса в HCL.
• Затем найдите ID ресурса у облачного провайдера.
• Наконец, выполните terraform import ADDRESS ID.
• Всегда после этого выполняйте terraform plan, чтобы согласовать все различия.

Эта мощная команда помогает устранить разрыв между инфраструктурой, управляемой вручную, и полностью ориентированной на IaC средой.