`terraform import` не угадывает ваши намерения. Он связывает существующий объект с address в state, а желаемые параметры по-прежнему задаёт configuration. Если пустой или неточный `resource` block отличается от cloud object, следующий normal plan честно предложит update либо replacement.
Остановитесь до apply. Сверьте provider account/region, уникальный ID и destination address, сделайте резервную копию state по принятой процедуре backend и получите свежий plan. Исправлять расхождение нужно в config или осознанно в инфраструктуре, а не ручным редактированием state JSON.
Три представления отвечают на разные вопросы
| Слой | Что содержит | Типовая ошибка |
|---|---|---|
| Remote object | Фактические cloud/API параметры | Выбран объект из другого account/region |
| Terraform state | Связь address, ID и прочитанные attributes | Импорт в неверный module/key |
| Configuration | Желаемые управляемые аргументы | Пустые значения и provider defaults |
| Provider schema | Computed/Optional/ForceNew semantics | Аргумент нельзя трактовать как обычный update |
| Plan | Предлагаемый переход config → remote | Replace замечен только после import |
HashiCorp указывает: import block содержит identity/ID и address, а destination `resource` block представляет ресурс в configuration. Значение ID зависит от конкретного provider; имя в консоли не всегда является import ID.
Импорт описываем кодом и проверяем plan
import {
to = example_service.app
id = "provider-specific-resource-id"
}
resource "example_service" "app" {
name = "app"
region = "region-from-provider"
# Добавляйте только проверенные управляемые аргументы
}
terraform planТип `example_service` условный: реальный resource type, формат ID и импортируемые attributes берутся из документации вашего provider и его версии. `to` должен совпасть с address resource block, включая module path и индекс `for_each`/`count`.
Сначала проверяем личность ресурса
- Сверить workspace/backend, provider alias, account/subscription и region.
- Получить ID по документации provider, а не по подписи в UI.
- Проверить destination address, module и instance key.
- После import перечитать state и remote object без изменения.
- Запустить speculative normal plan и сохранить его для review.
Если imported ID указывает не на тот объект, не применяйте plan. Удаление неверной связи из state не удаляет remote object только при корректной state-команде, но это отдельная ответственная операция: сначала подтвердите address и сделайте backup. Не используйте destroy для исправления ошибочного import.
Diff делим на computed, default и управляемое намерение
Computed fields provider читает сам; их обычно не копируют в config. Optional поля с provider/cloud defaults могут появиться в plan, если локальное значение подразумевает другое поведение. Для каждого diff откройте schema/docs: является ли аргумент управляемым, чувствительным, изменяемым и вызывает ли replacement.
Секреты не переносите из state в исходники. Если resource поддерживает ссылку на secret manager, настройте её по документации. State может содержать чувствительные значения даже при `sensitive=true`, поэтому доступ к backend и диагностическим выгрузкам ограничивают.
ignore_changes не заменяет модель ресурса
`ignore_changes` уместен, когда поле действительно управляется внешним процессом и это закреплено архитектурой. Добавлять туда весь diff после import опасно: Terraform перестанет замечать drift. Для каждого ignored attribute укажите владельца, причину и способ аудита.
Refresh-only plan предназначен для согласования state с намеренными внешними изменениями, но не объявляет их желаемой configuration. После него всё равно нужен normal plan. Режимы plan взаимоисключающие; не оценивайте готовность import только по refresh-only результату.
Нулевой plan — начало приёмки, не конец
Когда normal plan не предлагает изменений, выполните plan в CI с тем же backend/provider lock, затем проверьте policy и зависимости. Небольшое безопасное изменение проведите обычным review-процессом и откатите через configuration, чтобы убедиться, что объект действительно управляется ожидаемым address.
Диагностика не требует state целиком
Для разбора подготовьте version Terraform/provider, import block, обезличенный resource block, address, тип ID и plan diff без секретов. Полный state, backend credentials, cloud tokens и приватные значения отправлять нельзя.