Поддержка OpenTofu

TerraCi полноценно поддерживает OpenTofu, open-source форк Terraform.

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

Переключитесь на OpenTofu, задав бинарник в верхнеуровневой секции execution::

execution:
  binary: tofu

extensions:
  # Для GitLab CI
  gitlab:
    image: "ghcr.io/opentofu/opentofu:1.6"

  # Для GitHub Actions (бинарник на стороне провайдера не задаётся; образ задают шаги воркфлоу)
  github:
    runs_on: ubuntu-latest

Как это работает

При установке execution.binary: tofu, TerraCi:

1. Записывает tofu в Terraform operation внутри pipeline IR
2. Использует tofu во всех генерируемых скриптах
3. Выбирает OpenTofu image по умолчанию для GitLab, если custom image не настроен

Сгенерированный пайплайн

default:
  image: ghcr.io/opentofu/opentofu:1.6
  before_script:
    - tofu init

plan-platform-prod-vpc:
  script:
    - cd platform/prod/us-east-1/vpc
    - tofu plan -out=plan.tfplan
  # ...

apply-platform-prod-vpc:
  script:
    - cd platform/prod/us-east-1/vpc
    - tofu apply plan.tfplan
  # ...

Официальные образы OpenTofu

Используйте официальные Docker-образы OpenTofu:

Образ	Описание
ghcr.io/opentofu/opentofu:latest	Последняя стабильная
ghcr.io/opentofu/opentofu:1.6	Версия 1.6.x
ghcr.io/opentofu/opentofu:1.6.0	Конкретная версия

Смешанные окружения

Если у вас есть модули и на Terraform, и на OpenTofu, можно переопределять настройки на уровне отдельных джобов:

# В вашем шаблоне пайплайна
.tofu-job:
  image: ghcr.io/opentofu/opentofu:1.6

.terraform-job:
  image: hashicorp/terraform:1.6

Затем расширяйте сгенерированные джобы по необходимости.

Совместимость состояний

OpenTofu совместим с файлами состояния Terraform. Можно:

1. Сохранить существующие state-файлы Terraform
2. Мигрировать на OpenTofu без изменения state
3. Использовать те же S3/GCS бэкенды

Разрешение зависимостей TerraCi работает идентично для обоих инструментов.

Руководство по миграции

С Terraform на OpenTofu

1. Обновите .terraci.yaml:

   execution:
     binary: tofu
   
   extensions:
     # GitLab CI
     gitlab:
       image: "ghcr.io/opentofu/opentofu:1.6"
   
     # GitHub Actions
     github:
       runs_on: ubuntu-latest

2. Перегенерируйте пайплайны:

   terraci generate -o .gitlab-ci.yml

3. Протестируйте с dry-run:

   terraci generate --dry-run

4. Закоммитьте и запушьте

Постепенная миграция

Мигрируйте модуль за модулем, используя переопределение джобов:

# Переопределение конкретных джобов для OpenTofu
apply-platform-prod-vpc:
  extends: .tofu-job

Совместимость версий

TerraCi работает с:

Инструмент	Поддерживаемые версии
Terraform	0.12+
OpenTofu	1.0+

Парсинг HCL совместим с обоими инструментами.

Выбор бинарника

execution.binary принимает каноничные runtime-значения terraform и tofu. TerraCi записывает выбранный бинарник в Terraform jobs внутри IR, а providers/local execution рендерят команды напрямую из operation:

execution:
  binary: tofu

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

Переменные окружения для OpenTofu добавляйте через execution.env. Они применяются только к Terraform plan/apply jobs, а не к provider workflow globals или standalone plugin command jobs:

execution:
  binary: tofu
  env:
    TF_CLI_CONFIG_FILE: "/etc/tofu/config.tfrc"
    TOFU_LOG: "INFO"

extensions:
  # GitLab
  gitlab:
    variables:
      TF_CLI_CONFIG_FILE: "/etc/tofu/config.tfrc"

  # GitHub Actions
  github:
    env:
      TF_CLI_CONFIG_FILE: "/etc/tofu/config.tfrc"

Следующие шаги

• Быстрый старт — установка TerraCi и настройка первого проекта
• Настройка GitLab CI — полный справочник опций пайплайна GitLab