terraci summary

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

Синтаксис

terraci summary [flags]

Описание

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

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

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

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

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

GitLab CI

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

GitHub Actions

summary:
  runs-on: ubuntu-latest
  needs: [plan-jobs...]
  if: github.event_name == 'pull_request'
  steps:
    - uses: actions/checkout@v4
    - run: terraci summary
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

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

GitLab

Переменная	Описание	Обязательна
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.

GitHub

Переменная	Описание	Обязательна
GITHUB_ACTIONS	Индикатор среды GitHub Actions (устанавливается автоматически)	Да
GITHUB_TOKEN	Токен для публикации комментариев в PR	Да
GITHUB_REPOSITORY	Репозиторий в формате owner/repo (устанавливается автоматически)	Да
GITHUB_EVENT_PATH	Путь к JSON-файлу события (устанавливается автоматически)	Да

Вывод

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

## 🔄 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

plugins:
  gitlab:
    mr:
      comment:
        enabled: true
        on_changes_only: false
        include_details: true

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

GitHub

plugins:
  github:
    pr:
      comment:
        enabled: true
        on_changes_only: false

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

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

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

Примеры

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

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

terraci summary

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

terraci summary -v

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

• Интеграция с GitLab MR
• Конфигурация GitHub Actions
• terraci generate