Terraform RDS (встроенный артефакт HCL)
Одна база данных MariaDB, описанная один раз как намерение разработчика и отрисованная в файл Terraform HCL, который создаёт управляемый экземпляр AWS RDS.
Этот пример демонстрирует форму артефакта провайдера Terraform:
Recipe содержит встроенное тело main.tf в artifacts:, и компилятор
выводит это тело дословно после разрешения его шаблонных выражений. Провайдер
никогда не запускает terraform; он создаёт HCL, который запускает последующий terraform apply.
Файлы
aggregate.yaml— намерение разработчика: один компонентdbтипаcore/datastore/mariadbс логическим именем базы данных. Ничего о облачной цели здесь нет.release.yaml— размеры от оператора: версия движка, хранилище и HA для границыinfra. Его запись дляdbпривязывает обязательный слотroot_passwordсущности Component кcore/generated-secret— сущности Feature для учётных данных, которая указывает, что учётными данными владеет движок (см. ниже), — и подключаетcore/backup, который задаёт, как долго экземпляр хранит свои резервные копии.manifest.yaml— привязывает тип компонента MariaDB к сущности Recipe Terraformterraform/mariadb-rds, тип сущности Feature для учётных данных — кterraform/generated-secret, а тип сущности Feature для резервного копирования — кterraform/backup-native..aggrega-config.yaml— указывает реестр хаба, из которого разрешаются сущности каталога.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example terraform-rdsЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd terraform-rdsСборка
aggrega build --release release.yaml --auto-pull--auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне. Отрисованный main.tf помещается в dist/infra/terraform/modules/db/, а корневая конфигурация границы, aggrega.modules.tf, в dist/infra/terraform/ объявляет db как блок module, указывающий на него. Тело начинается с блока происхождения в комментариях #, идентифицирующего сборку, за ним следуют блок required_providers, ограничивающий версию провайдера AWS, разрешённый ресурс aws_db_instance — значения хранилища и HA подставлены из сущности Release, срок хранения резервных копий задаёт подключение core/backup, а учётные данные управляются RDS через manage_master_user_password, — и выход address с именем хоста экземпляра, который Recipe публикует как host в форме ${module.db.address}.
Этот блок module не содержит аргументов, и причина — в форме этого
примера. Тело написала сущность Recipe, поэтому она подставила значения сущности Release
прямо в ресурс; модуль не объявляет блоков variable, и компилятору
нечего передавать:
module "db" { source = "./modules/db"}Recipe, который вместо этого включает модуль в поставку — пример
terraform-rds-module, — оставляет эти входные данные
необъявленными в теле, и компилятор передаёт их как аргументы этого блока.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочего пространства ещё нет папки `terraform-rds`, вызовите один раз инструмент `scaffold` с `example`, равным `terraform-rds`, и без `dir`: он запишет пример в новую папку `terraform-rds`. Затем вызовите инструмент `build` с `workspace_root`, равным `terraform-rds`, `release`, равным `release.yaml`, `auto_pull`, равным true, и `write`, равным true. Сообщите, какие файлы записала сборка; они находятся в `terraform-rds/dist/`.Слот учётных данных на управляемой цели
core/datastore/mariadb объявляет root_password обязательным слотом: сборка
останавливается, пока его ничто не привязывает. Самостоятельно размещённой MariaDB нужен пароль, привязанный
на этапе описания; управляемому экземпляру RDS — нет: RDS сам генерирует и ротирует
главный пароль, и именно manage_master_user_password в этом Recipe
включает это.
Поэтому оператор привязывает слот в сущности Release, в её записи для db,
к core/generated-secret — сущности Feature для учётных данных, материалом которой владеет движок.
Владеет ли движок учётными данными, определяется сущностью Recipe, которую выбирает
Manifest, поэтому привязка принадлежит оператору, а Aggregate о ней
ничего не говорит:
components: db: features: root_password: type: core/generated-secretПрисоединение ничего не настраивает, потому что описывать нечего, а
FeatureRecipe, который выбирает Manifest (terraform/generated-secret), — это чистая связка,
которая ничего не отрисовывает. Поэтому отрисованный main.tf побайтно совпадает с тем,
каким он был бы вовсе без присоединения: слот привязан, и артефакт для него
не выводится.
Обратите внимание, что ссылка на FeatureRecipe в Manifest уточнена провайдером
(terraform/generated-secret:1.0.0). Голое имя рецепта разрешается, только когда
его содержит ровно один провайдер, а стандартная библиотека поставляет
FeatureRecipe generated-secret более чем в одном, поэтому голое
generated-secret:1.0.0 не разрешается вовсе, и сборка явно останавливается,
а не выбирает провайдер за вас молча.
Резервное копирование на управляемой целевой платформе
RDS сама создаёт резервные копии экземпляра и хранит каждую автоматическую копию 7 дней, если не указано иное. Оператор меняет это, подключая core/backup в сущности Release рядом с учётными данными:
backup: type: core/backup infra: retention_days: 14Manifest привязывает эту сущность Feature к terraform/backup-native, который сам ничего не отрисовывает: резервное копирование — это настройка экземпляра, поэтому Recipe читает подключение и записывает его в ресурс, который и так отрисовывает. Раздел резервного копирования aws_db_instance в main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14infra.schedule, например 30 2 * * *, также задал бы backup_window экземпляра равным 02:30-03:00 (по UTC); если его опустить, как здесь, окно выбирает RDS. Значение, которое RDS не может соблюсти, — срок хранения более 35 дней или расписание, отличное от одного времени каждого дня, — останавливает сборку с указанием подключения.