Тесты провайдера Terraform
Делает приёмочные тесты провайдера Terraform на terraform-plugin-testing: шаги, проверки состояния и плана, импорт, исчезновение ресурса, регрессии, свиперы, эфемерные ресурсы. Для случаев, когда такие тесты пишут, ревьюят или отлаживают.
provider-test-patterns- Автор
- HashiCorp
- Источник
- hashicorp/agent-skills/plugins/terraform/skills/provider-test-patterns @ 5e30fa5
- Лицензия
- MPL-2.0
Об этом скилле
Что делает
Скилл — справочник по приёмочным тестам провайдеров на Plugin Framework с библиотекой terraform-plugin-testing. Он начинает с жизненного цикла теста: каждый шаг проходит plan, apply, refresh и финальный plan; непустой финальный план валит тест, если не стоит ExpectNonEmptyPlan; в конце идут destroy и CheckDestroy. Так дрейф ловится без лишних проверок. Таблицы перечисляют поля TestCase и TestStep для режима конфигурации и режима импорта. Скилл предпочитает ConfigStateChecks старым функциям Check и не разрешает смешивать их в одном шаге. Сценарии: базовый тест вместе с обновлением, импорт с ImportStateKind, шаг с исчезнувшим ресурсом, ExpectError для валидации и регрессионный тест, который коммитят раньше исправления, чтобы ревьюер увидел, как он падает. Готовые вспомогательные функции: свои типы statecheck.StateCheck для проверок «существует» и «исчез», проверка удаления и PreCheck.
references/checks.md — типы knownvalue, tfjsonpath, CompareValue между шагами и проверки плана на каждой фазе. references/sweepers.md — как зарегистрировать свиперы, которые подчищают инфраструктуру, оставшуюся после упавших тестов, с зависимостями и запуском TF_ACC=1 go test ... -sweep=<region>. references/ephemeral.md — тесты эфемерных ресурсов: нужен Terraform 1.10 или новее, данные перехватываются пакетом echoprovider.
Когда включать и когда не надо
Когда пишете, ревьюите или отлаживаете приёмочные тесты провайдера, переводите старые проверки Check на ConfigStateChecks или заводите свиперы. Приёмочные тесты ходят в настоящий API, поэтому без его учётных данных не обойтись.
Для тестов модулей Terraform в .tftest.hcl он не подходит, а запуск набора тестов и разбор падений HashiCorp вынесла в отдельный скилл run-acceptance-tests.
Как поставить и вызвать
Этот скилл мы не копируем: его файлы под MPL-2.0, файловой копилефт-лицензией, которой нет в нашем списке. Ставьте его из репозитория HashiCorp — на странице есть кнопка к источнику. Один скилл: npx skills add hashicorp/agent-skills/plugins/terraform/skills/provider-test-patterns. Весь плагин 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:provider-test-patterns.
- Claude Code:
/provider-test-patternsили попросить скилл по имени. - Codex:
$provider-test-patterns. - Cursor: наберите
/в чате Agent и выберитеprovider-test-patterns.
Пример: /provider-test-patterns Перепиши блоки Check в widget_resource_test.go на ConfigStateChecks и добавь тест на исчезновение ресурса.
Чем отличается от похожих
Ресурсы провайдера Terraform пишет сам ресурс и называет минимальный набор тестов, а за подробностями отсылает сюда. Тесты Terraform проверяют конфигурацию на HCL блоками run и мок-провайдерами, а не код провайдера на Go. Написание юнит-тестов и Контрактные тесты API — общие скиллы о тестах, про terraform-plugin-testing в них ничего нет.
Установка
Скилл не скопирован в каталог: его лицензия разрешает копию только на тех же условиях, а под такими лицензиями мы в каталог не копируем. Установите его из репозитория автора.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel