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 Terraformterraform/mariadb-rds, тип Feature облікових даних — доterraform/generated-secret, а тип Feature резервного копіювання — доterraform/backup-native..aggrega-config.yaml— називає реєстр hub, з якого розв’язуються сутності каталогу.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example terraform-rdsПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd terraform-rdsЗбирання
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: 14Manifest прив’язує цю сутність Feature до terraform/backup-native, який сам нічого не рендерить: резервне копіювання — це налаштування екземпляра, тож Recipe читає приєднання і записує його в ресурс, який і так рендерить. Розділ резервного копіювання aws_db_instance у main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14infra.schedule, наприклад 30 2 * * *, також задав би backup_window екземпляра як 02:30-03:00 (за UTC); якщо його пропустити, як тут, вікно вибирає RDS. Значення, якого RDS не може дотримати, — строк зберігання понад 35 днів чи розклад, відмінний від одного часу щодня, — зупиняє збирання з указанням приєднання.