Импорт проекта 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