terraci validate

Валидация проекта и конфигурации TerraCi.

Синтаксис

terraci validate [flags]

Описание

Команда validate проверяет:

• Корректность конфигурации .terraci.yaml
• Обнаружение Terraform-модулей
• Парсинг HCL-файлов
• Разрешение зависимостей
• Отсутствие циклических зависимостей

Флаги

Флаг	Сокр.	Тип	По умолчанию	Описание
--verbose	-v	bool	false	Подробный вывод
--exclude	-x	[]string		Паттерны исключения
--include	-i	[]string		Паттерны включения
--filter	-f	[]string		Фильтр по сегменту (key=value)

Примеры

Базовая валидация

terraci validate

Успешный вывод:

✓ Found 12 modules
✓ Built dependency graph with 15 edges
✓ No circular dependencies detected
✓ 4 execution levels identified

Validation passed

Подробный вывод

terraci validate --verbose

Вывод:

Configuration:
  Pattern: {service}/{environment}/{region}/{module}
  Min depth: 4
  Max depth: 5

Discovered modules:
  - platform/production/us-east-1/vpc
  - platform/production/us-east-1/eks
  - platform/production/us-east-1/rds
  - platform/production/us-east-1/app
  ...

Dependency graph:
  eks → vpc
  rds → vpc
  app → eks
  app → rds

Execution levels:
  Level 0: [vpc]
  Level 1: [eks, rds]
  Level 2: [app]

✓ Validation passed

Валидация с конфигом

terraci validate -c production.terraci.yaml

Валидация директории

terraci validate -d /path/to/terraform

Проверки

Конфигурация

• structure.pattern указан
• gitlab.image указан

Модули

• Директории содержат .tf файлы
• Модули соответствуют паттерну структуры

HCL

• Синтаксис .tf файлов корректен
• Блоки terraform_remote_state парсятся
• Переменные в путях разрешаются

Зависимости

• Все ссылки на remote_state разрешаются
• Нет циклических зависимостей
• Граф зависимостей корректен

Сообщения об ошибках

Ошибка конфигурации

Error: structure.pattern is required

Решение: Добавьте pattern в .terraci.yaml:

structure:
  pattern: "{service}/{environment}/{region}/{module}"

Модули не найдены

Warning: No modules discovered

Возможные причины:

• Глубина директорий не соответствует паттерну
• Нет .tf файлов
• Все модули исключены фильтрами

Ошибка парсинга HCL

Error: Failed to parse platform/prod/eu-central-1/vpc/main.tf: ...

Решение: Проверьте синтаксис указанного файла.

Неразрешённая зависимость

Warning: Unresolved dependency in platform/prod/eu-central-1/eks:
  data.terraform_remote_state.unknown_module

Модуль ссылается на несуществующий remote_state.

Циклическая зависимость

Error: Circular dependency detected:
  module-a -> module-b -> module-c -> module-a

Решение: Устраните циклическую зависимость в Terraform-коде.

Использование в CI

validate:
  stage: test
  script:
    - terraci validate
  rules:
    - changes:
        - "**/*.tf"
        - ".terraci.yaml"

Коды возврата

Код	Описание
0	Валидация успешна
1	Ошибка валидации
2	Ошибка конфигурации

Рекомендации

Pre-commit hook

#!/bin/sh
# .git/hooks/pre-commit

terraci validate || exit 1

Makefile

.PHONY: validate
validate:
	terraci validate --verbose

CI pipeline

stages:
  - validate
  - generate
  - deploy

validate:
  stage: validate
  script:
    - terraci validate
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"

generate:
  stage: generate
  needs: [validate]
  script:
    - terraci generate -o pipeline.yml

Смотрите также

• Структура проекта — руководство по организации Terraform-проекта
• Обзор конфигурации — справочник конфигурации .terraci.yaml