Імпорт із бібліотеки робочих навантажень — спільне тіло Workload через `$import`
Один вебсервіс без стану, Recipe якого синтезує свій Kubernetes Workload
із спільного запису бібліотеки замість вбудованого тіла. Це третій
режим написання spec.workload у сутності Recipe:
- Режим 1 (вбудований): Go-шаблон Workload, написаний безпосередньо в 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 і провайдер helm), а також із локального каталогу catalog/ цього прикладу (Component і Recipe web-service). Manifests потрапляють у dist/app/helm/ — directory: межі, за яким іде можливість провайдера.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами 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/.
Вони точно збігаються: посилання на бібліотеку розв’язується в той самий текст
шаблону, що обчислюється в тому самому контексті рендерингу, тож імпорт лише
структурує поверхню написання й не впливає на відрендерені байти.