Provision
—— XP

Инструменты: шпаргалка Terraform

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

Этот урок — справочник раздела: команды на каждый день, ошибки, которые встретятся в первый месяц, и программы, которые ставят рядом с Terraform в компаниях. Держи его под рукой, наизусть учить не нужно.

Шпаргалка команд

Семь команд покрывают почти всю ежедневную работу.

ubuntu@stand:~$
terraform init                 # провайдеры и backend
terraform fmt                  # выровнять отступы
terraform validate             # синтаксис и типы
terraform plan                 # что изменится
terraform apply                # применить план
terraform state list           # что под управлением
terraform output               # выходные значения

Восьмая — terraform destroy, но её набирают осознанно и только там, где уверены в каталоге. Перед apply всегда читают строку Plan:, перед destroy — проверяют, в каком ты каталоге и какой там backend.

Команды есть, но ломается всё равно. Вот как это выглядит.

Быстрая отладка

Пять шагов, когда Terraform ведёт себя непонятно. Каждый отвечает на один вопрос.

ubuntu@stand:~$
terraform validate               # 1. описание вообще целое?
terraform providers              # 2. какие провайдеры нужны?
terraform state list             # 3. что Terraform помнит?
terraform plan -refresh-only     # 4. что поменяли руками?
TF_LOG=DEBUG terraform plan      # 5. что уходит в API?

Первый шаг ловит опечатки, третий показывает, о каких ресурсах Terraform вообще знает, а четвёртый с флагом -refresh-only — что поменяли руками мимо описания. providers показывает провайдеры из описания и состояния — полезно, когда init не может что-то найти. TF_LOG=DEBUG перед командой включает подробный журнал: каждый запрос к API облака и ответ на него. Вывода много, ищут в нём строку с ошибкой.

Ошибки при этом повторяются из проекта в проект, и узнавать их по тексту полезнее, чем гадать.

А это частые ошибки и их смысл.

ОшибкаЧто значитЧто делать
Failed to query available provider packagesРеестр недоступенПроверить зеркало в ~/.terraformrc
PermissionDeniedУ сервисного аккаунта нет ролиДобавить роль на каталог
already existsРесурс есть, но не в состоянииИмпортировать блоком import
Error acquiring the state lockИдёт другое применениеПодождать; force-unlock только если процесс умер
AccessDenied при initНет ключей к бакетуЗадать AWS_ACCESS_KEY_ID и AWS_SECRET_ACCESS_KEY

Разберём одну строку. already exists чаще всего появляется после того, как кто-то создал ресурс руками или потерял состояние. Удалять такой ресурс, чтобы Terraform создал его заново, — плохая идея: в нём могут быть данные. Правильный путь — импорт, как в практике 10. А вот force-unlock снимает замок принудительно, и если чужое применение на самом деле ещё идёт, состояние будет испорчено, поэтому сначала спрашивают коллег и смотрят конвейер.

Ошибки ловят, когда они уже случились. Часть из них можно поймать заранее.

Программы вокруг Terraform

В компаниях Terraform редко живёт один. Здесь достаточно знать названия и зачем каждая нужна: подключают их по мере роста.

Что ставят рядом
tflint
Проверка описания по правилам конкретного облака: несуществующий тип машины, неиспользуемые переменные.
Trivy
Проверка безопасности: открытый наружу порт 22, публичный бакет, выключенное шифрование.
infracost
Считает, сколько будет стоить то, что применит план, и пишет это в запрос на слияние.
terraform-docs
Собирает описание переменных и выходных значений в README.
Atlantis
Печатает план комментарием в запросе на слияние и применяет по команде из обсуждения.
OpenTofu
Открытая ветка Terraform. Команда tofu вместо terraform, остальное то же.

Главное правило вокруг всех этих программ одно: права на изменение облака должны быть у конвейера, а не у каждого инженера на ноутбуке. Человек читает план и нажимает кнопку, а ключи лежат в защищённых переменных CI.

Что дальше

Раздел закончен: инфраструктура описана, состояние в бакете, Ansible настраивает созданное. Дальше — Kubernetes: оркестратор, который сам раскладывает контейнеры по машинам и поднимает упавшие.

Проверь себя+240 XPдве попытки
1
Ошибки
apply падает с ошибкой already exists. Что это обычно значит?
2
Проверки
Чем tflint дополняет terraform validate?
3
Ошибки
Что делать при ошибке Error acquiring the state lock?
ответь на все вопросы, чтобы проверить

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