Provision
—— XP

Практика: импорт и расхождение

практика~45 минут+600 XP

В любой компании в облаке есть ресурсы, созданные кнопками до Terraform, и ресурсы, которые поправили руками в аварию. Здесь ты на бесплатном Docker отработаешь обе ситуации: возьмёшь под управление чужой контейнер и поймаешь правку мимо описания.

Работаем в ~/infra/terraform из первых практик раздела. Там уже описан образ docker_image.nginx версии 1.26-alpine.

Шаг 1. Контейнер мимо Terraform

Создадим «старый» контейнер руками, как будто его завёл коллега год назад.

ubuntu@stand:~$
docker run -d --name legacy-web -p 8015:80 nginx:1.26-alpine
ubuntu@stand:~$
docker ps --filter name=legacy-web
ubuntu@stand:~$
CONTAINER ID   IMAGE               STATUS         PORTS                                     NAMES
8c48a8d46d74   nginx:1.26-alpine   Up 4 seconds   0.0.0.0:8015->80/tcp, [::]:8015->80/tcp   legacy-web

Контейнер работает, а terraform state list о нём ничего не знает. Заметь колонку PORTS: Docker открыл порт дважды, для IPv4 (0.0.0.0) и для IPv6 ([::]). Это пригодится через пару шагов.

Шаг 2. Полный идентификатор

Импорту нужен идентификатор ресурса в том виде, который понимает провайдер. У контейнера Docker это не имя, а полный ID из 64 знаков: так сказано в разделе Import на странице ресурса. С именем импорт упадёт с ошибкой Cannot import non-existent remote object.

ubuntu@stand:~$
docker inspect -f '{{.Id}}' legacy-web
ubuntu@stand:~$
8c48a8d46d74dc4882491e5c553c570e73ad323bf233e19510bcf1fcef6f32e8

inspect выдаёт всё, что Docker знает о контейнере, а флаг -f вырезает из этого одно поле. Первые 12 знаков совпадают с CONTAINER ID из docker ps — там ID просто укорочен.

Шаг 3. Блок импорта

Импорт объясняет Terraform: этот ресурс уже существует, запиши его к себе. Вставь свой ID целиком.

nano ~/infra/terraform/legacy.tf
import {
  to = docker_container.legacy
  id = "8c48a8d46d74dc48…"
}

Шаг 4. Описание ресурса

Импорту нужен блок resource с тем же адресом. Начнём с минимума: имя и образ.

~/infra/terraform/legacy.tf, ниже
resource "docker_container" "legacy" {
  name  = "legacy-web"
  image = docker_image.nginx.image_id
}

Образ берём из уже описанного docker_image.nginx: это тот же nginx:1.26-alpine, что у контейнера. Так кажется — первый план покажет, что не совсем.

Шаг 5. Первый план — не применять

Самый важный момент импорта — первый план. Его читают, но не применяют. Вывод длинный, вот его главные строки.

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
  # docker_container.legacy must be replaced
  # Warning: this will destroy the imported resource
-/+ resource "docker_container" "legacy" {
      + env   = (known after apply) # forces replacement
      ~ image = "nginx:1.26-alpine" -> "sha256:1eadbb…" # forces replacement
      - ports { # forces replacement
          - external = 8015 -> null
          - ip       = "0.0.0.0" -> null
        }
      - ports { # forces replacement
          - external = 8015 -> null
          - ip       = "::" -> null
        }
    }
Plan: 1 to import, 1 to add, 0 to change, 1 to destroy.

Итог читается так: импортировать, а потом снести живой контейнер и создать новый. Terraform даже пишет об этом прямо: this will destroy the imported resource. Виноваты три строки с forces replacement, и каждую мы закроем по очереди. Применять такой план нельзя.

Шаг 6. Образ строкой

В состоянии записано то, чем контейнер запущен: имя nginx:1.26-alpine. А image_id подставляет sha256:… — другую строку, и для Terraform это смена образа. Замени в ресурсе строку образа.

legacy.tf, в resource
  image = "nginx:1.26-alpine"

Дальше смотрим уже не весь план, а только строки с пересозданием и итог. Флаг -no-color убирает цветовые коды, grep с двумя -e оставляет строки, где есть любой из двух образцов; ^Plan значит «строка начинается с Plan».

ubuntu@stand:~$
terraform plan -no-color | grep -e forces -e ^Plan
ubuntu@stand:~$
      + env = (known after apply) # forces replacement
      - ports { # forces replacement
          - internal = 80 -> null # forces replacement
      - ports { # forces replacement
          - internal = 80 -> null # forces replacement
          - ip       = "::" -> null # forces replacement
Plan: 1 to import, 1 to add, 0 to change, 1 to destroy.

Образ из списка ушёл. Остались два блока портов, которых нет в описании, и env.

Шаг 7. Два порта

Добавь в ресурс два блока ports, по одному на каждую строку из колонки PORTS первого шага.

legacy.tf, в resource
  ports {
    internal = 80
    external = 8015
  }
legacy.tf, в resource, второй блок
  ports {
    internal = 80
    external = 8015
    ip       = "::"
  }

У первого блока адрес по умолчанию 0.0.0.0, у второго мы указали :: — это IPv6-запись «все адреса». Повтори команду из прошлого шага: останется одна строка с env.

Шаг 8. Поле, которое провайдер не прочитал

env — переменные окружения контейнера. При импорте провайдер их не записывает в состояние, а при сравнении считает, что они появятся только после создания, — отсюда known after apply и пересоздание. Это известная особенность провайдера Docker, и лечат её блоком lifecycle, как образ облачной машины в уроке про провайдер Yandex Cloud.

legacy.tf, в конце resource
  lifecycle {
    ignore_changes = [env]
  }
ubuntu@stand:~$
terraform plan -no-color | grep -e forces -e ^Plan
ubuntu@stand:~$
Plan: 1 to import, 0 to add, 1 to change, 0 to destroy.

Строк с forces больше нет, и в итоге 0 to destroy. Остался 1 to change: если открыть полный план, там будут только строки со знаком + у полей attach, logs, must_run, start, wait. Это настройки самого провайдера — как ему вести себя с контейнером. Их нет в Docker, поэтому импорт не может их прочитать, и применение их только запишет в состояние, контейнер не тронет. Так и выглядит безопасный импорт: ни одного destroy и replace, а change — только у служебных полей.

Шаг 9. Применить импорт

Применяем и сразу проверяем, что контейнер не перезапускался.

ubuntu@stand:~$
terraform apply
ubuntu@stand:~$
docker_container.legacy: Importing... [id=8c48a8d46d74…]
docker_container.legacy: Import complete [id=8c48a8d46d74…]
Apply complete! Resources: 1 imported, 0 added, 1 changed, 0 destroyed.
ubuntu@stand:~$
docker ps --filter name=legacy-web --format '{{.Status}}'
ubuntu@stand:~$
Up 32 minutes

Время работы то же, что до импорта: контейнер тот же. Флаг --format оставляет из таблицы одну колонку.

Шаг 10. Переименовать без пересоздания

Имя legacy в описании больше не подходит. Если просто переименовать блок, Terraform решит, что старый ресурс надо удалить, а новый создать. Правильный путь — блок moved. Сначала удали из legacy.tf блок import: свою работу он сделал, а со ссылкой на старое имя Terraform откажется переезжать с ошибкой Moved object still exists.

~/infra/terraform/legacy.tf, в конец
moved {
  from = docker_container.legacy
  to   = docker_container.imported
}

Рядом поменяй и имя в блоке resource: "legacy" на "imported".

ubuntu@stand:~$
terraform plan -no-color | grep -e moved -e ^Plan
ubuntu@stand:~$
  # docker_container.legacy has moved to docker_container.imported
Plan: 0 to add, 0 to change, 0 to destroy.

Ноль везде: Terraform понял, что это переезд адреса, а не новый ресурс. Примени terraform apply — изменится только запись в состоянии.

Шаг 11. Правка мимо Terraform

Теперь вторая ситуация: кто-то руками поменял контейнеру политику перезапуска — так часто делают в аварию.

ubuntu@stand:~$
docker update --restart always legacy-web

Подкоманда update меняет настройки работающего контейнера, флаг --restart always велит перезапускать его всегда. Docker в ответ печатает имя контейнера. Посмотрим, заметит ли Terraform.

ubuntu@stand:~$
terraform plan -refresh-only
ubuntu@stand:~$
Note: Objects have changed outside of Terraform

  # docker_container.imported has changed
  ~ resource "docker_container" "imported" {
      ~ restart = "no" -> "always"
    }

-refresh-only только сравнивает состояние с реальностью и ничего не предлагает менять. В состоянии записано no — значение по умолчанию, — а на деле уже always.

Шаг 12. Решить, кто прав

Дальше два пути. Если правка была случайной, обычный terraform apply вернёт no. Если осознанной — её переносят в описание. Сделаем второе: допиши в ресурс строку restart = "always".

ubuntu@stand:~$
terraform plan -no-color | grep -e ^Plan -e 'No changes'
ubuntu@stand:~$
No changes. Your infrastructure matches the configuration.

Строку итога ищем grep, а не берём последнюю строку вывода: после итога Terraform печатает примечание Note: You didn't use the -out option…, и последней оказалась бы его хвостовая строка.

Описание догнало реальность, и план пуст. Это и есть правильный конец любой ручной правки: она либо откатывается, либо попадает в описание.

Шаг 13. Отчёт

Запиши, что показал каждый план, — так легче запомнить, какой из них безопасен.

nano ~/devops-lab/reports/terraform-import.txt
Импорт и расхождение — 01.10.2026

import по полному ID; первый план -/+, 1 to destroy — не применял
image строкой, два ports (0.0.0.0 и ::), ignore_changes = [env]
-> 1 to import, 0 to destroy, change только служебных полей
moved legacy -> imported: 0 to add, 0 to destroy
docker update --restart always руками -> plan -refresh-only
  показал restart no -> always; перенёс в описание, план пустой

Сдай задание командой из блока проверки.

Что дальше

Все части на месте: облачный провайдер, состояние в бакете, импорт и расхождение. Дальше — миссия: Terraform поднимает машину в облаке, Ansible ставит на неё nginx.

Практика 05+600 XP

Импортировать живой ресурс, не уронив его, и узнавать по плану, что реальность разошлась с описанием.

  • Контейнер под управлением
  • Старый адрес ушёл
  • Контейнер жив
  • План пуст
  • Расхождение разобрано
Команда сдачи — выполни на своей машине
команда
cd ~/infra/terraform 2>/dev/null || echo NODIR; terraform state list; docker ps --filter name=legacy-web --format '{{.Names}} {{.Status}}'; echo "NOCHANGE=$(terraform plan -no-color | grep -c 'No changes')"; echo ---; cat ~/devops-lab/reports/terraform-import.txt

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.