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

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

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

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

Что делает

Скилл переводит под управление Terraform облачные ресурсы, созданные вручную. Основной путь — Terraform Search: нужен Terraform 1.14 или новее и провайдер, в котором реализованы list-ресурсы. Агент пишет файлы .tfquery.hcl с блоками list: ссылка на провайдер, config со специфичными для провайдера фильтрами вроде tag:Environment или instance-state-name, limit и при необходимости for_each по регионам или переменные. terraform query выводит найденное, а terraform query -generate-config-out=<файл> пишет на каждую находку блок resource и блок import, который опирается на identity ресурса. Потом агент чистит сгенерированный код: убирает вычисляемые атрибуты вроде arn и id, заменяет зашитые значения переменными, переименовывает метки вида all_0 и раскладывает результат по файлам. Импорт выполняют terraform plan и terraform apply, а проверяют — terraform state list и terraform show -json, не выводя сам state: секреты в нём лежат открытым текстом.

Сначала скилл требует проверить поддержку. scripts/list_resources.sh [провайдер] читает terraform providers schema -json и печатает, какие list-ресурсы есть у каждого провайдера; ему нужны terraform и jq, а если нет папки .terraform, он молча запускает terraform init -upgrade. Когда тип ресурса не поддерживается или Terraform старше 1.14, в дело вступает references/MANUAL-IMPORT.md: найти ресурсы через CLI самого облака (примеры AWS CLI для RDS, DynamoDB, API Gateway и SNS), написать блоки resource и import вручную, сделать plan и apply. Там же есть bash-скрипт, который пишет блоки импорта для всех таблиц DynamoDB.

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

Чтобы забрать в код инфраструктуру, накликанную в консоли, посмотреть, что на самом деле есть в аккаунте, или перевести ручное создание ресурсов на код.

С ресурсами, которые уже есть в state, он не поможет — импорт на них падает. Новую инфраструктуру он тоже не строит.

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

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

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

Пример: /terraform-search-import Найди запущенные инстансы EC2 с тегом Owner=platform в us-west-2 и eu-west-1 и сгенерируй для них конфигурацию импорта.

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

Других скиллов, которые переводят уже созданные ресурсы под управление IaC, в каталоге нет. CLI cf для API Cloudflare умеет находить и перечислять существующие ресурсы из терминала, но только в Cloudflare и без импорта в Terraform. Внутри пака Стиль кода Terraform — ориентир для очищенного сгенерированного кода, а Разбивка Terraform на модули — следующий шаг, когда импортированные ресурсы нужно перенести в модуль с блоками moved.

Установка

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

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

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

Подключить через 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 Policy для HCP Terraform: пишет .policy.hcl, переводит с Sentinel с оценкой качества перевода и тестирует в .policytest.hcl. Для случаев, когда нужна новая политика, перенос с Sentinel или отладка теста политики.

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.