✻ Урок 7.7 · Тема 7: IaC: Terraform и Ansible
Terraform + Ansible: конвейер с нуля, drift
Содержание урока
Как работать с кодом и когда идти дальше
Команды не нужно писать по памяти. Пользуйся примерами из урока и справкой. Ориентируйся на цель задания:
- Запусти готовое. Код приложения и вспомогательных скриптов можно скопировать. Пойми, зачем они нужны, что запускают или меняют и как проверить результат. Разбирать каждую функцию внутри готового инструмента не требуется.
- Измени по образцу. Разбери новые конструкции, объяснённые в уроке. Измени указанный параметр или часть кода, предскажи результат и проверь запуском.
- Напиши сам. Собери свой вариант под условия задания. Образцы и справка разрешены: важно объяснить своё решение и проверить его работу.
Можно идти дальше, если ты выполнил практику, получил ожидаемый результат и понимаешь, что проверил. Если задание просит изменить код, проверь и своё изменение.
Непонятные детали готового инструмента можно оставить на потом. При ошибке запуска вернись к разбору вывода и типичным ошибкам в уроке.
Зачем это нужно
Terraform умеет создать виртуальную машину (ВМ), но не знает, что внутри должен работать Docker и «Заметки». Ansible умеет настроить ВМ, но не знает, откуда она взялась и какой у неё адрес. Пока их не связали, адрес новой ВМ приходится переносить руками.
Главная беда такой работы в другом. Код описывает одну инфраструктуру, а в облаке со временем оказывается другая: кто-то поправил настройку в консоли «на минуту» и забыл. Такое расхождение называется drift (дрейф конфигурации, «уплывание»). Без проверки ты узнаешь о нём на аварии: через полгода код описывает одно, а работает другое, и восстановить сервер по коду уже нельзя.
Вот пример: в коде порт 22 (вход по SSH) открыт только для офиса, а кто-то в консоли руками добавил правило для всего интернета.
В коде: порт 22 открыт только для офиса (203.0.113.0/24)
В облаке: порт 22 открыт для всех (0.0.0.0/0)
Код и облако говорят разное, и пока никто не сравнивал их, об этом никто не знает. В этом уроке мы соберём связку: одна команда строит сервер с нуля, а по ночам автоматическая проверка сравнивает код с облаком.
Шаг проекта: в корне ~/notes появляется Makefile с целями infra-up, infra-plan, infra-down, а в .github/workflows/terraform.yml проверки fmt, validate, trivy config и ночной plan на drift.
Что нужно знать
- Урок 7.2: переменные, ВМ и outputs -
terraform output, outputpublic_ip - Урок 7.3: remote state, модули, окружения - state в бакете,
envs/dev, блокировка - Урок 7.4: инвентарь, модули, ad-hoc -
inventory.yml(список серверов для Ansible),ansible.cfg, SSH-доступ - Урок 7.6: роли и деплой «Заметок» -
site.yml, vault, идемпотентный запуск - Урок 3.3: GitHub Actions - структура workflow,
on:,permissions - Урок 3.4: безопасность CI -
trivy, минимальные права, OIDC вместо долгих ключей
Картина целиком
Представь ремонт квартиры. Сначала бригада строителей возводит стены и подключает воду (Terraform), и у квартиры появляется адрес. Потом этот адрес передают отделочникам (Ansible), и они делают внутри ремонт. Раз в ночь приходит инспектор и сверяет квартиру с проектом: ничего не чинит, только записывает расхождения и сообщает хозяину. Это ночной plan.
Как это устроено технически. Команды цепочки собраны в Makefile (файл, где короткие имена вроде make infra-up заменяют длинные цепочки команд, урок 1.6). Проверки запускает CI (continuous integration, автоматический прогон проверок после каждого изменения кода, урок 3.3). Среди них trivy config: он ищет в файлах опасные настройки, например SSH, открытый всему интернету. Честно скажу сразу: для Yandex Cloud встроенных правил у него нет, нужна своя проверка. И ещё один вопрос мы разберём в теории: править ВМ на месте или каждый раз заменять новой (mutable и immutable).
flowchart TD
G["git: terraform, ansible,<br>Makefile, workflow"] -->|"make infra-up"| A["1. terraform apply<br>ВМ, группа безопасности, диск"]
A -->|"output public_ip"| I["2. inventory.yml<br>адрес ВМ для Ansible"]
I --> W["3. wait_for_connection<br>ждём SSH, порт 22"]
W --> P["4. ansible-playbook site.yml<br>Docker, Заметки, vault"]
P --> H["http://IP/readyz = 200"]
G -.->|"ночью, по расписанию"| N["fmt, validate, trivy config,<br>plan -detailed-exitcode"]
N --> Q{"код выхода"}
Q -->|"0: всё совпало"| OK["спокойно"]
Q -->|"2: drift"| R["job красный,<br>человек разбирается"]
Части схемы:
- apply - применение кода Terraform: создание и изменение ресурсов в облаке (урок 7.1);
- inventory - список серверов для Ansible, созданный из
terraform output(урок 7.4); wait_for_connection- пауза, пока на новой ВМ не заработает SSH;plan -detailed-exitcode- «сухая» проверка с кодом выхода: 0 нет расхождений, 2 есть;fmt,validate,trivy config- проверки самих файлов кода: стиль, правильность, опасные настройки; секретов не требуют.
Теория
Кто за что отвечает в связке
Если не разделить обязанности, одна и та же настройка окажется сразу в двух инструментах, и они начнут спорить: Terraform откатит то, что сделал Ansible, или наоборот. Чёткая граница не даёт им мешать друг другу.
Помнишь ремонт из «Картины целиком»? Строители сдают квартиру с адресом, и на этом их работа закончена. Инструменты сами не договорятся, адрес им нужно передать явно.
Terraform отвечает за то, что существует: сеть, ВМ, диски, группы безопасности (security group, набор правил «кого пускать на какие порты», урок 6.2), DNS. Ansible отвечает за то, что внутри ВМ: пакеты, конфиги, сервисы, стек «Заметок». Граница проходит по ВМ. Между инструментами передаётся один факт: IP-адрес. Terraform отдаёт его через output (результат, который печатается после apply, урок 7.2), а Ansible получает его в inventory. Самый прозрачный способ: цель Makefile читает terraform output -raw public_ip и пишет inventory.yml. Есть и динамические inventory-плагины (Ansible сам спрашивает облако, какие ВМ есть), но для одной ВМ это лишняя сложность.
Порядок жёсткий: сначала apply, потом ожидание SSH (у свежей ВМ порт 22 открывается не сразу), потом ansible-playbook. Обратный порядок не работает: адреса ещё нет.
Пример: Проследим за адресом. После terraform apply в state (файл, где Terraform помнит созданное, урок 7.1) появился атрибут ВМ с внешним адресом. Блок output "public_ip" достаёт его. Команда terraform output -raw public_ip печатает строку 203.0.113.10 без кавычек. Makefile подставляет её в шаблон inventory.yml через printf. Ansible читает файл и подключается по ansible_host: 203.0.113.10 под пользователем ubuntu. Если бы адрес вписывали руками, при каждом пересоздании ВМ (а адрес при этом меняется) inventory устаревал бы.
Прикинь сам: ВМ пересоздали, и её адрес поменялся. Что нужно поправить в Ansible, если inventory генерируется из
output?
Ничего: следующий make infra-up перечитает terraform output -raw public_ip и перепишет inventory.yml. Руками адрес правят, только если inventory написан вручную.
Осторожно: «Terraform тоже умеет ставить пакеты через remote-exec, зачем Ansible». Умеет, но это одноразовый скрипт без идемпотентности и без --diff: при ошибке состояние ВМ непонятно. remote-exec годится разве что на крошечный bootstrap.
Главное: Terraform отвечает за то, что существует, Ansible за то, что внутри ВМ; между ними передаётся один факт, IP-адрес, через
output.
Проверь понимание: почему нельзя описать Docker и «Заметки» в
user_dataВМ и обойтись без Ansible?
Ответ
user_data выполняется один раз при первой загрузке ВМ. Если поправить скрипт позже, Terraform обновит метаданные на месте (~), но cloud-init сам второй раз не запустится, и правка на работающем сервере не применится (см. урок 7.2). Чтобы она сработала, ВМ надо пересоздать. Ansible применяется к живой ВМ сколько угодно раз и показывает --diff. Короткий bootstrap в user_data допустим (ключи, пользователь), но полноценная настройка живёт в Ansible.
Чтобы цепочку из нескольких команд запускали одной, её записывают в Makefile.
Makefile как единая точка входа
Цепочка из четырёх команд с переменными и подстановкой легко ломается: забыл шаг, перепутал каталог. Если цепочка записана в один файл и вызывается короткой командой, её выполнит и новичок, и CI, и ты через полгода.
Одну кнопку нажать проще, чем помнить четыре команды. Но будь внимателен: цель infra-down сносит стенд, и запускать её нужно осознанно.
Программа make читает Makefile: в нём «цели» (targets), каждая с командами. Цель вызывается как make имя. Вот минимальный пример из 8 строк:
# Каталог с кодом Terraform, задаём один раз
TF := infra/terraform/envs/dev
# Имя цели - действие, а не файл
.PHONY: plan
# Цель plan; ниже команда, отступ в ней - символ Tab
plan:
terraform -chdir=$(TF) plan
Что здесь важно:
- команда в цели начинается с символа табуляции, а не пробелов (иначе ошибка
missing separator); .PHONYговоритmake, что имя цели это не файл, а действие (иначе при наличии файлаplanmakeрешит, что делать нечего);- переменные вроде
TFзадают путь один раз, подставляются как$(TF); - флаг
-nпечатает команды, но не запускает их: удобно проверить цель перед выполнением.
Два значка, которые встретятся в нашем Makefile, разберём построчно в задании 1: это $$ и @.
Пример: Цель infra-up состоит из четырёх строк: terraform apply (создать), printf ... > inventory.yml (записать адрес), ansible ... -m wait_for_connection (дождаться SSH) и ansible-playbook site.yml (настроить). Если любая команда вернёт ошибку, make останавливается: дальше идти нельзя. Например, если apply упал, inventory не перепишется с пустым адресом.
Прикинь сам: В цели
infra-upвторая команда упала. Выполнится ли третья?
Нет: make останавливается на первой ошибке. Поэтому, если apply упал, inventory.yml не перепишется пустым адресом.
Осторожно: Пробелы вместо табуляции (ошибка missing separator) и попытку зашить в Makefile секреты. Секреты берут из окружения и vault, как в уроке 7.6.
Главное: Makefile хранит цепочку один раз: цель запускается одной командой и останавливается на первой ошибке; команды в нём начинаются с табуляции.
Проверь понимание: что напечатает
make -n infra-upи что при этом произойдёт в облаке?
Ответ
Напечатает те же команды цели, не выполняя их. В облаке не произойдёт ничего. Полезно перед первым запуском, чтобы увидеть, какие команды и с какими путями выполнятся.
Между созданием ВМ и запуском Ansible нужна пауза, пока заработает SSH.
Ожидание SSH: wait_for_connection
Terraform считает ВМ созданной, когда API облака сообщил «запущена». Но загрузка операционной системы и старт SSH-сервера (sshd) занимают ещё десятки секунд. Если запустить Ansible сразу, он получит «connection refused» или таймаут, хотя всё настроено верно.
Модуль wait_for_connection пытается подключиться к хосту по SSH и повторяет попытки, пока не получится или не истечёт timeout. В ad-hoc форме: ansible notes -m wait_for_connection -a timeout=180 (до 180 секунд). Он не устанавливает ничего на хост, только проверяет, что Ansible сможет работать.
Пример: ВМ создана в 12:00:00. К 12:00:25 API сообщает RUNNING, но sshd стартует в 12:00:50. Ansible пробует в 12:00:26 (отказ), ждёт, пробует ещё, и в 12:00:52 соединение проходит. Без ожидания плейбук упал бы с UNREACHABLE на первой же задаче.
Прикинь сам: ВМ в статусе
RUNNINGуже 10 секунд. Откроется ли с ней SSH?
Не обязательно: статус говорит про API облака, а sshd стартует после загрузки ОС, это ещё десятки секунд. Поэтому первая попытка Ansible может получить UNREACHABLE.
Осторожно: Заменяют ожидание на sleep 60. Тогда на быстрой ВМ ты теряешь время, а на медленной всё равно падаешь. Проверка готовности надёжнее фиксированной паузы.
Главное:
wait_for_connectionждёт готовности SSH сколько нужно, не дольшеtimeout, и надёжнее фиксированногоsleep.
Проверь понимание: почему первый
make infra-upиногда падает сUNREACHABLE, а сразу после ручного повтора всё проходит?
Ответ
В момент первого запуска SSH на новой ВМ ещё не поднялся. К моменту ручного повтора прошло достаточно времени. Постоянное решение: ожидание готовности (wait_for_connection) между Terraform и плейбуком, а не ручной повтор.
Когда ВМ настроена, возникает главный вопрос урока: что, если реальность потом изменят мимо кода.
Drift: код и реальность разошлись
Код описывает инфраструктуру, но реальность меняют не только через код: коллега правит настройки в консоли «на минуту», облако добавляет метку, кто-то вручную удаляет ресурс. Если об этом не знать, код перестаёт быть источником истины, а по нему уже нельзя восстановить сервер.
Вспомни инспектора из «Картины целиком»: он регулярно сверяет квартиру с проектом, и расхождения находятся вовремя. Terraform сам может привести реальность к коду, но делать это вслепую не нужно.
Drift (дрейф) это расхождение между кодом и реальной инфраструктурой. Причины: ручная правка в консоли, автомасштабирование, метка от провайдера, удалённый руками ресурс. Terraform в каждом plan делает refresh: спрашивает облако о реальном состоянии, держит сведения в памяти и сравнивает их с кодом (файл state при этом не меняется; записать обновлённые сведения можно командой terraform apply -refresh-only). Поэтому обычный terraform plan уже ловит drift. Для автоматики важен флаг -detailed-exitcode, он делает код выхода осмысленным:
| Код выхода | Значение |
|---|---|
| 0 | изменений нет, код и реальность совпадают |
| 1 | ошибка (нет доступа, битый код) |
| 2 | есть изменения: код и реальность различаются |
Без флага plan возвращает 0 и при изменениях, и без них, поэтому автоматика не отличает «всё спокойно» от «есть расхождение». Ночная проверка запускает plan -detailed-exitcode, и на коде 2 job падает, а команда получает уведомление. Важно: проверка ничего не применяет. Решение о том, что верно (код или ручная правка), принимает человек.
Тот же случай с открытым портом 22: вот как его ловит ночная проверка.
$ terraform plan -detailed-exitcode
yandex_vpc_security_group.notes: Refreshing state... [id=enp3k8v1q0x2r7m5ahtn]
Terraform will perform the following actions:
# yandex_vpc_security_group.notes will be updated in-place
~ resource "yandex_vpc_security_group" "notes" {
~ ingress {
~ v4_cidr_blocks = ["0.0.0.0/0"] -> ["203.0.113.0/24"]
# (порт 22 и протокол TCP без изменений)
}
}
Plan: 0 to add, 1 to change, 0 to destroy.
$ echo $?
2
В коде порт открыт только для офиса, поэтому Terraform хочет вернуть правило как в коде: слева от стрелки то, что сейчас в облаке, справа то, что в коде. Код выхода 2 (его печатает echo $?) означает «есть расхождение»: по нему CI поднимет тревогу. Вывод сокращён.
Ansible ловит drift своим способом: ansible-playbook site.yml --check --diff показывает, что поменялось бы, не меняя ничего. Для идемпотентной роли (урок 7.6) на здоровой ВМ итог changed=0.
flowchart TD
M["ручная правка в консоли"] --> R["реальность в облаке"]
R -->|"refresh: plan спрашивает облако"| S["state"]
C["код в git"] <-->|"сравнение"| S
S --> Q{"есть различия?"}
Q -->|"нет"| Z["код 0"]
Q -->|"да"| T["код 2: человек решает"]
T --> A["а) правка не нужна:<br>apply возвращает по коду"]
T --> B["б) правка нужна:<br>обновить код через PR"]
Пример: Коллега поменял метку ВМ через yc с env=dev на env=manual. Ночью plan делает refresh, видит, что в облаке manual, а в коде dev, и печатает ~ labels ... "manual" -> "dev" и Plan: 0 to add, 1 to change, 0 to destroy. Код выхода 2, job красный. Утром ты смотришь, кто и зачем менял (журнал аудита облака), и решаешь: метка лишняя, значит, apply вернёт dev.
Прикинь сам: Коллега в консоли поменял метку ВМ, а в коде она прежняя. Увидит ли это
terraform plan, если ни код, ни state не менялись?
Да: plan сначала делает refresh, то есть спрашивает облако о реальном состоянии, и сравнивает с кодом. Появится ~ на метке, а с флагом -detailed-exitcode код выхода будет 2.
Осторожно: «Drift это когда устарела версия Terraform». Нет. Путают также «plan без изменений значит, что всё в порядке»: он видит только ресурсы, описанные в коде. Ресурс, который создали в консоли и в код не внесли, plan не заметит (для этого есть terraform import и проверки облака, урок 7.3).
Главное: drift это расхождение кода и реальности;
plan -detailed-exitcodeотвечает кодом 0 (совпало), 1 (ошибка) или 2 (расхождение) и сам ничего не применяет.
Проверь понимание: ночной plan вернул код 2. Автоматически делать
apply?
Ответ
Нет. Изменение могло быть аварийной правкой на проде, которую нужно перенести в код, а не откатить. Автоматический apply сотрёт её и может устроить инцидент. Порядок: посмотреть diff, выяснить автора, затем либо откатить ручное изменение apply, либо обновить код под реальность (или terraform import, если создан целый ресурс).
Ночной plan берёт тот же замок, что и apply, поэтому про замок state знать нужно.
Замок state и оборванный apply
Если два человека применяют код одновременно, они могут испортить state. Замок (lock) запрещает второму процессу работать, пока первый не закончил. Но если первый процесс оборвали жёстко, замок остаётся, и его нужно уметь снять.
При apply Terraform ставит замок в backend (урок 7.3): в нашем бакете это файл .tflock рядом со state. По завершении снимает. Один Ctrl+C Terraform обрабатывает штатно: доделывает текущую операцию и снимает замок. Жёсткий обрыв (второй Ctrl+C, kill -9, потеря сети) оставляет замок. Ресурсы, которые успели создаться, остаются, а state записывает то, что успело. Terraform не откатывает, он доводит состояние следующим apply: прочитает облако, увидит недостающее и создаст.
Снять замок: terraform force-unlock <ID>, где ID указан в сообщении Error acquiring the state lock. Перед этим обязательно убедись, что никто не запускает apply: принудительное снятие при работающем процессе даст два одновременных изменения и испорченный state.
Пример: Ты оборвал apply через kill -9. Следующий plan пишет Error acquiring the state lock и показывает ID, Who (пользователь и хост) и Created (время). Ты проверяешь: ps aux | grep terraform пуст, коллеги не запускали. Выполняешь terraform force-unlock <ID>, затем plan (видно недоделанное) и apply.
Прикинь сам: Ты нажал Ctrl+C один раз посреди
apply. Останется ли замок?
Нет: Terraform доделает текущую операцию и снимет замок. Замок остаётся после жёсткого обрыва: второй Ctrl+C или kill -9.
Осторожно: Удаляют state, «чтобы начать заново»: реальные ресурсы остаются в облаке и становятся сиротами, за которые продолжают платить. Замок удаляют не вручную из бакета, а командой force-unlock.
И про сам state: секреты, которые Terraform увидел (например, пароль БД из TF_VAR_notes_db_password), лежат в нём открытым текстом (урок 7.3). Бакет со state защищай: доступ только тем, кому он нужен, и в самом ночном job ключ с правом только на чтение.
Главное: замок запрещает двоим менять state одновременно; после обрыва его снимают
force-unlock, убедившись, что никто не применяет; state не удаляют.
Проверь понимание:
applyоборвали посередине, часть ресурсов создана. Что сделать первым шагом?
Ответ
Проверить замок и убедиться, что никто не применяет. Затем plan: он покажет, что осталось недоделанным, и apply доведёт. Откатывать вручную и удалять state не нужно.
Теперь о том, как вообще жить с ВМ: править на месте или заменять.
Immutable или mutable
Когда ВМ живёт годами и её правят на месте, внутри копятся ручные правки, и точный состав ОС никто не помнит. Второй подход убирает эту проблему, но стоит дороже. Нужно понимать, что ты выбираешь.
Mutable (изменяемая) инфраструктура: ВМ правят Ansible-плейбуками на месте. Просто, но накапливается дрейф внутри ОС: «на этой ВМ ещё ставили пакет руками». Immutable (неизменяемая): ВМ не правят, а заменяют. Собрали новый образ (Packer, программа сборки образов ВМ), создали новую ВМ, переключили трафик, старую удалили. Drift в ОС ограничен временем жизни ВМ и снимается пересозданием; откат это возврат к старому образу. Цена: нужны сборка образов, балансировщик (распределяет трафик между ВМ) и внешнее хранение данных (БД и диски вне ВМ).
Пример: В «Заметках» гибрид. ВМ создаёт Terraform (её можно пересоздать: terraform apply -replace=module.notes_vm.yandex_compute_instance.notes). Операционную систему настраивает Ansible. Приложение запущено в контейнерах с закреплённым тегом (0.4.1): обновление это смена тега и перезапуск, то есть на уровне приложения мы ближе к immutable. Данные лежат на отдельном диске (notes-data) и переживают -replace ВМ. А вот terraform destroy диск удалит, если снять защиту prevent_destroy (урок 7.2).
Прикинь сам: Где в «Заметках» проходит граница между mutable и immutable?
ВМ создаёт Terraform и её можно пересоздать, ОС настраивает Ansible на месте (mutable), а приложение обновляется сменой тега контейнера (ближе к immutable). Данные лежат на отдельном диске.
Осторожно: «Immutable значит, что данные не меняются». Нет: не меняется сам образ и сервер, а данные живут вне него.
Главное: mutable правит сервер на месте и копит ручные правки, immutable заменяет сервер новым из образа; данные в любом случае хранят вне ВМ.
Проверь понимание: почему для immutable подхода БД хранят не на самой ВМ?
Ответ
ВМ при обновлении удаляют и создают заново, а вместе с ней исчезнет всё, что лежало на её диске. Данные должны жить на отдельном диске или во внешней БД, чтобы пережить замену.
Теперь о проверках, которые ловят ошибки до обращения к облаку.
Проверки кода до применения
Ошибку проще и дешевле поймать до обращения к облаку: опечатку в синтаксисе, криво отформатированный файл, порт SSH, открытый всему интернету. Проверки идут в CI автоматически, чтобы никто их не забывал.
В CI для Terraform запускают четыре проверки, от дешёвой к дорогой:
terraform fmt -check -recursive: единый стиль, код выхода 3 при расхождении (без-checkкоманда сама исправит файлы);terraform validate: синтаксис и типы, без обращения к облаку (нуженinit -backend=false, чтобы не подключаться к бакету);trivy config: статический анализ на небезопасные настройки (например, SSH открыт на0.0.0.0/0), с Trivy ты работал в уроках 3.4 и 4.8. Его встроенные правила знают ресурсы AWS, Google Cloud и Azure, а Yandex Cloud нет, поэтому для Yandex не рассчитывай на встроенные правила: открытый SSH в нашем коде он сам не заметит;terraform plan: реальное сравнение с облаком, нужны учётные данные.
Первые три идут на каждый pull request и не требуют секретов. plan с доступом к облаку запускают по расписанию и на изменениях в main. Долгоживущие ключи в secrets опасны (утечка даёт доступ надолго), поэтому предпочтительны короткоживущие токены (принцип из урока 3.4).
flowchart LR
A["fmt -check<br>стиль"] --> B["validate<br>синтаксис и типы"] --> C["trivy config<br>опасные настройки"] --> D["plan<br>сравнение с облаком"]
Первые три проверки читают только файлы и секретов не требуют, последняя ходит в облако.
Пример: Ты открыл SSH на 0.0.0.0/0 в группе безопасности. fmt и validate пройдут (код формально верен). Встроенный trivy config для ресурсов Yandex проверок не имеет и промолчит. Если же то же самое написать на ресурсе, который Trivy понимает (например, aws_security_group_rule с cidr_blocks = ["0.0.0.0/0"] на порт 22), он покажет HIGH с номером правила и строкой файла, job станет красным, и изменение не попадёт в main. Так что для Yandex этот пункт в уроке остаётся демонстрацией: настоящую защиту даст только ночной plan и ревью кода. Без проверок ошибка дожила бы до продакшена.
Для любопытных. Для Yandex Cloud можно написать свою проверку для Trivy на языке Rego (политики-правила) и подключить её ключом --config-check. Это отдельная тема, в курсе мы её не разбираем.
Прикинь сам: Какая проверка найдёт, что имя ресурса уже занято в облаке?
Только plan или apply: fmt, validate и trivy config читают файлы и про облако не знают.
Осторожно: «validate проверяет, что всё сработает». Нет: он видит только синтаксис и типы. Окажется ли имя ресурса занятым или хватит ли прав, покажет только plan и apply.
Главное: четыре проверки от дешёвой к дорогой:
fmt,validate,trivy config,plan; первые три не требуют секретов и годятся для любого pull request.
Проверь понимание: какие из четырёх проверок можно безопасно запускать на pull request из чужого форка и почему?
Ответ
fmt, validate и trivy config: они читают только файлы и не требуют секретов, поэтому у чужого кода нет способа их украсть. plan требует доступа к облаку, его на чужих pull request не запускают.
Первые три идут на каждом изменении, а plan с доступом к облаку ставят по расписанию.
Ночной drift-job в CI
Ручной запуск plan «раз в неделю» забывают. Расписание в CI делает проверку регулярной и независимой от памяти людей.
В workflow GitHub Actions (урок 3.3) блок on: schedule с выражением cron запускает job по расписанию: 0 2 * * * значит «каждую ночь в 02:00 по UTC» (cron-выражение: минута, час, день месяца, месяц, день недели). workflow_dispatch добавляет ручной запуск кнопкой. Job drift стоит после job static (needs: static): если код не проходит статические проверки, к облаку не идём. Для plan нужен доступ: токен облака и ключи для чтения state. Они лежат в secrets репозитория. -input=false запрещает интерактивные вопросы, в CI их нельзя задать. Если в коде есть переменные без значения по умолчанию, их передают через окружение: переменная TF_VAR_имя задаёт значение переменной имя (в workflow они идут из secrets или vars), либо значения по умолчанию лежат в variables.tf. Без этого plan в CI остановится с No value for required variable.
Замок в ночном job оставляем как есть, флаг -lock=false не нужен. Если прогон совпал с чьим-то apply, plan упадёт с Error acquiring the state lock (код 1), и такой красный прогон просто перезапусти. Это лучше, чем ложный diff от наполовину применённых изменений.
Код выхода 1 это ошибка (нет доступа, битый код, занятый замок), а не drift. Чтобы CI различал эти случаи, коды разбирают в оболочке:
set +e
terraform -chdir=infra/terraform/envs/dev plan -input=false -detailed-exitcode
rc=$?
set -e
case "$rc" in
0) echo "drift нет" ;;
2) echo "DRIFT: код и облако различаются"; exit 2 ;;
*) echo "ОШИБКА plan, код $rc"; exit "$rc" ;;
esac
set +e не даёт оболочке оборвать скрипт на ненулевом коде до того, как мы его прочитали; rc=$? запоминает код; set -e возвращает обычное поведение; case печатает отдельную метку для каждого случая, а exit сохраняет красный статус job.
Если нужно увидеть только то, как изменилась реальность, без предложения вернуть её к коду, есть terraform plan -refresh-only. А чтобы красный прогон заметила вся команда, к job добавляют шаг с отправкой сообщения в чат.
Бывает и ложный drift: провайдер нормализует значение (в коде одна запись, в облаке эквивалентная другая) или облако само меняет атрибут (например, служебную метку). Тогда plan красный при каждом прогоне, хотя вреда нет. Такой атрибут либо правят в коде, чтобы значения совпали, либо исключают из сравнения блоком lifecycle { ignore_changes = [...] } (урок 7.2).
Пример: Ночью в 02:00 job запускается, plan -detailed-exitcode возвращает 2, шаг падает, job красный, GitHub отправляет уведомление о падении запланированного workflow. Ничего не применилось. Утром ты открываешь лог, видишь ~ labels и разбираешься.
Прикинь сам: Ночной
planвернул код 2. Что будет с облаком к утру?
Ничего: plan ничего не применяет. Job станет красным, придёт уведомление, а решение примет человек.
Осторожно: Расписание schedule работает только на ветке по умолчанию и может запаздывать на несколько минут при нагрузке GitHub. Это нормально для ночной проверки. В публичном репозитории расписание отключается после 60 дней без активности.
Главное:
scheduleсcronзапускает проверку регулярно,-detailed-exitcodeпревращает расхождение в красный job, аneeds: staticне пускает к облаку, пока код не прошёл проверки.
Проверь понимание: почему job
driftне запускается на pull request (if: github.event_name != 'pull_request')?
Ответ
Ему нужны секреты облака, а их не дают коду из pull request (особенно из форков), иначе чужой код мог бы их прочитать. К тому же drift это свойство реальной инфраструктуры, а не конкретного изменения в коде.
Красный job это только начало: нужно решить, кто прав, код или реальность.
Что делать с drift: код или реальность
Найти расхождение мало, нужно решить, кто прав. Неверное решение в одну сторону стирает нужную аварийную правку, в другую закрепляет ошибку навсегда.
Инспектор из «Картины целиком» ничего не чинит, он сообщает хозяину, и решает хозяин, выяснив причину: либо реальность возвращают к плану, либо план исправляют под реальность.
Порядок из четырёх шагов.
- Прочитать diff в
plan: что именно и на каком ресурсе изменилось. Знак~правка на месте,+ресурса нет в облаке,-ресурс есть в state, но его блок убран из кода (Terraform хочет удалить),-/+пересоздание. - Выяснить автора и причину: журнал аудита облака (Audit Trails в Yandex Cloud, CloudTrail в AWS) показывает, кто и когда менял, и через что (консоль, API).
- Решить. Правка была ошибкой или баловством:
applyвозвращает реальность к коду. Правка нужна: переносишь её в код через pull request, после чегоplanпокажет 0 изменений. Ресурс создан руками и должен жить: описываешь его в коде и подключаешь командойterraform import(урок 7.3). - Закрыть причину: ограничить права на ручные правки в консоли (у людей только чтение, изменения через CI), чтобы drift не повторялся.
flowchart TD
P["plan показал расхождение"] --> W["кто и зачем менял?<br>журнал аудита облака"]
W --> Q{"что с правкой?"}
Q -->|"лишняя"| A["apply возвращает реальность к коду"]
Q -->|"нужна"| B["перенести в код через pull request"]
Q -->|"ресурс создан руками"| C["описать в коде и terraform import"]
A --> Z["закрыть причину: права на ручные правки"]
B --> Z
C --> Z
Пример: Ночью красный job: в группе безопасности появилось правило, которого нет в коде (порт 8080 для всех). plan показывает ~ ingress. В журнале аудита видно: дежурный открыл порт в 03:15, чтобы срочно проверить сервис. Порт больше не нужен, поэтому решение «код прав»: apply удаляет правило. Если бы порт стали использовать постоянно, правило внесли бы в vm.tf через pull request.
Прикинь сам: Дежурный ночью открыл порт 8080 в группе безопасности, и он больше не нужен. Что делаешь?
Код прав: apply удалит лишнее правило. Но сначала прочитай diff и найди автора в журнале аудита.
Осторожно: Запускают apply «чтобы позеленело», не читая diff. Так можно удалить чужую аварийную правку и устроить второй инцидент поверх первого.
Главное: сначала diff и автор, потом решение: вернуть реальность к коду, перенести правку в код через pull request или подключить ресурс через
terraform import;applyвслепую запускать нельзя.
Проверь понимание: в
planвидишь-у ресурса, которого нет в коде, но он есть в облаке и им пользуются. Что сделаешь?
Ответ
Не применять: apply удалит ресурс. Выясняю, кто и зачем убрал блок из кода. Если ресурс нужен под управлением Terraform, возвращаю блок в код (revert), и plan покажет 0 изменений. Если он должен жить вне Terraform, убираю его из state (terraform state rm <адрес>, урок 7.3, либо блок removed с lifecycle { destroy = false }). import нужен для ресурса, созданного руками: его в state нет, и plan его не показывает.
Теперь посмотрим, как всё это лежит в репозитории.
Инвентарь из output и статические проверки: как выглядит связка в файлах
Чтобы связка работала без ручных правок, все её звенья должны лежать в репозитории: Makefile, workflow, Terraform, Ansible. Человек запускает одну команду, остальное воспроизводимо.
Структура репозитория «Заметок» после этого урока:
~/notes/
Makefile цели infra-up, infra-plan, infra-down
.github/workflows/terraform.yml fmt, validate, trivy на PR; ночной plan
infra/
terraform/envs/dev/ корневой модуль (урок 7.3): ВМ, диск, SG
ansible/
ansible.cfg, inventory.yml inventory генерируется из output
site.yml, roles/, group_vars/ роли docker и notes, vault (урок 7.6)
Makefile знает оба каталога (TF и ANS) и связывает их. Workflow знает только Terraform: Ansible в ночную проверку не входит, потому что ему нужна живая ВМ и SSH.
Пример: Новый коллега клонирует репозиторий, кладёт в окружение ключи и vault-пароль, выполняет make infra-up. Через несколько минут работает ВМ с «Заметками». Все решения (размер ВМ, открытые порты, версия образа) видны в коде и проходят ревью в pull request.
Прикинь сам: Почему
inventory.ymlс реальным IP не стоит коммитить?
IP меняется при каждом пересоздании ВМ, файл устаревает и рождает конфликты. Его создаёт цель infra-up: либо добавь в .gitignore, либо считай примером для одного стенда.
Осторожно: Кладут в репозиторий сгенерированный inventory.yml с реальным IP и потом удивляются конфликтам. Генерируемые файлы либо в .gitignore, либо честно считаются «пример для одного стенда».
Главное: все звенья связки лежат в репозитории (Makefile, workflow, Terraform, Ansible), а генерируемые файлы руками не правят.
Проверь понимание: почему ночной workflow не запускает Ansible?
Ответ
Ansible нужно достучаться до ВМ по SSH, а раннер GitHub находится вне твоей сети и ключей у него нет. К тому же ночью нужно только обнаружить расхождение в облаке. Drift внутри ОС ловят отдельно: --check --diff с машины, у которой есть доступ. Ненулевой changed в --check означает либо drift, либо неидемпотентную задачу; задачи command и shell в --check не проверяются (они пропускаются).
Остался вопрос, что именно можно положить в user_data.
Bootstrap: что допустимо в user_data
ВМ нужно хоть что-то сделать при первой загрузке: положить ключ, создать пользователя, открыть путь для Ansible. Это называется bootstrap (начальная загрузка): минимальная подготовка, после которой остальное делает Ansible.
user_data (в нашем коде шаблон cloud-init.yaml.tftpl из урока 7.2) передаётся ВМ при создании, и программа cloud-init выполняет его при первой загрузке. Правило: в bootstrap только то, без чего Ansible не зайдёт (пользователь, SSH-ключ, sudo без пароля). Если поменять user_data позже, провайдер yandex обновит метаданные ВМ на месте (~), но cloud-init повторно не выполнится: изменение дойдёт до сервера только при пересоздании (-replace). Поэтому всё, что может меняться, отдают Ansible.
Пример: Изменили в user_data строку установки пакета. plan показывает ~ (правка на месте) у ВМ: метаданные обновятся, но пакет на сервере не появится, потому что cloud-init повторно не запускается. Чтобы установка сработала, нужно пересоздать ВМ через -replace: сервер будет удалён и создан заново ради одного пакета. Та же правка в роли Ansible проходит на живой ВМ за секунды.
Прикинь сам: Ты поменял в
user_dataстроку установки пакета. Появится ли пакет на работающей ВМ?
Нет: plan покажет ~, метаданные обновятся, но cloud-init повторно не запускается. Пакет появится только после пересоздания ВМ через -replace.
Осторожно: Кладут в user_data всю настройку, потому что «один файл проще». Цена: любая правка пересоздаёт ВМ, а результат невозможно проверить --diff.
Главное: в
user_dataтолько то, без чего Ansible не зайдёт (пользователь, ключ,sudo); всё, что меняется, настраивает Ansible.
Проверь понимание: что из списка допустимо в
user_data: создать пользователяubuntuс ключом, установить Docker, развернуть «Заметки»?
Ответ
Допустим только первый пункт (создание пользователя с ключом). Docker и «Заметки» меняются со временем и идемпотентно настраиваются Ansible, а не user_data.
Соберём всю цепочку в один запуск.
Сквозной разбор: что происходит при make infra-up
flowchart TD
A["1. make читает Makefile, цель infra-up"] --> B["2. terraform apply<br>спросит yes, создаст ВМ, SG, диск"]
B -.->|"не прошёл"| X2["ошибки провайдера и прав, урок 7.2"]
B --> C["3. terraform output -raw public_ip"]
C --> D["4. printf пишет inventory.yml"]
D --> E["5. wait_for_connection до 180 секунд"]
E -.->|"не прошёл"| X5["группа безопасности и ключ"]
E --> F["6. ansible-playbook site.yml<br>роли docker и notes, vault"]
F -.->|"не прошёл"| X6["цепочка урока 7.6"]
F --> G["7. PLAY RECAP: changed и failed"]
Если падает шаг 2, смотри ошибки провайдера и прав (урок 7.2). Если падает шаг 5, у ВМ нет SSH: проверь группу безопасности и ключ. Если падает шаг 6, смотри по цепочке из урока 7.6 (vault, переменные, Docker). На втором запуске apply даёт 0 added, 0 changed (Terraform идемпотентен), а Ansible changed=0. Всё, что показывает изменения на втором запуске, это ошибка в коде и повод для разбора.
Прикинь сам: Какой шаг цепочки упал, если в выводе
FAILED! ... timed out waiting for ping module test: ... Connection timed out?
Шаг 5, ожидание SSH: группа безопасности не пускает на порт 22 или ключ не тот. До плейбука дело не дошло.
Главное: при диагностике определи шаг цепочки, на котором остановились: apply, inventory, ожидание SSH или плейбук; на втором запуске везде должно быть ноль изменений.
Соответствие AWS
| Что в этом уроке | Ближайшее в AWS |
|---|---|
terraform apply + ansible-playbook |
Terraform + SSM Run Command или cloud-init |
ночной plan -detailed-exitcode |
AWS Config, CloudFormation drift detection |
trivy config |
cfn-lint, Checkov (tfsec влит в Trivy) |
| immutable: образ + пересоздание ВМ | AMI (Packer) + Auto Scaling Group instance refresh |
| Makefile как вход | CodePipeline, GitHub Actions |
terraform import |
cdk import, CloudFormation resource import |
(AWS Config это сервис, который отслеживает изменения конфигурации ресурсов; AMI это готовый образ ВМ; Auto Scaling Group это группа ВМ с автоматическим добавлением и удалением.)
Практика
Нужны: рабочие infra/terraform/envs/dev (уроки 7.1-7.3) и infra/ansible (7.4-7.6), учётные данные Yandex Cloud, vault-пароль. Облачная ВМ стоит денег: в конце обязательно make infra-down. Без облака: используй Multipass-ВМ из урока 7.4, задание 1 выполнится без terraform, а задания 2-3 читай как разбор.
Задание 1. Одна команда: от пустого облака до «Заметок»
Цель: собрать конвейер apply -> ожидание SSH -> ansible-playbook в одной цели Makefile.
Предскажи:
- Что покажет второй запуск
make infra-upподряд:Apply complete! Resources: 0 addedиchanged=0, или что-то пересоздастся? - Почему
wait_for_connectionстоит между Terraform и Ansible?
Ответ
- Нулевые изменения и в Terraform, и в Ansible: обе стороны декларативные и идемпотентные. Если что-то меняется на втором запуске, это баг кода.
- Terraform считает ВМ созданной, когда API облака вернул
RUNNING, но загрузка ОС и запускsshdидут ещё десятки секунд. Без ожидания первый запуск упадёт сUNREACHABLE.
Шаги:
-
Создай в корне
~/notesфайлMakefile(если он уже есть с целями из уроков 1.6 и 4.9, допиши цели в конец). Отступы в командах это символ табуляции, не пробелы:# Каталоги: окружение Terraform и Ansible TF := infra/terraform/envs/dev ANS := infra/ansible .PHONY: infra-up infra-plan infra-down # Только план. Код выхода 2 означает "есть расхождения" (drift) infra-plan: terraform -chdir=$(TF) plan -detailed-exitcode # Создать ВМ, записать inventory, дождаться SSH, настроить infra-up: terraform -chdir=$(TF) apply @printf 'all:\n children:\n notes:\n hosts:\n notes-vm:\n ansible_host: %s\n ansible_user: ubuntu\n' \ "$$(terraform -chdir=$(TF) output -raw public_ip)" > $(ANS)/inventory.yml cd $(ANS) && ansible notes -m wait_for_connection -a timeout=180 cd $(ANS) && ansible-playbook site.yml # Снести всё, что создал Terraform. Удалит и диск с данными! # (prevent_destroy из урока 7.2 остановит destroy: на учебном стенде # временно закомментируй его в vm.tf и верни обратно до коммита) infra-down: terraform -chdir=$(TF) destroy -
Посмотри, что выполнится, ничего не запуская:
make -n infra-up -
Запусти с нуля и подтверди
applyсловомyes:make infra-up -
Запусти второй раз:
make infra-up
Что должно получиться:
Apply complete! Resources: 0 added, 0 changed, 0 destroyed.
Outputs:
public_ip = "203.0.113.10"
PLAY RECAP *********************************************************************
notes-vm : ok=15 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
Число ok зависит от версии роли и модулей (в 7.6 у тебя могло быть другое), адрес тоже будет свой. Смотри на changed=0 и failed=0, они обязательны.
Разбор команд:
terraform -chdir=$(TF) apply:-chdirвыполняет команду так, будто ты зашёл в каталогenvs/dev;$(TF)это переменная Makefile.terraform output -raw public_ip: печатает значение output без кавычек, удобно для подстановки. Во внутренней цели Makefile пишется$$(...):makeсам считает$своим знаком (как в$(TF)), поэтому двойной$$нужен, чтобы он передал оболочке настоящий$и подстановка$(...)выполнилась уже в ней.@printf '...' "$адрес" > файл: собирает текст inventory с адресом и перезаписывает файл. Символ@в начале строки значит «не печатать саму команду перед выполнением» (вывод получается короче). Поэтому inventory не правят руками: следующийinfra-upего всё равно перепишет.ansible notes -m wait_for_connection -a timeout=180: ждёт SSH до 180 секунд.make -n infra-up: показывает команды, не выполняя.terraform destroyв целиinfra-down: удалит всё, включая дискnotes-dataс данными. Пока в коде стоитprevent_destroy(урок 7.2), команда остановится с ошибкойInstance cannot be destroyed. На учебном стенде защиту временно закомментируй и верни до коммита; на боевом стенде так не делают.
ИИ: если
make infra-upупал, отдай нейросети текст ошибки и цель Makefile (без ключей и vault-пароля): она подскажет причину, но табуляции и$$проверь сам командойmake -n.
Как читать вывод: в конце второго запуска смотри две строки. Apply complete! Resources: 0 added, 0 changed, 0 destroyed. значит, что Terraform ничего не менял. В PLAY RECAP нужны changed=0 и failed=0. Если в первом запуске apply ждёт ответа, он печатает Enter a value:: введи yes. Весь запуск на чистом облаке занимает несколько минут (создание ВМ и установка Docker), точное время зависит от сети.
Объясни себе:
- Почему inventory генерируется, а не редактируется руками?
- Что произойдёт, если
terraform outputвернёт пустую строку? - Почему
infra-planотдельная цель, а не частьinfra-up?
Типичные ошибки:
Makefile:9: *** missing separator. Stop.: в командах пробелы вместо табуляции: замени отступ на Tab.FAILED! => {"changed": false, "elapsed": 180, "msg": "timed out waiting for ping module test: Failed to connect to the host via ssh: ssh: connect to host 203.0.113.10 port 22: Connection timed out"}: SSH не поднялся заtimeoutили закрыт группой безопасности: увеличьtimeout, проверь правило 22 из урока 7.2. (UNREACHABLEвместо этого ты увидишь, если запустить обычный модуль или плейбук безwait_for_connection.)Error: No value for required variable: не заданы переменные Terraform:terraform.tfvarsилиTF_VAR_...из урока 7.2.
Задание 2. Ловим drift руками
Цель: изменить ВМ мимо кода и увидеть, что plan это замечает.
Предскажи:
- Какой код выхода вернёт
make infra-planпосле ручной правки метки ВМ? - Что покажет plan:
+,-,~или-/+?
Ответ
- Код 2,
makeнапишетError 2(для Makefile это «ненулевой код», для нас «нашли drift»). ~(изменение на месте): метки меняются без пересоздания ВМ.-/+было бы, если бы менялся параметр, требующий пересоздания.
Шаги:
-
Убедись, что расхождений нет:
make infra-plan; echo "код выхода: $?" -
Поправь метку ВМ «в консоли» (через
yc, как это сделал бы коллега):yc compute instance update notes-vm --labels env=manual -
Снова проверь план:
make infra-plan; echo "код выхода: $?" -
Приведи реальность к коду (решение «код прав»):
terraform -chdir=infra/terraform/envs/dev apply
Что должно получиться:
No changes. Your infrastructure matches the configuration.
код выхода: 0
После ручной правки:
# module.notes_vm.yandex_compute_instance.notes will be updated in-place
~ resource "yandex_compute_instance" "notes" {
~ labels = {
~ "env" = "manual" -> "dev"
}
}
Plan: 0 to add, 1 to change, 0 to destroy.
make: *** [Makefile:9: infra-plan] Error 2
код выхода: 2
Имя ресурса и метки могут отличаться, если в 7.2 ты назвал их иначе: ищи ~ и Plan: 0 to add, 1 to change.
Разбор команд:
make infra-plan; echo "код выхода: $?":;выполняет вторую команду независимо от результата первой,$?это код выхода предыдущей команды (0 успех). Безechoкод не виден.yc compute instance update notes-vm --labels env=manual: меняет метки ВМ в облаке напрямую, минуя код; это и есть «ручная правка».
Как читать вывод: ~ перед ресурсом значит «изменится на месте», стрелка "manual" -> "dev" показывает: слева то, что сейчас в облаке, справа то, что в коде. Строка Plan: 0 to add, 1 to change, 0 to destroy это итог. Строка make: *** [...] Error 2 сообщает, что код выхода 2 (для make любое ненулевое значение это «ошибка», для нас это сигнал drift).
Объясни себе:
- Откуда Terraform узнал о правке, если код и state не менялись?
- Когда верным решением будет не
apply, а правка кода? - Что было бы, если бы кто-то в консоли удалил ВМ?
Типичные ошибки:
ERROR: rpc error: code = NotFound desc = Instance with name notes-vm not found: имя ВМ в облаке другое:yc compute instance list.Error: Failed to query available provider packages: реестр недоступен из сети: зеркало из урока 7.3.Error: Error acquiring the state lock: предыдущий запуск не завершился: см. задание 3.
Задание 3. Прерванный apply и замок state
Цель: понять, что происходит с state и блокировкой, если apply оборвали.
Предскажи:
- Если прервать
applyчерез Ctrl+C, останется ли замок state? - Удалятся ли уже созданные ресурсы?
Ответ
- При одном Ctrl+C Terraform штатно завершает текущую операцию и снимает замок. При жёстком обрыве (второй Ctrl+C,
kill -9, отключение сети) замок остаётся. - Нет. Созданные ресурсы остаются, state записывает то, что успело создаться. Terraform не откатывает, он доводит состояние следующим
apply.
Шаги:
-
Сделай безопасную правку в коде
envs/dev: поменяй метку или описание ВМ (например, добавь меткуlab = "interrupt"вlabels). Такая правка применяется на месте и данные не трогает. Не меняй размер диска данных и ядра/память ВМ: для них может понадобиться остановка или пересоздание.Сначала посмотри план и убедись, что нигде нет
-/+у диска данных и ВМ. Если на диске данных стоит-/+,applyне запускай: это пересоздание, данные пропадут.terraform -chdir=infra/terraform/envs/dev plan terraform -chdir=infra/terraform/envs/dev apply - Ответь
yesи сразу нажми Ctrl+C один раз. Дождись завершения. -
Проверь, что осталось:
terraform -chdir=infra/terraform/envs/dev plan -
Заверши работу:
terraform -chdir=infra/terraform/envs/dev apply -
Отдельный сценарий с замком. Снова запусти
apply, в другом терминале найди процесс и убей его жёстко:pgrep -f "terraform.*apply" kill -9 <PID>Следующий
planсообщит о замке (если успел поставить его до обрыва). ПрочитайIDиз сообщения, убедись, что другиеterraformне запущены, и сними замок:terraform -chdir=infra/terraform/envs/dev force-unlock <ID>
Что должно получиться:
После одного Ctrl+C:
Interrupt received.
Please wait for Terraform to exit or data loss may occur.
Gracefully shutting down...
Следующий plan показывает остаток работы, а не ошибку, apply доводит его до Apply complete!. После kill -9 в сообщении будет Error acquiring the state lock с полями ID, Who, Created.
Объясни себе:
- Почему Terraform не откатывает частично применённые изменения?
- Чем опасно
terraform force-unlockи когда он оправдан? - Как связаны замок и remote state из урока 7.3?
Типичные ошибки:
Error: Error acquiring the state lock: замок держит другой процесс или остался после обрыва: сначала убедись, что никто не применяет, затемterraform force-unlock <ID>с ID из сообщения.
Задание 4. Проверки до плана: fmt, validate, trivy
Цель: прогнать локально то же, что будет выполнять CI, и поймать ошибку на стадии, где нужны нулевые секреты.
Предскажи: какая из трёх проверок ничего не знает о твоём облаке и запустится на чужой машине без ключей?
Ответ
Все три: fmt, validate (с init -backend=false) и trivy config работают только с файлами. Секреты нужны лишь для plan.
Шаги:
-
Форматирование:
terraform fmt -check -recursive infra/terraform; echo "код: $?" -
Валидация без доступа к бакету:
terraform -chdir=infra/terraform/envs/dev init -backend=false terraform -chdir=infra/terraform/envs/dev validate -
Статический анализ (Trivy установлен по уроку 3.4):
trivy config --severity HIGH,CRITICAL --exit-code 1 infra/terraform -
Специально испорти
vm.tf(лишний пробел в отступе) и повтори шаг 1, затем исправь командойterraform fmt -recursive infra/terraform.
Что должно получиться:
Success! The configuration is valid.
Как читать вывод: Success! The configuration is valid. у validate подтверждает синтаксис. У fmt -check тишина и код: 0 значат «всё отформатировано», а код: 3 и список файлов значат «есть что исправить». У trivy смотри на уровень (HIGH, CRITICAL), идентификатор правила и файл со строкой.
Для trivy config при чистом коде отчёт пустой и код выхода 0. Отчёт пустой и при открытом SSH в нашей группе безопасности: встроенных проверок для ресурсов Yandex у Trivy нет, это не значит, что код безопасен. Открытый SSH он покажет (HIGH с номером правила и строкой) только на ресурсах AWS, GCP и Azure, которые знает. Саму настройку в своём коде надо исправить (ограничить v4_cidr_blocks своим адресом) или явно принять и задокументировать.
Объясни себе:
- Почему
validateне заменяетplan? - Почему
trivyможет ругаться на то, что «работает»?
Типичные ошибки:
Error: Backend initialization required, please run "terraform init": не былоinit: выполни шаг 2.код: 3и имена файлов в выводе:fmt -checkнашёл неформатированные файлы, исправьterraform fmt -recursive. (В логе Actions та же ошибка выглядит какError: Terraform exited with code 3.: эту строку добавляет обёртка setup-terraform.)FATAL Fatal error config scan error: scan error: scan failed: неверный путь к каталогу: проверь, что запускаешь из~/notes.
Задание 5. Шаг проекта: workflow с ночной проверкой drift
Workflow перенеси как шаблон и свяжи его шаги с командами Terraform, которые уже запускал вручную. Найди расписание, получение доступа к state и обработку результата plan; различай отсутствие изменений, обнаруженный drift и ошибку самой проверки. Служебный YAML можно сверять с образцом, но причина результата ночного запуска должна быть понятна из его лога.
Цель: перенести проверки в CI, добавить ночной plan на drift, закоммитить Makefile и workflow.
Предскажи: job ночного plan увидит код 2. Какой статус будет у прогона в GitHub и что произойдёт дальше?
Ответ
Шаг с plan вернёт ненулевой код, job станет красным, GitHub пришлёт уведомление о падении запланированного workflow пользователю, который последним менял строку cron в файле (не всей команде, поэтому в реальной работе добавляют ещё оповещение в чат). Ничего не применяется и не откатывается: мы получили сигнал, разбираться будет человек.
Шаги:
-
Создай
.github/workflows/terraform.yml:name: terraform on: pull_request: paths: ["infra/terraform/**"] schedule: - cron: "0 2 * * *" # каждую ночь, 02:00 UTC workflow_dispatch: permissions: contents: read jobs: static: # Проверки без секретов: fmt, validate, trivy runs-on: ubuntu-24.04 steps: - uses: actions/checkout@v7.0.1 - uses: hashicorp/setup-terraform@v3 with: terraform_version: 1.16.4 - name: fmt run: terraform fmt -check -recursive infra/terraform - name: validate run: | terraform -chdir=infra/terraform/envs/dev init -backend=false terraform -chdir=infra/terraform/envs/dev validate - name: trivy config uses: aquasecurity/trivy-action@v0.36.0 with: scan-type: config scan-ref: infra/terraform severity: HIGH,CRITICAL exit-code: "1" drift: # Ночной plan: код выхода 2 значит "есть drift", job красный if: github.event_name != 'pull_request' needs: static runs-on: ubuntu-24.04 env: YC_TOKEN: ${{ secrets.YC_TOKEN }} AWS_ACCESS_KEY_ID: ${{ secrets.STATE_ACCESS_KEY }} AWS_SECRET_ACCESS_KEY: ${{ secrets.STATE_SECRET_KEY }} # Переменные без default (урок 7.2): terraform.tfvars в git нет TF_VAR_my_ip_cidr: ${{ vars.MY_IP_CIDR }} TF_VAR_notes_db_password: ${{ secrets.NOTES_DB_PASSWORD }} steps: - uses: actions/checkout@v7.0.1 - uses: hashicorp/setup-terraform@v3 with: terraform_version: 1.16.4 - name: init run: terraform -chdir=infra/terraform/envs/dev init -input=false - name: plan на drift run: | set +e terraform -chdir=infra/terraform/envs/dev plan -input=false -detailed-exitcode rc=$? set -e case "$rc" in 0) echo "drift нет" ;; 2) echo "DRIFT: код и облако различаются"; exit 2 ;; *) echo "ОШИБКА plan, код $rc"; exit "$rc" ;; esacВерсии в файле (
actions/checkout@v7.0.1,trivy-actionv0.36.0,setup-terraform@v3, Terraform 1.16.4) актуальны на октябрь 2026; перед использованием сверь их со страницами проектов. Для учебного стенда токен кладут вSettings -> Secrets. Ключи S3 нужны только для чтения state.TF_VAR_notes_db_passwordдолжен быть тем же паролем, с которым создавалась ВМ (урок 7.3), иначеplanпокажет ложное изменениеuser-data.В реальной работе workflow делают строже: действия закрепляют не на тегах, а на хеше коммита (SHA) с комментарием версии, права в
permissionsоставляют минимальными, а долгоживущие ключи в secrets заменяют на короткоживущий токен через OIDC (урок 3.4). Для учебного файла мы это не усложняем. -
Проверь синтаксис YAML и коммит:
python3 -c "import yaml,sys; yaml.safe_load(open('.github/workflows/terraform.yml')); print('yaml ok')" git add Makefile .github/workflows/terraform.yml git commit -m "infra: make infra-* и workflow terraform (drift)" -
В интерфейсе GitHub открой Actions, workflow
terraform, нажмиRun workflow(workflow_dispatch) и дождись результата.
Что должно получиться:
yaml ok
[main 3f2a9c1] infra: make infra-* и workflow terraform (drift)
2 files changed, 78 insertions(+)
ИИ: workflow можно набросать у нейросети, но версии действий (
setup-terraform,trivy-action) сверь на страницах проектов, а токены в файл не вставляй.
Как читать вывод: после запуска Run workflow в списке прогонов найди terraform: зелёная галочка значит, что job прошёл. В красном job открой шаг plan на drift и найди строки со знаком ~ и итог Plan: .... Если красным стал static, смотри, какой из трёх шагов (fmt, validate, trivy config) упал.
Эталон: project/notes/ в репозитории курса. В Actions job static зелёный, drift зелёный при отсутствии расхождений и красный после ручной правки из задания 2.
Объясни себе:
- Почему в ночном job замок оставляют, и что произойдёт, если
planсовпал с чьим-тоapply? - Чем плох токен со сроком жизни в год в secrets?
- Зачем в боевом workflow действия закрепляют на хеше коммита, а права
permissionsделают минимальными?
Типичные ошибки:
- Job красный, но в логе
Error: ...и код 1, а неPlan: ...: это ошибка (нет доступа, нет переменной), а не drift. Drift это код 2 и строкаDRIFTв логе. Error: Invalid workflow file: ... You have an error in your yaml syntax: смещён отступ: проверьpython3 -cиз шага 2.Error: No valid credential sources found: не заданы secrets для бэкенда:Settings -> Secrets and variables -> Actions.Error: Failed to get existing workspaces: ... AccessDenied: у ключа нет прав чтения на бакет state: рольstorage.viewerна бакет.
Сломай и почини
Поломку делаешь сам, по описанию. Меняешь ты только реальность (облако, процесс), код в git остаётся прежним.
Симптом
Выбери один из трёх сценариев.
- После пересоздания ВМ (
terraform apply -replace=module.notes_vm.yandex_compute_instance.notes)make infra-upпадает:FAILED! ... timed out waiting for ping module test: ... Permission denied (publickey)или... Connection timed out. - Ты прервал
applyпосередине (kill -9), и следующий запуск пишетError acquiring the state lock. - Ночная проверка красная, но в коде за неделю никто ничего не менял. В plan видно, что
ingressгруппы безопасности отличается от кода.
Гипотезы
Для каждого сценария запиши минимум две гипотезы до проверок. Например для первого: (а) inventory хранит старый IP, (б) новая ВМ ещё грузится, (в) в known_hosts старый отпечаток хоста на этот адрес.
Проверки
- Сценарий 1: сравни
terraform output -raw public_ipсansible_hostвinventory.yml; проверьssh ubuntu@<ip>вручную. - Сценарий 2: прочитай ID и владельца замка в сообщении об ошибке; проверь, что другой
terraformне запущен (ps aux | grep terraform); посмотриplan, что осталось недоделано. - Сценарий 3:
terraform planпокажет, что именно поменялось; в журнале аудита облака (Audit Trails) найди, кто и когда менял группу.
Исправление
Разбор всех сценариев
- Inventory устарел: IP нового ВМ другой. Причина в том, что inventory писали один раз руками. Исправление: генерировать его в цели
infra-upизterraform output(как в задании 1) и не редактировать вручную. Если ошибкаREMOTE HOST IDENTIFICATION HAS CHANGED, удали старую запись:ssh-keygen -R <ip>. - Замок остался после жёсткого обрыва. Убедись, что никто не применяет, затем
terraform force-unlock <ID>, потомplanи доведиapply. Профилактика: прерывай один раз Ctrl+C и жди, а в CI задавайtimeoutjob и не убивай процесс. - Drift: кто-то открыл порт в консоли. Решай осознанно. Если правка нужна навсегда, внеси её в код через pull request. Если нет,
applyвернёт правило по коду. В обоих случаях запиши причину, а чтобы не повторялось, ограничь права на ручные правки в консоли.
ИИ в помощь
Нейросеть быстро набросает Makefile и workflow и объяснит вывод plan, но не видит твоё облако и охотно придумывает флаги и версии действий. Общие правила работы с ней: ИИ-помощник.
Задача: прочитать plan после ночной проверки.
Вот вывод terraform plan после ночной проверки: <вставь, убрав ключи и реальные IP>. Объясни по строкам, что изменилось в облаке относительно кода и какой знак (~, +, -, -/+) у каждого ресурса. Назови два варианта решения: вернуть реальность к коду или обновить код.
Проверь ответ: сверь знаки с разделом про drift и найди автора правки в журнале аудита облака. Типичная ошибка: нейросеть советует сразу apply, «чтобы позеленело», не разобравшись, нужна ли ручная правка.
Задача: найти слабые места в цели Makefile.
Вот цель infra-up из моего Makefile: <вставь>. Проверь отступы, двойной знак доллара перед подстановкой, порядок шагов и что будет, если terraform output вернёт пустую строку. Предложи исправления.
Проверь ответ: выполни make -n infra-up и убедись, что команды печатаются без ошибок. Типичная ошибка: она переписывает табуляции в команде пробелами, и появляется missing separator.
Задача: проверить workflow с ночным drift.
Вот мой .github/workflows/terraform.yml: <вставь без секретов>. Какие шаги запускаются на pull request, к каким секретам они имеют доступ и правильно ли заданы needs и if у job drift?
Проверь ответ: убедись, что plan с секретами не идёт на pull request, а версии действий открой на страницах проектов. Типичная ошибка: она называет несуществующие версии действий и считает, что trivy config знает ресурсы Yandex Cloud.
Словарик урока
| Термин | Простыми словами |
|---|---|
| drift (дрейф) | Расхождение между кодом и реальной инфраструктурой, например ручная правка в консоли. |
| refresh | Шаг plan: спросить облако о реальном состоянии и сверить его с кодом (state не меняется). |
-detailed-exitcode |
Флаг plan: код выхода 0 нет изменений, 1 ошибка, 2 есть изменения. |
terraform output -raw |
Печать значения output без кавычек для подстановки в скрипты. |
| inventory (генерируемый) | Файл серверов Ansible, который создаётся из terraform output, а не правится руками. |
wait_for_connection |
Модуль Ansible: ждёт, пока на хосте заработает SSH. |
timeout |
Сколько секунд ждать готовности, прежде чем признать ошибку. |
Makefile |
Файл с целями: короткими именами для цепочек команд. |
| цель (target) | Именованный набор команд в Makefile: make infra-up. |
.PHONY |
Объявление, что цель это действие, а не файл. |
make -n |
Показать команды цели, не выполняя их. |
-chdir |
Флаг Terraform: выполнить команду в указанном каталоге. |
$$(...) в Makefile |
Двойной $ передаёт подстановку оболочке, а не make. |
| замок state (lock) | Запрет на одновременное изменение state; остаётся после жёсткого обрыва. |
force-unlock |
Снять зависший замок по ID; только после проверки, что никто не работает. |
plan -refresh-only |
Показать только то, как изменилась реальность, без предложения вернуть её к коду. |
-input=false |
Запретить интерактивные вопросы (нужно в CI). |
-replace= |
Флаг apply: принудительно пересоздать указанный ресурс. |
| mutable | Подход: ВМ правят на месте. |
| immutable | Подход: ВМ не правят, а заменяют новой из образа. |
| Packer | Программа сборки образов ВМ. |
terraform fmt |
Приводит файлы к единому стилю; -check только проверяет (код 3 при расхождении). |
terraform validate |
Проверка синтаксиса и типов без обращения к облаку. |
init -backend=false |
Инициализация без подключения к хранилищу state (для validate в CI). |
Trivy (trivy config) |
Сканер, который находит небезопасные настройки в файлах IaC. |
schedule и cron |
Запуск workflow по расписанию; 0 2 * * * значит каждую ночь в 02:00 UTC. |
workflow_dispatch |
Ручной запуск workflow кнопкой. |
needs |
Job запускается только после успеха указанного job. |
| Audit Trails | Журнал действий в облаке: кто, что и когда менял. |
| OIDC | Способ получить короткоживущий токен вместо хранения долгого ключа. |
Вопросы с собеседований
Раздел для повторения: ответь вслух, потом открой ответ. Короткие вопросы с пометкой [на скорость] тренируй на время: ответ за 30 секунд.
1. [junior] [часто] Что такое drift в Terraform и как его обнаружить?
Ответ
Drift это расхождение между кодом и реальной инфраструктурой, например ручная правка в консоли. terraform plan делает refresh и показывает разницу. В CI запускаю plan -detailed-exitcode по расписанию: код 2 значит, что есть расхождение.
Что хотят услышать: refresh, -detailed-exitcode и значения кодов, проверка по расписанию, только план без apply.
Красный флаг: «drift это когда версия Terraform устарела».
2. [junior] [часто] Immutable или mutable инфраструктура: в чём разница?
Ответ
При mutable сервер правят на месте, при immutable заменяют новым из образа. Immutable исключает накопление ручных правок и упрощает откат, но требует образов и внешних данных. Mutable проще на старте, но ручные правки копятся и появляется drift внутри ОС. При immutable drift в ОС ограничен временем жизни ВМ и снимается пересозданием.
Что хотят услышать: замена вместо правки, откат, drift внутри ОС, цена подхода (Packer, балансировщик).
Красный флаг: «immutable значит, что данные не меняются».
3. [middle] Ночной plan показал изменения, а в git ничего не менялось. Твои действия?
Ответ
Читаю diff: что изменилось и на каком ресурсе. В журнале аудита облака нахожу автора и время. Дальше решение: если это аварийная правка нужна, переношу в код через PR, если нет, откатываю apply. Фиксирую причину и закрываю пути ручных правок правами.
Что хотят услышать: сначала выяснить причину, не применять вслепую, аудит, процесс (PR), профилактика правами.
Красный флаг: «просто запущу apply, и всё встанет как надо».
4. [junior] Как связать Terraform и Ansible?
Ответ
Terraform создаёт ВМ и отдаёт IP через output. Скрипт или Makefile пишет по нему inventory, ждёт SSH и запускает плейбук. Terraform отвечает за существование ресурсов, Ansible за настройку внутри.
Что хотят услышать: граница ответственности, output -> inventory, ожидание SSH, порядок шагов.
Красный флаг: «настрою всё через remote-exec provisioner».
5. [middle] После пересоздания ВМ Ansible не подключается. Что проверишь?
Ответ
Сначала совпадает ли IP в inventory с текущим output. Затем доступность порта 22 и группа безопасности, ключ на новой ВМ, и не осталась ли в known_hosts старая запись. Проверяю ручным ssh -v, потом чиню причину, а не повторяю запуск.
Что хотят услышать: устаревший inventory, wait_for_connection, ssh -v, known_hosts, генерация inventory.
Красный флаг: «пересоздам ВМ ещё раз».
6. [middle] apply оборвался на середине. Что со state и что делать?
Ответ
Созданные ресурсы остаются, state содержит то, что успело записаться. Откатов нет. Проверяю замок, смотрю plan и довожу apply. Если замок завис и никто не работает, force-unlock с ID из ошибки.
Что хотят услышать: нет отката, plan как источник истины, замок и осторожный force-unlock, remote state.
Красный флаг: «удалю state и начну заново» (это осиротит реальные ресурсы).
7. [middle] Как построишь CI для Terraform-репозитория?
Ответ
На pull request без секретов: fmt -check, validate, trivy config. Затем plan и публикация результата в PR. По расписанию ночной plan на drift. apply только после ревью и по защищённой ветке, а креды короткоживущие через OIDC.
Что хотят услышать: порядок проверок, plan в PR, apply после ревью, секреты и OIDC, drift-job.
Красный флаг: «apply автоматически на каждый push».
8. [middle] Кто-то удалил ВМ в консоли. Что покажет plan и что сделаешь?
Ответ
Refresh не найдёт ресурс, plan предложит создать ВМ заново (+). Перед apply проверю, что пересоздание безопасно: адрес, данные на диске, привязки. Потом make infra-up, и Ansible настроит новую ВМ. Данные нужно восстанавливать из бэкапа.
Что хотят услышать: ресурс появится в плане как create, данные не возвращаются сами, второй шаг Ansible, бэкап.
Красный флаг: «Terraform восстановит и данные».
9. [middle] Как понять, что настройка ВМ не разошлась с Ansible-кодом?
Ответ
Запускаю ansible-playbook site.yml --check --diff. Для идемпотентной роли итог changed=0, а ненулевой changed означает либо drift, либо неидемпотентную задачу; command и shell в --check не проверяются.
Что хотят услышать: --check --diff, changed=0, ограничения check-режима у command и shell.
Красный флаг: «перезапускаю плейбук раз в день, и всё».
10. [junior] Зачем -detailed-exitcode и какие у него коды?
Ответ
Без флага plan возвращает 0 и при изменениях, и без них. С флагом: 0 нет изменений, 1 ошибка, 2 есть изменения. Это основа автоматической проверки drift.
Что хотят услышать: три кода, применение в CI, различие ошибки и drift.
Красный флаг: «код 1 это drift».
11. [middle] Как пересоздать одну ВМ через Terraform, не трогая остальные?
Ответ
Я использую terraform apply -replace="yandex_compute_instance.app" с адресом нужного ресурса. Terraform покажет в плане, что именно пересоздаст, я проверяю и подтверждаю. Раньше для этого применяли terraform taint, но сейчас команда считается устаревшей: она меняла state сразу, а -replace делает то же в рамках обычного плана с ревью. Перед пересозданием проверяю, что данные не лежат на диске этой ВМ, и что после замены Ansible прогонят заново.
Что хотят услышать: -replace с адресом ресурса, план смотрим до применения, taint устарел, данные и настройка после пересоздания.
Красный флаг: удалить ВМ в консоли, чтобы «Terraform сам пересоздал».
12. [middle] После apply сервис сломался. Как откатиться, если у Terraform нет кнопки rollback?
Ответ
Откатом служит git: я делаю git revert проблемного коммита и запускаю plan и apply на предыдущем коде. Terraform приведёт инфраструктуру к описанному состоянию, но необратимые действия он не отменит: удалённый диск с данными не вернуть, а пересозданная ВМ будет новой. Поэтому для состояний с данными нужны снимки и бэкапы, а опасные изменения я проверяю в plan заранее. Старая версия state в бакете - это не откат, а только способ восстановить потерянный state.
Что хотят услышать: откат через git и повторный apply, необратимость удаления данных, бэкапы, state не равно откат.
Красный флаг: подменить state файлом прошлой версии, чтобы «вернуть как было».
Проверено на версиях
- Terraform: 1.16.4
- OpenTofu: 1.12.6 (совместимая замена, команды
tofu) - провайдер
yandex-cloud/yandex: 0.232.0 (~> 0.232, как в уроке 7.2) - ansible-core 2.21.4 (как в уроках 7.4 и 7.5)
- Trivy: версия не закреплена, проверь актуальную версию на странице проекта
- GitHub Actions
hashicorp/setup-terraform: v3,aquasecurity/trivy-action: v0.36.0 (проверена по странице релизов) - «Заметки»: образ 0.4.1
- Ubuntu: 26.04 LTS или 24.04
- Облачная часть (
apply, ночной job в GitHub Actions) в этой версии урока не прогонялась: выводыplan,makeи Actions приведены по формату инструментов, значения примерные. - Выводы
planиmakeв заданиях сокращены; смотри на выделенные в тексте строки (~,Plan: ...,Error 2,changed=0).
Итог урока: ты умеешь
- умею одной командой
make infra-upсоздать ВМ, дождаться SSH и настроить её Ansible - умею генерировать inventory из
terraform output - умею вызвать и прочитать drift через
plan -detailed-exitcode - умею решить, что верно при drift: код или ручная правка
- умею действовать после оборванного
applyи зависшего замка state - умею настроить в CI
fmt,validate,trivy configи ночной plan - умею объяснить разницу между mutable и immutable инфраструктурой
- умею снести стенд командой
make infra-down
Дальше: Тема 8: Наблюдаемость
Проверь себя
Короткий тест по уроку: 5 вопросов из банка в 30. Засчитывается только полностью правильный ответ, порог 60%. Каждая новая попытка даёт другие вопросы, пока банк не закончится. Ответы видны после проверки.
Тест работает с включённым JavaScript.