Стеки конфигураций Terraform Stacks
Пишет конфигурации Terraform Stacks для HCP Terraform: компоненты в .tfcomponent.hcl, деплойменты в .tfdeploy.hcl, OIDC-токены, автоподтверждение, связанные Stack'и и мониторинг через API. Для случаев, когда нужно собрать или отладить Stack.
terraform-stacks- Автор
- HashiCorp
- Источник
- hashicorp/agent-skills/plugins/terraform/skills/terraform-stacks @ 5e30fa5
- Лицензия
- MPL-2.0
Об этом скилле
Что делает
Скилл объясняет язык Terraform Stacks — слой конфигурации над модулями, который исполняет HCP Terraform. Стек состоит из компонентов (каждый оборачивает модуль из локальной папки, реестра или git) и развёртываний — блоков deployment (свой набор входных значений на окружение, регион или аккаунт, от 1 до 20 на стек). Скилл прямо перечисляет отличия от обычного Terraform. Файлы .tfcomponent.hcl и .tfdeploy.hcl лежат в корне репозитория; переменным нужен type, а validation у них нет. У провайдера алиас пишется в заголовке блока, настройки — в блоке config, и есть for_each. Выходным значениям (output) тоже нужен type, а модули, которые используются как компоненты, не должны содержать блоков провайдеров.
Для развёртываний — identity_token для OIDC (основным способом аутентификации скилл считает workload identity), store "varset" для наборов переменных HCP, правила deployment_group и deployment_auto_approve (тариф Premium; orchestrate устарел), publish_output и upstream_input для связи между стеками. CLI нужен Terraform 1.13 и новее, версия фиксируется в файле .terraform-version: terraform stacks init, validate, fmt, затем configuration upload — он и запускает развёртывания, команд plan и apply нет. Чтобы удалить развёртывание, ставят destroy = true, загружают конфигурацию и подтверждают запуск.
В references/ шесть файлов. component-blocks.md и deployment-blocks.md перечисляют все блоки и аргументы, linked-stacks.md — про связанные стеки, в examples.md — готовые стеки для нескольких регионов, нескольких облаков и связанных конфигураций, troubleshooting.md — частые ошибки. api-monitoring.md опрашивает API HCP Terraform через curl и jq, потому что watch-команды CLI не завершаются и вешают автоматизацию. Для этого нужен API-токен HCP Terraform из ~/.terraform.d/credentials.tfrc.json или переменной окружения.
Когда включать и когда не надо
Чтобы написать или поправить конфигурацию стека, развернуть модули в нескольких окружениях и регионах или следить за развёртываниями.
Без HCP Terraform запускать это негде, а для обычного корневого модуля подойдёт скилл о стиле кода.
Как поставить и вызвать
Этот скилл мы не копируем: его файлы под MPL-2.0, файловой копилефт-лицензией, которой нет среди тех, под которыми мы копируем. Ставьте его из репозитория HashiCorp по кнопке к исходнику: один скилл — npx skills add hashicorp/agent-skills/plugins/terraform/skills/terraform-stacks, или весь плагин terraform — в Claude Code claude plugin marketplace add hashicorp/agent-skills и claude plugin install terraform@hashicorp. В Codex: codex plugin marketplace add hashicorp/agent-skills, затем поставьте terraform через /plugins и начните новую сессию. В Claude Code скилл из плагина может появиться как /terraform:terraform-stacks.
- Claude Code:
/terraform-stacksили попросить скилл по имени. - Codex:
$terraform-stacks. - Cursor: наберите
/в чате Agent и выберитеterraform-stacks.
Пример: /terraform-stacks Собери из modules/vpc и modules/app стек с развёртываниями dev и prod в двух регионах AWS, аутентификация через OIDC.
Чем отличается от похожих
Вне этого пака про Stacks ничего нет. Стиль кода Terraform задаёт правила для обычного HCL, и не все они переносятся: у переменных стека нет валидации, провайдеры описываются иначе. Разбивка Terraform на модули даёт те модули, которые потом оборачивают компоненты стека.
Установка
Скилл не скопирован в каталог: его лицензия разрешает копию только на тех же условиях, а под такими лицензиями мы в каталог не копируем. Установите его из репозитория автора.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel