Тесты Terraform
Пишет и запускает встроенные тесты Terraform в файлах .tftest.hcl: блоки run, assert, режимы plan и apply, expect_failures, моки провайдеров, CI. Для случаев, когда модуль нужно покрыть тестами или починить terraform test.
terraform-test- Автор
- HashiCorp
- Источник
- hashicorp/agent-skills/plugins/terraform/skills/terraform-test @ 5e30fa5
- Лицензия
- MPL-2.0
Об этом скилле
Что делает
Скилл объясняет агенту встроенный фреймворк тестов Terraform: файлы .tftest.hcl из блоков run с условиями assert. Разбирает устройство файла: блок test для параллельного запуска, variables на уровне файла, которые перекрывают любые другие источники, и блоки провайдеров. Отдельно — аргументы одного прогона: command = plan или apply, module для проверки (локальный или из реестра, но не git и не HTTP), state_key для общего state, plan_options для refresh-only и точечных планов, expect_failures для негативных тестов правил validation. Есть готовые шаблоны для выходных значений, условных ресурсов, количества, тегов, цепочек прогонов через run.<имя>.<output> и провайдеров с алиасами.
Что скилл ставит по умолчанию: режим plan, если реальные ресурсы не нужны; имена *_unit_test.tftest.hcl для plan-тестов и *_integration_test.tftest.hcl для apply-тестов, чтобы CI разделял их через -filter. Ресурсы из apply-прогонов удаляются в обратном порядке, если не указан -no-cleanup.
Три справочных файла агент читает по мере надобности. references/MOCK_PROVIDERS.md — mock_provider с заготовками mock_resource и mock_data (Terraform 1.7 и новее) и случаи, где моки не подходят. references/CI_CD.md — пайплайны GitHub Actions и GitLab CI: юнит-тесты на каждом PR без доступа к облаку, интеграционные — при слиянии в main с облачными секретами. references/EXAMPLES.md — полный набор юнит-, интеграционных и мок-тестов для модуля VPC.
Когда включать и когда не надо
Чтобы покрыть модуль тестами, доказать, что блок validation отбивает плохой ввод, встроить terraform test в CI или починить сломанный тестовый файл.
Тесты в режиме apply создают настоящую инфраструктуру и требуют облачных ключей. Приёмочные тесты провайдера на Go и файлы .policytest.hcl — задача других скиллов.
Как поставить и вызвать
Этот скилл мы не копируем: его файлы под MPL-2.0, файловой копилефт-лицензией, которой нет среди тех, под которыми мы копируем. Ставьте его из репозитория HashiCorp по кнопке к исходнику: один скилл — npx skills add hashicorp/agent-skills/plugins/terraform/skills/terraform-test, или весь плагин 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-test.
- Claude Code:
/terraform-testили попросить скилл по имени. - Codex:
$terraform-test. - Cursor: наберите
/в чате Agent и выберитеterraform-test.
Пример: /terraform-test Добавь plan-тесты для modules/vpc: CIDR по умолчанию, отсутствие NAT gateway, когда он выключен, и отказ на неверном environment.
Чем отличается от похожих
Написание юнит-тестов — общий метод: найти публичное поведение, перечислить граничные случаи, убедиться, что тест умеет падать. Он работает с языком и фреймворком проекта и про HCL ничего не знает. Тесты провайдера Terraform — для авторов провайдеров, которые пишут приёмочные тесты на Go с terraform-plugin-testing. Политики Terraform занимается .policytest.hcl и отправляет работу с .tftest.hcl сюда; так же поступает Разбивка Terraform на модули, когда новый модуль нужно покрыть тестами.
Установка
Скилл не скопирован в каталог: его лицензия разрешает копию только на тех же условиях, а под такими лицензиями мы в каталог не копируем. Установите его из репозитория автора.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel