Provision
—— XP

Цикл работы и файл состояния

теория~6 минут+240 XP

Самая дорогая привычка с Terraform — набрать apply, увидеть длинный вывод и сразу ответить yes. Где-то в этом выводе могла стоять строчка о том, что машину с базой сейчас удалят и создадут заново, с пустым диском. Этот урок учит читать вывод до того, как соглашаться, и объясняет, откуда Terraform вообще знает, что менять.

Работа с Terraform — всегда один и тот же круг из четырёх команд: подготовить, посмотреть, применить и, когда нужно, удалить. Это как ремонт по смете: прораб сначала показывает список работ, ты читаешь и соглашаешься, и только потом ломают стены. Смета здесь — план: до apply Terraform ничего не меняет, а план показывает каждое изменение заранее.

Между командами живёт файл состояния — память Terraform о том, что он уже создал. С ним связано самое строгое правило раздела, и к концу урока ты будешь знать, почему.

Четыре команды

Каждая команда отвечает за один шаг, и порядок у них всегда один.

Четыре команды сверху вниз: init скачивает провайдеры, plan сравнивает описание, состояние и реальность, apply применяет, destroy удаляет в обратном порядке.
Весь смысл в середине: plan показывает разницу до того, как что-то произойдёт.

terraform init готовит каталог: скачивает провайдеры и записывает их версии в .terraform.lock.hcl. Его запускают один раз и потом — при добавлении провайдера. terraform plan сравнивает описание с состоянием и реальностью и печатает список изменений. terraform apply показывает тот же план и после ответа yes выполняет его. terraform destroy удаляет всё, что описано, в обратном порядке.

Из четырёх команд читать вывод надо у одной — плана.

Как читать план

План — это список ресурсов, у каждого знак слева. Знаков всего четыре, и их надо узнавать с первого взгляда.

ubuntu@stand:~$
terraform plan
ubuntu@stand:~$
  # docker_container.web must be replaced
-/+ resource "docker_container" "web" {
      ~ image = "nginx:1.26" -> "nginx:1.27" # forces replacement
    }

Plan: 1 to add, 0 to change, 1 to destroy.
Знаки плана
+
Ресурс будет создан.
~
Изменится на месте, без пересоздания.
-/+
Пересоздание: удалят и создадут заново. Рядом пометка forces replacement с причиной.
-
Ресурс будет удалён.

Разберём пример. Сменили версию образа у контейнера, а образ у работающего контейнера поменять нельзя — поэтому -/+ и пометка forces replacement у поля image. Нижняя строка — итог: одно создание и одно удаление.

Эту строку Plan: читают первой. Если в ней destroy не ноль, а ты ничего удалять не собирался, — остановись и разберись. Для контейнера пересоздание безобидно, для машины в облаке это новый адрес и пустой диск.

Чтобы план вообще можно было посчитать, Terraform должен помнить, что уже создано.

Файл состояния

После apply Terraform записывает в файл terraform.tfstate, какому блоку описания соответствует какой реальный ресурс: «docker_container.web — это контейнер с идентификатором 7f2a…». Это и есть состояние.

Три сущности одна под другой: описание в файлах .tf, состояние в .tfstate со связкой блока и идентификатора, и реальность, опрашиваемая через API.
Состояние связывает описание с реальностью. Без него Terraform не знает, какой из существующих ресурсов соответствует блоку, и создаст ещё один.

Посмотреть, что в состоянии, можно одной командой.

ubuntu@stand:~$
terraform state list
ubuntu@stand:~$
docker_container.web
docker_image.nginx

Каждая строка — адрес ресурса в описании: тип и имя через точку. Если список пуст, Terraform считает, что ничего не создавал.

Раз в этом файле записано всё о ресурсах, обращаться с ним надо как с паролем — и в первую очередь решить, куда он попадёт при git add.

Что идёт в git, а что нет

В состоянии записаны все атрибуты ресурсов открытым текстом, включая пароли и ключи. Поэтому файл состояния в git не кладут никогда. Второе правило — .gitignore пишут до первого apply, а не после: один невнимательный git add ., и секреты в истории навсегда.

.gitignore, часть про Terraform
*.tfstate
*.tfstate.*
.terraform/
*.tfvars

Первые две строки — само состояние и его резервные копии. .terraform/ — скачанные провайдеры, это сотни мегабайт. *.tfvars — файлы со значениями переменных, где часто лежат секреты; о них будет урок про переменные.

А вот .terraform.lock.hcl в git идёт обязательно: в нём записаны версии провайдеров и их контрольные суммы. Без него коллега скачает другую версию и получит другой план. Где тогда хранить состояние в команде, разберём в уроке про удалённое состояние.

Словарь урока

terraform init
Готовит каталог: скачивает провайдеры и фиксирует их версии.
План
Список изменений, которые сделает apply. Ничего не меняет. ↩ к тексту
Пересоздание
Удаление и создание ресурса заново, в плане -/+ с пометкой forces replacement. ↩ к тексту
Состояние
Файл terraform.tfstate со связкой блоков описания и реальных ресурсов. Содержит секреты. ↩ к тексту
.terraform.lock.hcl
Зафиксированные версии провайдеров. Коммитится в репозиторий.

Что спросят на собеседовании

  • Почему файл состояния не хранят в git?
    В нём открытым текстом лежат все атрибуты ресурсов, включая пароли и ключи. Кроме того, при работе вдвоём нужна блокировка, которой git не даёт. Состояние хранят в удалённом хранилище.
  • На что смотреть в выводе terraform plan в первую очередь?
    На итоговую строку с числом add, change и destroy и на ресурсы со знаком -/+: пересоздание означает простой и потерю данных, а причина указана пометкой forces replacement.

Что дальше

Теории достаточно. Дальше — практика: ставим Terraform, описываем контейнер на стенде, читаем план и своими руками вызываем пересоздание.

Проверь себя+240 XPдве попытки
1
План
Что меняет в облаке команда terraform plan?
2
План
Что значит знак -/+ рядом с ресурсом в плане?
3
Состояние
Что случится, если удалить файл состояния и запустить apply?
4
Репозиторий
Какой служебный файл Terraform обязательно коммитят?
ответь на все вопросы, чтобы проверить

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