CLI-команды

TerraCi предоставляет набор команд для работы с Terraform-проектами.

Установка

# Из исходников
go install github.com/edelwud/terraci@latest

# Docker
docker run --rm -v $(pwd):/workspace ghcr.io/edelwud/terraci generate

Глобальные флаги

Флаг	Сокращение	По умолчанию	Описание
--config	-c	.terraci.yaml	Путь к файлу конфигурации
--dir	-d	.	Рабочая директория
--verbose	-v	false	Подробный вывод
--help	-h		Показать справку

Команды

generate

Генерация GitLab CI пайплайна:

terraci generate -o .gitlab-ci.yml

validate

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

terraci validate

graph

Визуализация графа зависимостей:

terraci graph --format dot -o deps.dot

init

Инициализация конфигурации:

terraci init

summary

Публикация результатов plan в MR:

terraci summary

policy

Проверка Terraform планов на соответствие OPA политикам:

# Загрузить политики из источников
terraci policy pull

# Проверить все модули
terraci policy check

# Проверить конкретный модуль
terraci policy check --module platform/prod/eu-central-1/vpc

Примеры использования

Базовый workflow

# 1. Инициализация конфигурации
terraci init

# 2. Настройка .terraci.yaml под проект

# 3. Валидация
terraci validate

# 4. Просмотр зависимостей
terraci graph --format levels

# 5. Генерация пайплайна
terraci generate --dry-run
terraci generate -o .gitlab-ci.yml

Работа с изменёнными модулями

# Генерация только для изменённых модулей
terraci generate --changed-only --base-ref main

# Просмотр затронутых модулей
terraci graph --changed-only --format levels

Фильтрация модулей

# Только production
terraci generate --environment prod

# Исключить тестовые модули
terraci generate --exclude "*/test/*"

# Конкретный модуль и зависимые
terraci generate --module platform/prod/eu-central-1/vpc

Docker

# Генерация пайплайна
docker run --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  ghcr.io/edelwud/terraci generate -o .gitlab-ci.yml

# Валидация
docker run --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  ghcr.io/edelwud/terraci validate

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

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

Переменные окружения

Переменная	Описание
TERRACI_CONFIG	Путь к конфигурации (альтернатива --config)
TERRACI_DIR	Рабочая директория (альтернатива --dir)
TERRACI_VERBOSE	Включить verbose-режим (true/false)

Автодополнение

Bash

terraci completion bash > /etc/bash_completion.d/terraci

Zsh

terraci completion zsh > "${fpath[1]}/_terraci"

Fish

terraci completion fish > ~/.config/fish/completions/terraci.fish

Справка

# Общая справка
terraci --help

# Справка по команде
terraci generate --help
terraci graph --help