Импорт из библиотеки Workload — общее тело Workload через `$import`
Один веб-сервис без состояния, чья сущность Recipe синтезирует свой Kubernetes Workload
из общей записи библиотеки, а не из встроенного тела. Это третий
режим написания spec.workload в сущности Recipe:
- Режим 1 (встроенный): Workload на Go-шаблоне, написанный прямо в Recipe.
- Режим 2 (импорт файла):
$import: ./relative/path.yaml— локальный файл. - Режим 3 (импорт из библиотеки):
$import: <Library>#/workloads/<Entry>— записьWorkloadLibrary, на которую ссылаются по идентичности голого имени.
Сущность Recipe web-service здесь использует режим 3:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessServiceЗаписывайте ссылку как один неразрывный токен: без пробелов и переносов строки
в любом её месте, от имени библиотеки до фрагмента. Ссылка, содержащая пробельные символы,
отклоняется, а не обрезается, и сборка останавливается — см.
errors/fatal-halts.md «A reference to a library
entry carries whitespace (Ссылка на запись библиотеки содержит пробельные символы)».
BaseWorkloads — это WorkloadLibrary, опубликованная в каталоге hub
(workloadlibrary/base-workloads). Её запись StatelessService — Go-шаблон,
вычисляемый в контексте рендеринга этой сущности Recipe, поэтому .values.image (из
Component/Aggregate) и .infra.* (реплики, порт, вычислительные ресурсы — из Release)
попадают в него точно так же, как во встроенное тело. Вынесение Workload в
библиотеку никак не меняет то, что развёртывается: результат рендеринга побайтово идентичен
эквивалентному встроенному Workload.
Версия библиотеки задаётся lock-файлом каждой сущности Release — хост реестра
в ссылке не указывается. При aggrega pull версия BaseWorkloads фиксируется в
разделе workload_libraries lock-файла; при aggrega build зафиксированная библиотека
разрешается, и её запись рендерится.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example workload-library-importЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd workload-library-importСборка
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlКаталог разрешается из реестра hub, указанного в .aggrega-config.yaml (он предоставляет BaseWorkloads и provider helm), а также из локального catalog/ этого примера (сущности Component и Recipe web-service). Manifests попадают в dist/app/helm/ — directory: границы, за которым следует возможность provider.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если папка рабочей области ещё не содержит папку `workload-library-import`, вызовите один раз инструмент `scaffold` с параметром `example` со значением `workload-library-import` и без `dir`: он запишет пример в новую папку `workload-library-import`. Затем вызовите инструмент `build` с параметрами `workspace_root` — `workload-library-import`, `release` — `release.yaml`, `auto_pull` — true и `write` — true. Сообщите мне, какие файлы записала сборка; они находятся в `workload-library-import/dist/`.Проверка утверждения о побайтовой идентичности
Замените в Recipe workload: { $import: … } на блок workload: |,
содержащий тело StatelessService дословно, пересоберите и сравните два дерева dist/.
Они совпадают полностью: ссылка на библиотеку разрешается в тот же текст шаблона,
вычисляемый в том же контексте рендеринга, поэтому импорт — лишь вынесение
на уровне написания, никак не влияющее на байты результата рендеринга.