Одна команда 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 testAssertions из 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 искусственной серией изменений

  1. Нарушить форматирование и убедиться, что падает только fmt stage.
  2. Добавить неверный аргумент resource и получить ошибку validate.
  3. Изменить tag и получить exit code 2 с одним ожидаемым update.
  4. Смоделировать destroy и проверить обязательное approval.
  5. Запустить два plan одного workspace и убедиться, что locking не отключён.
  6. Повторить job из fork без выдачи environment secrets.
  7. Изменить commit после plan и убедиться, что старый артефакт нельзя применить.

Готовый PR сообщает не просто зелёный статус, а проверенный scope: версия Terraform, module path, workspace, commit, время plan и перечень actions. Для настройки подготовьте структуру repository, список backends, CI trust model, policy для destroy/replace и пример plan без чувствительных данных.

Проверенные источники