Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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 Terraform terraform/mariadb-rds, тип сущности Feature для учётных данных — к terraform/generated-secret, а тип сущности Feature для резервного копирования — к terraform/backup-native.
  • .aggrega-config.yaml — указывает реестр хаба, из которого разрешаются сущности каталога.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example terraform-rds

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd terraform-rds

Сборка

Terminal window
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: 14

Manifest привязывает эту сущность Feature к terraform/backup-native, который сам ничего не отрисовывает: резервное копирование — это настройка экземпляра, поэтому Recipe читает подключение и записывает его в ресурс, который и так отрисовывает. Раздел резервного копирования aws_db_instance в main.tf:

## ── Backup ───────────────────────────────────────────────
backup_retention_period = 14

infra.schedule, например 30 2 * * *, также задал бы backup_window экземпляра равным 02:30-03:00 (по UTC); если его опустить, как здесь, окно выбирает RDS. Значение, которое RDS не может соблюсти, — срок хранения более 35 дней или расписание, отличное от одного времени каждого дня, — останавливает сборку с указанием подключения.