Разработка провайдеров
Тема дорожной карты · Terraform
Разработка кастомных провайдеров для Terraform — это процесс создания плагина на языке Go, который позволяет интегрировать любые API или сервисы в управление инфраструктурой с помощью инструментов IaC. Это особенно важно, когда стандартные провайдеры Terraform не покрывают все необходимые ресурсы или источники данных для конкретной задачи. Кастомные провайдеры позволяют расширить возможности Terraform, обеспечивая полное управление жизненным циклом инфраструктуры для внутренних платформ или сторонних сервисов.
Разработка провайдеров включает создание плагина, который реализует CRUD-операции (создание, чтение, обновление, удаление) для ресурсов и источников данных. Эти операции вызываются Terraform во время выполнения команд terraform apply, terraform plan и terraform destroy. Провайдеры создаются с использованием terraform-plugin-framework (или устаревшего terraform-plugin-sdk/v2) и распространяются через Terraform Registry или приватные реестры. Обычно это включает в себя создание входной точки provider.go, отдельных файлов resource_*.go для каждого ресурса и приёмочных тестов, написанных с использованием resource.Test.
Как это работает
Разработка провайдеров включает написание своего Terraform-провайдера на Go с использованием terraform-plugin-framework (современного, введённого в 2022 году) или устаревшего terraform-plugin-sdk/v2. Провайдер реализует Schema, Configure и CRUD-методы (Create, Read, Update, Delete) для каждого ресурса. Затем провайдер публикуется в Terraform Registry (публично) или хостится приватно. Тестируется провайдер с помощью acceptance-тестов против реального или mock-API.
Когда применять
Создание кастомного провайдера рекомендуется только в случае, если у целевой системы нет существующего Terraform-провайдера и поддержка инфраструктуры через Terraform действительно лучше другого инструмента (например, Helm chart, кастомного CLI или Pulumi). Для внутренних микросервисов часто проще использовать конфигурацию через Helm/Kustomize, чем создавать кастомный провайдер. Важно помнить, что кастомный провайдер — это реальный софт, требующий поддержки и обновлений.
Типичные ошибки
Типичные ошибки при разработке провайдеров включают попытки создания провайдера, когда достаточно было бы использовать Kubernetes-оператор или простой CLI. Другой распространённой ошибкой является некорректное обработание метода Read, что может привести к проблемам с обнаружением дрейфа (drift-detection). Также часто пропускается версионирование, что может привести к тому, что каждый релиз провайдера будет пересборкой latest версии. Наконец, пропуск acceptance-тестов может привести к тому, что тонкие баги будут появляться у пользователей провайдера.