terraci summary

Публикует результаты terraform plan в виде комментария к GitLab Merge Request.

Синтаксис

terraci summary [flags]

Описание

Команда summary собирает результаты terraform plan из артефактов и создаёт или обновляет комментарий с обзором в merge request GitLab.

Эта команда предназначена для запуска как финальный джоб в GitLab CI пайплайне после завершения всех plan-джобов. Она сканирует файлы plan.txt в директориях модулей и публикует форматированный комментарий в MR.

Команда автоматически определяет, запущена ли она в контексте MR пайплайна, и создаёт комментарии только когда это уместно.

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

Эта команда обычно используется в summary-джобе сгенерированного пайплайна:

terraci-summary:
  stage: summary
  image: ghcr.io/edelwud/terraci:latest
  script:
    - terraci summary
  needs:
    - job: plan-platform-stage-eu-central-1-vpc
      optional: true
  rules:
    - if: $CI_MERGE_REQUEST_IID
      when: always

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

Переменная	Описание	Обязательна
CI_MERGE_REQUEST_IID	Номер MR (определяется GitLab автоматически)	Да
CI_PROJECT_ID	ID проекта (определяется автоматически)	Да
CI_SERVER_URL	URL сервера GitLab (определяется автоматически)	Да
GITLAB_TOKEN	API токен для публикации комментариев	Нет*
CI_JOB_TOKEN	Резервный токен (предоставляется автоматически)	Нет*

*Требуется либо GITLAB_TOKEN, либо CI_JOB_TOKEN.

Вывод

Команда публикует комментарий такого вида в MR:

## 🔄 Terraform Plan Summary

| Модуль | Статус | Сводка |
|--------|--------|--------|
| `platform/stage/eu-central-1/vpc` | ✅ Изменения | Plan: 2 to add, 1 to change, 0 to destroy |
| `platform/stage/eu-central-1/eks` | ➖ Без изменений | Infrastructure is up-to-date |

<details>
<summary>📋 platform/stage/eu-central-1/vpc</summary>

Plan: 2 to add, 1 to change, 0 to destroy.
...

</details>

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

Настройте summary-джоб через .terraci.yaml:

gitlab:
  mr:
    comment:
      enabled: true
      on_changes_only: false
      include_details: true
    summary_job:
      image:
        name: "ghcr.io/edelwud/terraci:latest"
      tags:
        - docker

Полные опции смотрите в Конфигурация GitLab MR.

Коды завершения

Код	Описание
0	Успех (или пропущено, если не в MR)
1	Ошибка сканирования результатов или публикации комментария

Примеры

Ручной запуск (для тестирования)

# Установите необходимые переменные окружения
export CI_MERGE_REQUEST_IID=42
export CI_PROJECT_ID=12345
export GITLAB_TOKEN=your-token

terraci summary

С подробным выводом

terraci summary -v

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

• Интеграция с GitLab MR
• terraci generate