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

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 Terraform terraform/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 у нескольких — поэтому голое имя не разрешается вовсе, и сборка останавливается с явной ошибкой, а не молча выбирает провайдера за вас.

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

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

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

Terminal window
aggrega scaffold --example terraform-rds-module

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

Terminal window
cd terraform-rds-module

Сборка

Terminal window
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/`.