Terraform RDS (вендорований модуль)
Той самий намір щодо MariaDB, що й у прикладі terraform-rds, відтворений через
підключену з джерела форму Terraform provider: замість вбудованого тіла 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 provider,
щоб дізнатися, що робить рушій, якщо ви спробуєте.
Файли
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 до Terraform Recipeterraform/mariadb-rds-module, який бере свій модуль локально, тип Feature для облікових даних — доterraform/generated-secret, а тип Feature резервного копіювання — доterraform/backup-native, який нічого не рендерить: Recipe читає приєднання і сам надає вхідні параметри резервного копіювання модуля..aggrega-config.yaml— називає реєстр hub, з якого розв’язуються сутності каталогу.
Слот облікових даних на керованій цілі
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 під час збирання записує lockfile, якого бракує свіжому клону.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами 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/`.