Одна команда terraform validate не отвечает, что изменится в инфраструктуре. Она проверяет синтаксис и внутреннюю согласованность configuration, но не обращается к remote state и provider APIs. Поэтому pull request делят на быстрый безопасный контур и environment-aware plan, которому действительно нужны backend, variables и credentials.
Начните с job без production secrets: форматирование, initialization без backend и validate. Такой job можно запускать для внешнего fork. Plan переносите в отдельный доверенный контекст; он читает реальное окружение, способен раскрыть чувствительные values в output и должен использовать тот же root module, workspace и provider lock file, что будущий apply.
Три проверки отвечают на разные вопросы
| Шаг | Что подтверждает | Чего не подтверждает |
|---|---|---|
| terraform fmt -check | Канонический формат файлов | Корректность ресурсов и providers |
| terraform validate | Синтаксис, типы и внутренняя согласованность | Доступность API и ожидаемый diff |
| terraform plan | Разницу config, state и remote objects в данном контексте | Что тот же план будет актуален после других изменений |
| terraform test | Assertions из test files | Безопасность: test может создавать ресурсы |
Terraform 1.16 documentation указывает, что validate безопасно автоматизировать после init -backend=false. Для reusable module это полезная проверка без state. Для root module только plan учитывает variables и текущее workspace, поэтому зелёный validate не означает пустой или безопасный plan.
Быстрый job ничего не записывает в инфраструктуру
terraform version
terraform fmt -check -diff -recursive
terraform init -backend=false -input=false
terraform validate -no-colorКоманды запускаются в конкретном root module, а не вслепую из monorepo root. init всё равно скачивает modules и providers, поэтому CI проверяет lock file и использует доверенные registries. Cache ускоряет загрузку, но не должен подменять .terraform.lock.hcl случайной версией.
fmt с -check не переписывает файлы и возвращает ненулевой статус при отличиях. В локальном pre-commit можно разрешить terraform fmt изменять файлы, а CI показывает diff и просит автора закоммитить результат. Так review не смешивает автоматическое форматирование с логикой ресурса.
Plan запускается только в известном контексте
terraform init -input=false
terraform workspace show
terraform plan \
-input=false \
-lock-timeout=5m \
-detailed-exitcode \
-out=pr.tfplan
terraform show -no-color pr.tfplan > pr-plan.txtПути, backend и workspace задаёт pipeline, а не текст pull request. Не добавляйте -lock=false ради параллельных CI jobs: документация Terraform называет этот режим опасным. Сериализуйте plans одного workspace либо дайте им разумный lock timeout. Apply не должен использовать plan из непроверенного fork или устаревшей revision.
Exit code 2 означает diff, а не ошибку
- 0 — plan выполнен и изменений нет.
- 1 — команда завершилась ошибкой; job должен быть красным.
- 2 — plan успешен и содержит изменения; pipeline публикует review result.
- Policy решает, какие actions требуют ручного approval или запрещены.
- Warnings сохраняются полностью, а не теряются из-за короткого комментария бота.
- Plan привязывается к commit SHA, root module и workspace.
Не превращайте любой код 2 в failure: тогда полезный plan всегда будет красным. И не считайте его автоматическим успехом: replace, destroy или изменение identity policy требуют отдельного правила. Машинный анализ строят по JSON plan, но человек должен видеть краткий понятный summary и иметь доступ к защищённому полному артефакту.
Plan-файл обращаем как секретный артефакт
Saved plan и его JSON способны содержать sensitive values, несмотря на маскирование обычного console output. Ограничьте доступ, задайте короткое retention, не вставляйте весь plan в публичный PR comment и не сохраняйте cloud credentials рядом. В комментарий достаточно числа add, change, destroy, списка resource addresses и ссылки на закрытый CI artifact.
Pull request из fork нельзя наделять production secrets автоматически. Безопасные fmt и validate проходят без них; plan запускает trusted maintainer после review или отдельный защищённый workflow, который использует только содержимое проверенного commit и не исполняет произвольный скрипт автора с секретами.
Проверяем pipeline искусственной серией изменений
- Нарушить форматирование и убедиться, что падает только fmt stage.
- Добавить неверный аргумент resource и получить ошибку validate.
- Изменить tag и получить exit code 2 с одним ожидаемым update.
- Смоделировать destroy и проверить обязательное approval.
- Запустить два plan одного workspace и убедиться, что locking не отключён.
- Повторить job из fork без выдачи environment secrets.
- Изменить commit после plan и убедиться, что старый артефакт нельзя применить.
Готовый PR сообщает не просто зелёный статус, а проверенный scope: версия Terraform, module path, workspace, commit, время plan и перечень actions. Для настройки подготовьте структуру repository, список backends, CI trust model, policy для destroy/replace и пример plan без чувствительных данных.