Terraform RDS (вендорный модуль)
То же намерение MariaDB, что и в примере terraform-rds, отрисованное через
внешнюю форму провайдера Terraform: вместо встроенного тела HCL
Recipe указывает на локальный модуль Terraform, а компилятор копирует его дословно,
а затем передаёт ему входные переменные из опор разработчика и оператора.
Что выдаёт компилятор
В dist/infra/terraform/ сборка создаёт корневую конфигурацию границы,
а в dist/infra/terraform/modules/db/ — собственные файлы компонента db:
aggrega.modules.tfв корне границы — корневая конфигурация, объявляющаяdbкак блокmodule, у которогоsourceравен./modules/db, а аргументы являются входными переменными модуля, в детерминированном порядке ключей. Такой файл получает каждая граница terraform, и именно он объединяет компоненты границы в одну конфигурацию Terraform;- файлы модуля, скопированные байт в байт (
variables.tf,main.tf, включая любую интерполяцию${...}, написанную автором модуля); aggrega.provenance.tfрядом с этими файлами — файл с комментариями#, идентифицирующий сборку.
Блок db, который выдаёт этот пример:
module "db" { source = "./modules/db"
allocated_storage = 100 backup_retention_period = 14 db_name = "appdb" engine_version = "11.4" instance_class = "db.t3.small" multi_az = true port = 3306 skip_final_snapshot = false storage_type = "gp3" subnet_id = "production-private-db-subnets"}Два из этих аргументов стоит проследить до места, где они были заданы.
subnet_id — имя группы подсетей БД, которое Release передаёт в
infra.overrides: группа управляется вне этого развёртывания, её имя
различается в разных окружениях, а собственное объявление модуля не содержит значения по умолчанию, поэтому
Recipe требует его, и при его отсутствии сборка останавливается с явной ошибкой, а не
планирует развёртывание в неправильной сети. instance_class берётся из той же опоры,
но имеет значение по умолчанию в Recipe, поэтому сущность Release, ничего не указавшая, получает
db.t3.small.
Что бы Recipe ни отображал в эти аргументы, компилятор передаёт это
без изменений и никогда не разрешает — включая указатель Terraform ${...}. От
позиции зависит лишь то, куда попадает этот указатель: аргумент модуля — одна
из позиций, которые вычисляет Terraform, поэтому указатель, записанный там, разрешается относительно
корневой конфигурации во время планирования, а не попадает в модуль как литеральная
строка. Он по-прежнему должен ссылаться на то, что объявлено в этой конфигурации.
Поскольку входные данные заданы в корне, modules/db/ сам по себе не является
конфигурацией, которую можно спланировать в развёрнутом виде — о том, что делает движок при такой попытке, см.
страницу провайдера Terraform.
Файлы
aggregate.yaml— намерение разработчика: один компонентdbтипаcore/datastore/mariadb.release.yaml— параметры размера от оператора для границыinfra. Его запись дляdbсвязывает обязательный слотroot_passwordсущности Component сcore/generated-secret(см. ниже) и подключаетcore/backup, чтобы каждая автоматическая резервная копия экземпляра хранилась 14 дней, — этоbackup_retention_periodвыше; без подключения экземпляр хранит их 7 дней.manifest.yaml— связывает тип компонента MariaDB с Recipe Terraformterraform/mariadb-rds-module, который получает свой модуль локально, тип Feature для учётных данных — сterraform/generated-secret, а тип Feature для резервного копирования — сterraform/backup-native, который ничего не отрисовывает: Recipe читает подключение и сам задаёт входные параметры резервного копирования модуля..aggrega-config.yaml— указывает реестр хаба, из которого разрешаются сущности каталога.
Слот учётных данных на управляемой цели
core/datastore/mariadb объявляет root_password обязательным слотом: сборка
останавливается, пока ничто его не связывает. RDS сам генерирует и ротирует мастер-пароль,
а вендорный модуль, который копирует этот Recipe, устанавливает
manage_master_user_password, чтобы включить это, — поэтому слот делегируется
движку, а не заполняется заданным значением.
Владеет ли движок учётными данными, определяется тем, какой Recipe выбирает Manifest,
поэтому оператор связывает слот в Release, в его записи для db.
Он связывает его с core/generated-secret, который ничего не настраивает, поскольку
задавать нечего, и чей FeatureRecipe
(terraform/generated-secret) — чистая связка, которая ничего не отрисовывает. Вендорный
модуль и корневая конфигурация получаются байт в байт такими же, как
без какого-либо прикрепления. Ссылка в Manifest уточнена провайдером, потому что
голое имя рецепта разрешается, только когда его содержит ровно один провайдер, а
стандартная библиотека поставляет FeatureRecipe generated-secret у нескольких —
поэтому голое имя не разрешается вовсе, и сборка останавливается с явной ошибкой, а не
молча выбирает провайдера за вас.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example terraform-rds-moduleЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd terraform-rds-moduleСборка
aggrega build --release release.yaml --auto-pull--auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если папка рабочей области ещё не содержит папку `terraform-rds-module`, вызовите один раз инструмент `scaffold` с параметром `example` со значением `terraform-rds-module` и без `dir`: он запишет пример в новую папку `terraform-rds-module`. Затем вызовите инструмент `build` с параметрами `workspace_root` — `terraform-rds-module`, `release` — `release.yaml`, `auto_pull` — true и `write` — true. Сообщите мне, какие файлы записала сборка; они находятся в `terraform-rds-module/dist/`.