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

Імпорт із бібліотеки робочих навантажень — спільне тіло 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 зафіксовану бібліотеку буде розв’язано, а її запис — відрендерено.

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

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

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

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 і провайдер 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/. Вони точно збігаються: посилання на бібліотеку розв’язується в той самий текст шаблону, що обчислюється в тому самому контексті рендерингу, тож імпорт лише структурує поверхню написання й не впливає на відрендерені байти.