Імпорт проєкту Compose — API нотаток із PostgreSQL і Redis
Файл Compose, що запускає API, базу даних PostgreSQL, у якій він зберігає нотатки, і кеш Redis, перетворений командою aggrega import на чернетки файлів Aggrega — з перенесенням з’єднань, налаштувань бази даних, пароля як посилання на змінну та тегу кожного образу — і зібраний для Docker Compose.
Імпорт проєкту Compose покроково описує цей процес: команду, файли, які вона записує, і навіщо в них кожен рядок, збірку та запущений стек. У цій теці зберігається кожен етап цього покрокового опису:
| тека або файл | що містить |
|---|---|
source/ | проєкт Compose compose.yaml, файл .aggrega-config.yaml, який робить теку робочим простором, і import-answers.yaml — єдине значення, потрібне збірці для Kubernetes, якого не містить жоден файл Compose |
draft/ | файли, які записала команда aggrega import compose.yaml --target compose, без змін, включно з release.lock, і те, що вона вивела: stdout.txt — стандартний вивід, import.txt — стандартний потік помилок |
У клоні репозиторію документації check.sh знову запускає імпорт, порівнює те, що він записує й виводить, із draft/, порівнює блоки, які цитує покроковий опис, із цими файлами, а також перевіряє та збирає те, що записав імпорт. Для цього каталог стандартної бібліотеки (де його взяти) має бути розгорнутий поруч із цим репозиторієм або його директорію має бути вказано в AGGREGA_CATALOG_DIRS.
Створення прикладу
Імпорт цього прикладу можна запустити командами нижче або доручити його запуск своєму ШІ-асистентові.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example import-composeПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd import-composeЗбирання
Імпорт створює чернетки файлів Aggrega поруч із проєктом, у source/. Він зіставляє проєкт із каталогом стандартної бібліотеки, який типовий реєстр робочого простору публікує як підписаний знімок: перший імпорт завантажує його, перевіряє, зберігає в кеші вмісту робочого простору та вказує його за дайджестом у записі, який створює поруч із чернетками. Робочий простір, що вказує власні теки каталогу — в AGGREGA_CATALOG_DIRS або в workspace.catalog_dirs, — натомість імпортує відносно них. Потім імпорт завантажує те, від чого залежить чернетка сутності Release, тож збірка може відбутися одразу:
cd sourceaggrega import compose.yaml --target composeaggrega build --release release.yamlЗбірка записує dist/compose/docker-compose.yaml; його запуск описано в покроковому описі за посиланням вище.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної папки самостійно. Якщо в папці робочої області ще немає папки `import-compose`, один раз викличте інструмент `scaffold` зі значенням `example`, встановленим у `import-compose`, і без `dir`: він записує приклад у нову папку `import-compose`, папка `source` якої містить те, що імпортує цей приклад. Потім викличте інструмент `import` із `workspace_root`, встановленим у `import-compose/source`, `source`, встановленим у `compose.yaml`, і `target`, встановленим у `compose`: він читає потрібні відповіді з `import-answers.yaml` поруч із `compose.yaml`, записує свої чернетки в `import-compose/source` і завантажує те, що їм потрібно. Потім викличте інструмент `validate` із `workspace_root`, встановленим у `import-compose/source`, і `release`, встановленим у `release.yaml`, та інструмент `build` із `workspace_root`, встановленим у `import-compose/source`, `release`, встановленим у `release.yaml`, і `write`, встановленим у true. Скажіть мені, які файли записала збірка; вони розташовані в `import-compose/source/dist/`.Тестування
Коли стек запущено так, як його запускає покроковий посібник, а для API вказано образ, що відповідає на HTTP на порту 8080, надішліть запит до API на порт, який публікує сутність Release:
curl -sS http://127.0.0.1:8080/notesЗамінна програма посібника відповідає описом отриманого запиту:
{ "path": "/notes", "headers": { "host": "127.0.0.1:8080", [… omitted: the user agent and the media types the client sent] }, "method": "GET", [… omitted: the rest of the request as the stand-in received it, the client's address and the container's host name]}Після імпорту з --target helm і застосування до Kubernetes, як показує покроковий посібник, API відповідає на той самий запит за тією самою адресою, щойно локальний порт перенаправлено на його Service; там він ще не отримує пароль своєї бази даних, оскільки Secret досягає лише бази даних:
kubectl port-forward -n <namespace> svc/api-default 8080:8080