Перейти до вмісту
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 — називає реєстр hub, з якого розв’язуються сутності каталогу.

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

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

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

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 днів чи розклад, відмінний від одного часу щодня, — зупиняє збирання з указанням приєднання.