Этот урок — справочник раздела: команды на каждый день, ошибки, которые встретятся в первый месяц, и программы, которые ставят рядом с Terraform в компаниях. Держи его под рукой, наизусть учить не нужно.
Шпаргалка команд
Семь команд покрывают почти всю ежедневную работу.
terraform init # провайдеры и backend terraform fmt # выровнять отступы terraform validate # синтаксис и типы terraform plan # что изменится terraform apply # применить план terraform state list # что под управлением terraform output # выходные значения
Восьмая — terraform destroy, но её набирают осознанно и только там, где уверены в каталоге. Перед apply всегда читают строку Plan:, перед destroy — проверяют, в каком ты каталоге и какой там backend.
Команды есть, но ломается всё равно. Вот как это выглядит.
Быстрая отладка
Пять шагов, когда Terraform ведёт себя непонятно. Каждый отвечает на один вопрос.
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 редко живёт один. Здесь достаточно знать названия и зачем каждая нужна: подключают их по мере роста.
Главное правило вокруг всех этих программ одно: права на изменение облака должны быть у конвейера, а не у каждого инженера на ноутбуке. Человек читает план и нажимает кнопку, а ключи лежат в защищённых переменных CI.
Что дальше
Раздел закончен: инфраструктура описана, состояние в бакете, Ansible настраивает созданное. Дальше — Kubernetes: оркестратор, который сам раскладывает контейнеры по машинам и поднимает упавшие.