Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Импорт из библиотеки 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 зафиксированная библиотека разрешается, и её запись рендерится.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example workload-library-import

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd workload-library-import

Сборка

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega 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/. Они совпадают полностью: ссылка на библиотеку разрешается в тот же текст шаблона, вычисляемый в том же контексте рендеринга, поэтому импорт — лишь вынесение на уровне написания, никак не влияющее на байты результата рендеринга.