Политики Terraform

Делает политики Terraform Policy для HCP Terraform: пишет .policy.hcl, переводит с Sentinel с оценкой качества перевода и тестирует в .policytest.hcl. Для случаев, когда нужна новая политика, перенос с Sentinel или отладка теста политики.

БезопасностьПак: Скиллы HashiCorpссылкаterraform-policy
Автор
Источник
hashicorp/agent-skills/plugins/terraform/skills/terraform-policy @ 5e30fa5
Лицензия
MPL-2.0

Об этом скилле

Что делает

Скилл пишет, переводит и тестирует файлы Terraform Policy — формата policy-as-code в HCP Terraform: политики .policy.hcl и тесты к ним .policytest.hcl. Сам SKILL.md только распределяет задачи, вся суть — в трёх справочных файлах. references/tfpolicy-author.md превращает правило, сказанное словами, в блоки resource_policy, module_policy или provider_policy: списки разрешённого выносит в блоки input, проверки при обновлении и удалении строит на operations и prior_attrs, связи между ресурсами — на core::getresources(). Там же перевод с Sentinel: таблица соответствия конструкций, список того, что перевести нельзя, и оценка каждого результата (Perfect, Good, Simplify, Not convertible). references/tfpolicy-test.md — про моки, expect_failure и обязательный случай с отсутствующим атрибутом в каждом файле тестов. references/verified-syntax.md — проверенный синтаксис и типичные ошибки. Например, meta.address в политике ресурса не определён, и поймает это только настоящий terraform plan --policies=. В examples/conversion/ лежат 16 политик Sentinel для AWS рядом с переведёнными версиями, к каждой — README о том, что потерялось при переводе.

Сначала агент смотрит версию установленного CLI tfpolicy: советы для 0.3.x, 0.4.x и 0.5.x различаются.

Когда включать и когда не надо

Чтобы написать новую политику, перенести с Sentinel одну политику или целую библиотеку или разобраться, почему тест политики проходит или падает не там, где ждёшь. Нужен CLI tfpolicy, а применяет политики сам HCP Terraform. В verified-syntax.md сказано, что его шаблоны проверяли ещё в закрытой бете, на бета-сборках Terraform и tfpolicy.

Тесты модулей в .tftest.hcl и обычный HCL — не сюда, скилл сам отправляет их к другим скиллам.

Как поставить и вызвать

Этот скилл мы не копируем: его файлы под MPL-2.0, файловой копилефт-лицензией, которой нет в нашем списке. Ставьте его из репозитория HashiCorp — на странице есть кнопка к источнику. Один скилл: npx skills add hashicorp/agent-skills/plugins/terraform/skills/terraform-policy. Весь плагин 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-policy. Команды npx в его разделе Troubleshooting устарели.

  • Claude Code: /terraform-policy или попросить скилл по имени.
  • Codex: $terraform-policy.
  • Cursor: наберите / в чате Agent и выберите terraform-policy.

Пример: /terraform-policy Переведи policies/ebs-encrypted.sentinel в .policy.hcl и напиши .policytest.hcl с проходящими и падающими случаями.

Чем отличается от похожих

Политики как код в каталоге больше никто не пишет. Тесты Terraform проверяют поведение модуля блоками run, а этот скилл проверяет политики на моках ресурсов. Стиль кода Terraform — про обычную конфигурацию. Ревью безопасности прослеживает недоверенный ввод в коде приложения и никаких правил к плану Terraform не применяет.

Установка

Скилл не скопирован в каталог: его лицензия разрешает копию только на тех же условиях, а под такими лицензиями мы в каталог не копируем. Установите его из репозитория автора.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Открыть источник

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы HashiCorp

Стиль кода Terraform

Делает Terraform-код по стайлгайду HashiCorp: стандартные файлы, форматирование, имена, типизированные переменные, for_each вместо count, закреплённые версии, секреты вне state. Для случаев, когда агент пишет или проверяет HCL.

Тесты Terraform

Пишет и запускает встроенные тесты Terraform в файлах .tftest.hcl: блоки run, assert, режимы plan и apply, expect_failures, моки провайдеров, CI. Для случаев, когда модуль нужно покрыть тестами или починить terraform test.

Стеки конфигураций Terraform Stacks

Пишет конфигурации Terraform Stacks для HCP Terraform: компоненты в .tfcomponent.hcl, деплойменты в .tfdeploy.hcl, OIDC-токены, автоподтверждение, связанные Stack'и и мониторинг через API. Для случаев, когда нужно собрать или отладить Stack.

Разбивка Terraform на модули

Выносит ресурсы из монолитной конфигурации Terraform в модуль с типизированным интерфейсом и переносит state через блоки moved или terraform state mv без пересоздания. Для случаев, когда корневая конфигурация разрослась или повторяется.

Поиск и импорт ресурсов в Terraform

Находит существующие облачные ресурсы запросами Terraform Search в .tfquery.hcl, генерирует блоки resource и import, а для неподдерживаемых типов ведёт ручной импорт. Для случаев, когда созданную вручную инфраструктуру надо перевести в Terraform.

Azure Verified Modules в Terraform

Делает проверку Terraform-модуля для Azure по 37 требованиям Azure Verified Modules: провайдеры, источники, имена, переменные, выходы, ломающие изменения. Для случаев, когда модуль пишут или ревьюят под сертификацию AVM.

Ресурсы провайдера Terraform

Делает ресурсы и источники данных провайдера Terraform на Plugin Framework: схема, CRUD, обработка «не найдено», импорт, ожидание асинхронных API, минимальные тесты. Для случаев, когда ресурс добавляют, меняют или проверяют перед PR.

Тесты провайдера Terraform

Делает приёмочные тесты провайдера Terraform на terraform-plugin-testing: шаги, проверки состояния и плана, импорт, исчезновение ресурса, регрессии, свиперы, эфемерные ресурсы. Для случаев, когда такие тесты пишут, ревьюят или отлаживают.

Образы AWS AMI в Packer

Делает образы AMI для EC2 в Packer через билдер amazon-ebs: готовый шаблон HCL, фильтры исходного образа, копии в другие регионы, учётные данные, частые ошибки сборки. Для случаев, когда нужен свой AMI.