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

Імпорт проєкту 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.

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

Імпорт цього прикладу можна запустити командами нижче або доручити його запуск своєму ШІ-асистентові.

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

Terminal window
aggrega scaffold --example import-compose

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd import-compose

Збирання

Імпорт створює чернетки файлів Aggrega поруч із проєктом, у source/. Він зіставляє проєкт із каталогом стандартної бібліотеки, який типовий реєстр робочого простору публікує як підписаний знімок: перший імпорт завантажує його, перевіряє, зберігає в кеші вмісту робочого простору та вказує його за дайджестом у записі, який створює поруч із чернетками. Робочий простір, що вказує власні теки каталогу — в AGGREGA_CATALOG_DIRS або в workspace.catalog_dirs, — натомість імпортує відносно них. Потім імпорт завантажує те, від чого залежить чернетка сутності Release, тож збірка може відбутися одразу:

Terminal window
cd source
aggrega import compose.yaml --target compose
aggrega 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:

Terminal window
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 досягає лише бази даних:

Terminal window
kubectl port-forward -n <namespace> svc/api-default 8080:8080