Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

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

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

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 під час збирання записує 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/`.