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

Композиція вхідних даних Recipe — три види вхідних даних, Workload, артефакти

Сутність Recipe створює файли маніфестів для свого цільового провайдера. У цьому розділі описано, як Recipes складають свій результат із трьох ортогональних видів вхідних даних — отриманих із джерела, синтезованих і артефактів, — як структуровано кожен вид вхідних даних і який провайдер який результат створює. Концептуальна роль сутності Recipe (шаблону трансляції, створеного командою Ops, який відображає намір розробника на один фізичний провайдер) описана в 04-entity-taxonomy.md; поверхня створення Recipe на рівні ключових слів описана в ../language-reference/entities/recipe.md.

Обґрунтування

Власний інструмент рендерингу кожного провайдера — Helm, Docker Compose — уже вміє рендерити нативні для провайдера маніфести. Завдання сутності Recipe — оголосити, ЩО мають містити ці маніфести: які образи контейнерів, які порти, які змінні середовища, які томи, які сервіси, які ліміти ресурсів.

Сутність Recipe має виражати більше, ніж може вмістити фіксований набір ключів (наприклад, image, environment, ports, replicas), відображений на Deployment і Service, зокрема:

  • resources (запити/ліміти CPU/пам’яті)
  • Проби liveness, readiness або startup
  • volumeMounts / volumes
  • nodeSelector / affinity / tolerations
  • serviceAccount / securityContext
  • Багатоконтейнерні поди, sidecar-контейнери
  • Ресурси ConfigMap / Secret / PVC / CRD
  • Сервіси, відмінні від ClusterIP (LoadBalancer, NodePort, Headless)

Рівень абстракції має описувати повну форму робочого навантаження, а не фіксований набір ключів. Три види вхідних даних, описані нижче, і є цією абстракцією: сутність Recipe адитивно компонує свій вивід із зовнішньо завантаженого чарту або модуля (source:), абстрактної специфікації Workload, яку провайдер синтезує в нативні для провайдера маніфести (workload:), і шаблонізованих нативних для провайдера маніфестів, які сутність Recipe виводить безпосередньо (artifacts:).

Три види вхідних даних

Композиція через додавання

Є три способи отримати файли маніфестів, рідні для провайдера, із сутності Recipe, і вони комбінуються через додавання, а не взаємно виключають одне одного:

  1. source: — зовнішньо завантажений артефакт (Helm chart, compose-файл), який провайдер рендерить нативно, а valuesMapping: надає значення для накладання.
  2. workload: — абстрактна специфікація Workload (вид, яким володіє платформа), яку провайдер синтезує в рідні для провайдера маніфести. Поле приймає вбудований блоковий скаляр YAML або $import: одного локального файлу чи запису бібліотеки; спосіб обробки визначається формою вмісту.
  3. artifacts: — мапа вбудованих або завантажених через $import: рідних для провайдера маніфестів, оброблених шаблонами Go з повним контекстом стовпів. Кожен запис можна написати вбудовано (значення запису — блоковий скаляр) або через $import: одного файлу чи вмісту бібліотеки.

Усі три створюють файли, які компілятор записує до вихідного каталогу межі. Усі три можуть співіснувати в одній сутності Recipe з дотриманням наведених нижче правил валідації. Семантика злиття діє лише на верхньому рівні: кожен вид вхідних даних створює повні файли; файли виводяться поруч; збіг імен вихідних файлів є фатальною помилкою.

Описові назви режимів

Три «режими» — це описова лексика для документації та діагностики. Автори сутностей Recipe не оголошують режим; вони пишуть потрібні ключові слова. Сутність Recipe характеризується своїм домінантним входом:

Домінантні ключові словаОписова назва режиму
source: + valuesMapping: (без workload:, без артефактів)sourced (із джерела)
workload: (без source:, без артефактів)synthesized (синтезований)
artifacts: (без source:, без workload:)artifacts-only (неформально: «inline»)
Будь-яка комбінація двох або більшеописується явно (наприклад, «sourced з артефактами», «synthesized з артефактами»)

Ключового слова mode: і переліку немає. Режим — це емерджентна властивість того, які входи присутні.

Форма Recipe з першого погляду

apiVersion: aggrega.ai/v1beta1
kind: Recipe
metadata:
name: ...
version: 1.0.0
spec:
capability: helm | compose | helm-chart | ...
implements: core/...:1.0.0
locals: { ... }
provides: { ... }
# ─── Sourced input (optional, paired) ───
source: ...
valuesMapping: |
# Go template → YAML/JSON overlay values
# OR:
valuesMapping:
$import: ./mappings/api-server.tmpl # local file path
# OR:
valuesMapping:
$import: <Lib>#/mappings/<entry> # MappingLibrary entry
# ─── Synthesized input (optional) ───
workload: |
# Go template → YAML → parsed Workload
# OR (single-source $import for whole-content load from a file or library):
workload:
$import: ./workload.yaml
# ─── Artifacts input (optional, multiple entries permitted) ───
artifacts:
"filename.yaml": |
# Inline Go template → manifest YAML
"other.yaml":
$import: ./artifacts/other.yaml # per-entry $import: for file or library content

Кожне наведене вище поле приймається схемою Recipe, і компілятор обробляє всі три види вхідних даних: рендеринг із джерела, синтез Workload і генерацію артефактів. Відрізняється підтримка на рівні окремих провайдерів, тобто який провайдер рендерить який вид вхідних даних. Її зафіксовано в розділі Provider Capability Matrix наприкінці цього розділу.

Правила валідації під час завантаження

Схема Recipe і валідація під час завантаження забезпечують такі правила композиції:

  1. valuesMapping: потребує source:. Без source: для накладання немає нічого, що отримало б зіставлені значення. Сутність Recipe з valuesMapping: і без source: — це помилка під час завантаження. (source: без valuesMapping: дозволено — chart або модуль рендериться зі своїми типовими значеннями.)
  2. workload: приймає одне джерело — вбудоване або $import:, але не обидва. Сутність Recipe задає Workload або як вбудований блоковий скаляр, або як $import: одного файлу. Форма $import: має одне джерело згідно з уніфікованою лексикою імпорту файлів; злиття кількох джерел у workload: не підтримується. Неправильно сформований спосіб обробки спричиняє помилку під час завантаження.
  3. workload: потребує провайдера, здатного до синтезу. Підтримка синтезу є властивістю самого провайдера, а не будь-якого оголошеного поля. Сутність Recipe з workload:, прив’язану до провайдера, який не може виконувати синтез, буде відхилено під час рендерингу вузла через перевірку можливостей провайдера (див. Provider Capability Matrix) із чітким діагностичним повідомленням. Каталог стандартної бібліотеки за домовленістю оголошує workloadSchema для провайдерів, здатних до синтезу, як задокументований контракт трансляції, але перевірка спирається на можливість, про яку повідомляє сам провайдер, а не на наявність цього поля.
  4. Має бути присутній щонайменше один вид вхідних даних. Сутність Recipe без жодного з source:+valuesMapping:, workload: чи artifacts: не створює вихідних даних і є помилкою під час завантаження.
  5. Вбудовані записи артефактів і записи через $import: можуть співіснувати. Сутність Recipe може оголосити одні записи artifacts: вбудовано, а інші — через директиви $import: для окремих записів. Ключ кожного запису називає його власний вихід, тож записи двох форм ніколи не конфліктують між собою (див. Що дає назву кожному вихідному файлу).
  6. Збіги імен файлів між різними видами вхідних даних — помилки під час рендерингу. Якщо два види вхідних даних сутності Recipe — вихідні дані, відрендерені з джерела, синтезовані з workload або видані як артефакти, — створюють файл з однаковим ім’ям, компілятор видає фатальну помилку, у якій названо всіх учасників. Ця перевірка виконується після трансляції Workload, тому відбувається під час рендерингу, а не завантаження.

Тип Workload

Власність і розташування

Workload — це тип, що належить платформі, з apiVersion: aggrega.ai/v1beta1. Його декларацію JSON Schema 2020-12 вбудовано у двійковий файл компілятора під час збирання; автори каталогів не редагують схему Workload і не створюють окремі YAML-файли Workload як сутності каталогу. Граматика Workload використовується всередині поля workload: сутності Recipe або FeatureRecipe (вбудовано або через $import: одного файлу чи запису WorkloadLibrary) і більше ніде.

Workload — це тип платформи й поняття компілятора, а не окрема сутність у таксономії сутностей. Recipe — це сутність, яку пише автор; Workload — це форма, якої набуває синтезований вхід сутності Recipe.

Один Workload на Recipe

Recipe декларує щонайбільше один workload:. Workload представляє єдину обчислювальну одиницю, пов’язану із сутністю Component, яку реалізує ця Recipe. FeatureRecipe так само декларує щонайбільше один власний workload: — обчислювальну одиницю, що належить сутності Feature і синтезується через той самий тип Workload, — див. FeatureRecipe. Випадки, що потребують додаткових побічних робочих навантажень, виражаються через:

  • artifacts: — додаткові маніфести поряд із робочим навантаженням у тій самій Recipe (вбудовано або через $import: для кожного запису).
  • Features із генерацією ресурсів — наскрізні побічні робочі навантаження (наприклад, sidecar резервного копіювання, приєднаний до баз даних), задекларовані як окремі сутності каталогу, де FeatureRecipe синтезує власний workload: (або рендерить через source: / artifacts:). Про генерацію ресурсів у FeatureRecipe див. 14-extensibility.md.

Це зберігає модель «одна обчислювальна одиниця на автора»: Recipe синтезує робоче навантаження сутності Component; FeatureRecipe синтезує власне.

Повна поверхня

Набір полів Workload великий і зростає. Замість повторювати його тут, де копія відставала б від контракту, і ніщо б про це не повідомило, цей розділ вказує на дві поверхні, що містять його повністю:

  • Згенерований довідник схеми Workload — кожне поле, його тип, значення за замовчуванням і обмеження, згенеровані з опублікованої JSON Schema й звірені з нею під час кожного збирання, тож він не може описати форму, якої компілятор не приймає.
  • Сторінка про написання Workload — настанови щодо окремих полів: що означає кожне поле, у що його рендерить кожен provider і які комбінації збирання відхиляє.

Декларація JSON Schema 2020-12 для Workload є авторитетною і постачається вбудованою у двійковий файл компілятора. Провайдери helm і compose синтезують workload: сутності Recipe, вбудований або завантажений через $import:; підтримку для кожного provider див. у матриці можливостей Provider.

Інтеграція секретів із featuresSchema

Блок containers.<name>.attachments у Workload посилається на слоти, задекларовані в featuresSchema сутності Component; він не декларує нових слотів. Про поверхню написання featuresSchema див. ../language-reference/entities/component.md.

Контракт валідації:

  • Кожне значення attachments.<KEY>.from має збігатися з назвою слота, задекларованого в featuresSchema сутності Component, — або, для запису, що називає з’єднання через connection: <alias>, зі слотом, який сокет цього з’єднання декларує в usesSchema.<socket>.featuresSchema. Такий запис переписується на назву, яку приєднання з’єднання отримує в компоненті (<alias>.<slot>), перш ніж виконується будь-яке з цих правил, тож кожне правило нижче читає його так само, як запис, що називає власний слот сутності Component.
  • Механізм доставки as: (env або file) має бути дозволений у масиві inject: цього слота.
  • Слоти, позначені inject: [] (чорна скринька) у featuresSchema сутності Component, не можуть з’являтися в блоках attachments: Workload — ці слоти доставляються внутрішніми механізмами Recipe (наприклад, через Helm existingSecret), а не через експонування Workload.

Приклад:

# In the Component
spec:
featuresSchema:
db_password:
required: true
inject: [env, file] # transparent: Workload may dictate delivery
root_password:
required: true
inject: [] # blackbox: Recipe handles internally
# In the Recipe
workload: |
containers:
main:
attachments:
DB_PASSWORD: # OK — db_password slot allows env inject
from: db_password
as: env
# ROOT_PASSWORD: ... # rejected — root_password is blackbox

Перевірки стану: намір, а не механізм

Проби Kubernetes і healthcheck-и Docker Compose мають різну форму. Єдина абстрактна форма наміру чисто транслюється в обидві:

health:
ready:
http: /healthz # intent: HTTP GET probe
timeoutSeconds: 5
live:
tcp: 8080 # intent: TCP socket check
timeoutSeconds: 5
startup:
exec: ["check-ready.sh"] # intent: command exec
timeoutSeconds: 30
periodSeconds: 10

Providers транслюють кожен намір у свою рідну форму:

НамірHelm (K8s)Compose
http: /pathhttpGet.path: /path, httpGet.port: <alphabetically-first port name>CMD-SHELL "curl -f http://localhost:<port>/path"
tcp: <port>tcpSocket.port: <port>CMD-SHELL "nc -z localhost <port>"
exec: [cmd]exec.command: [cmd]CMD [cmd]

Для http: без явного порту на обох цілях береться перша за абеткою назва порту, яку контейнер декларує в containers.<name>.ports. Контейнер без жодного іменованого порту не може мати HTTP-пробу, і збирання зупиняється, називаючи цю пробу.

Compose знижує HTTP/TCP-проби до команд оболонки healthcheck, а сервіс compose має лише один healthcheck: якщо оголошено кілька проб, транслюється одна, а попередження називає відкинуті.

Типи томів

П’ять типів томів; без складених:

ТипСемантикаK8s (helm)Compose
ephemeralTmpfs / emptyDir; зникає разом із podemptyDir: { sizeLimit }монтування tmpfs: без розміру (про заданий sizeLimit повідомляє попередження)
configmapКонфігураційні файли лише для читанняПосилання на том ConfigMapпосилання configs: на рівні сервісу на конфігурацію верхнього рівня, яку декларує artifacts: сутності Recipe
secretФайли секретів лише для читанняПосилання на том Secretзмонтований bind-файл секрету лише для читання
persistentОдин PVC; переживає перезапуски podРесурс PVC + volume.persistentVolumeClaimіменований том
persistentTemplatePVC для кожної репліки; супутник form: statefulStatefulSet.volumeClaimTemplatesіменований том (спрощено; видається попередження)

Compose не може виразити шаблони для кожної репліки. Коли persistentTemplate транслюється в compose, він спрощується до одного іменованого тому, спільного для всіх реплік, і попередження повідомляє про це спрощення. Том persistentTemplate вимагає form: stateful; його декларування на будь-якій іншій формі зупиняє збирання.

Експонування кількох сервісів

Кожен сервіс — це незалежне експонування. Поширений шаблон: HTTP-сервіс на порту 8080 (внутрішній ClusterIP) + сервіс метрик на порту 9090 (ClusterIP) + адміністративна кінцева точка на порту 9901 (LoadBalancer):

services:
http:
type: ClusterIP
ports:
web: 8080
metrics:
type: ClusterIP
ports:
prom: 9090
admin:
type: LoadBalancer
ports:
admin: 9901

Під час рендерингу через provider helm кожен стає окремим об’єктом Kubernetes Service, а на записі Loopback цей provider натомість зупиняється. У compose сервіси NodePort і LoadBalancer публікують свої порти на кожному інтерфейсі хоста для сервісу compose, Loopback — лише на loopback-адресі хоста, а ClusterIP і Headless не публікують нічого.

Назви сервісів у виводі K8s для унікальності мають префікс instance_id компонента. Назви портів мають збігатися з назвами портів контейнера, задекларованими в containers.<name>.ports.

Контракт трансляції на боці Provider: workloadSchema

Plugin для рендерингу provider (pluginType: provider) декларує spec.provider.workloadSchema — декларацію JSON Schema 2020-12, що документує, як поля Workload транслюються в рідний вивід цього provider. Це самодокументований контракт трансляції. Про поверхню написання Plugin, зокрема блок spec.provider, див. ../language-reference/entities/plugin.md.

apiVersion: aggrega.ai/v1beta1
kind: Plugin
metadata:
name: helm-renderer
version: 1.0.0
pluginType: provider
spec:
abiVersion: v1beta1
provider:
workloadSchema: | # how Workload translates to K8s manifests
// Each Workload produces: 1 controller object chosen by workload.form
// (stateless -> Deployment, stateful -> StatefulSet, daemon -> DaemonSet, task -> Job)
// + 1..N Services (one per workload.services entry)
// + 1..N PVCs (one per workload.volumes.*.persistent entry)
// + 1..N ConfigMap volume refs (from workload.volumes.*.configmap.source)
// ...

Поле workloadSchema повідомляє намір трансляції авторам каталогів та інструментам IDE. Це задокументований контракт трансляції, що декларується за домовленістю на providers, які синтезують, — але підтримку синтезу визначає сам provider, а не наявність цього поля. Recipe із workload:, що націлена на provider, який не вміє синтезувати, відхиляється під час рендерингу вузла — через перевірку можливостей provider — із чіткою помилкою, незалежно від того, чи декларує provider workloadSchema.

Схема Plugin декларує spec.provider.workloadSchema — її тіло компілюється в JSON Schema 2020-12 під час завантаження Plugin, — і використання workload: на боці Recipe вже доступне. Підтримка синтезу забезпечується під час рендерингу перевіркою можливостей provider, що спирається на можливість, про яку повідомляє прив’язаний provider; workloadSchema — це задокументований контракт, який каталог стандартної бібліотеки підтримує узгодженим із цією можливістю, а не сам вхід перевірки. aggrega validate, запущений для всього каталогу, додатково заздалегідь, до збирання, виявляє Recipe із workload:, прив’язану до provider, що не синтезує, якщо каталог містить сутність Plugin цього provider.

Допоміжні ресурси розміщуються поза Workload

Специфікація Workload не має поля additionalResources, поля extras чи вбудованих оголошень ConfigMap/Secret/CRD. Workload моделює лише форму робочого навантаження: контейнери, томи, сервіси, репліки, планування, контекст безпеки, обліковий запис сервісу — усе, що описує, як працює єдина обчислювальна одиниця.

Допоміжні ресурси мають два законні місця поза Workload:

  1. Features + FeatureRecipes — механізм для наскрізних аспектів. ServiceMonitor, приєднаний до «будь-якого сервера з відкритими метриками», — це core/prometheus-exporter як сутність Feature. Ресурс маршрутизації, що публікує сервер за іменем хоста, теж є сутністю Feature, і форма маршрутизації визначає, яка саме: core/public-ingress, де ціль узгоджує Ingress, core/http-route, де вона використовує Gateway API, — кожна реалізується сутністю FeatureRecipe, яку Manifest вибирає для кожної сутності Release. NetworkPolicy, що застосовується до всіх виробничих робочих навантажень, — це сутність Feature, яку виробнича сутність Release приєднує на всю межу. Features компонуються ортогонально й можуть повторно використовуватися в різних Recipes. Див. 14-extensibility.md про генерацію ресурсів FeatureRecipe.
  2. artifacts: рівня Recipe — для ресурсів, що належать до реалізації саме цієї сутності Recipe і для яких не варто створювати Feature. Одноразова реєстрація CRD, потрібна сутності Recipe. PodDisruptionBudget, специфічний для Recipe, що застосовується лише тоді, коли використовується ця Recipe. ConfigMap, на який посилається Workload цієї Recipe. Кожен запис або вбудований, або завантажений через $import:; див. розділ про механізм артефактів нижче.

Межа між Feature та артефактом — це суспільна домовленість. Якщо допоміжний ресурс є наскрізним (застосовується до багатьох Recipes або приєднується умовно через селектори), це Feature. Якщо він невід’ємний для цієї однієї Recipe (Recipe не може виконати свою роботу, не створивши цей ресурс), це артефакт. Автори обирають на основі повторного використання та семантики приєднання; компілятор не контролює цей вибір.

Features та артефакти Recipe разом охоплюють допоміжні ресурси, потрібні сутності Recipe.

Механізм artifacts

Вбудовані артефакти та артефакти, завантажені з файлів

Вид вхідних даних artifacts виводить шабльоновані нативні для провайдера файли маніфестів безпосередньо у вихід межі, поряд із будь-яким виходом, відрендереним із джерела або синтезованим із робочого навантаження. Автори оголошують його через дві поверхні:

spec:
artifacts:
"servicemonitor.yaml": |
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
name: {{ .context.instance_id }}-monitor
spec:
endpoints:
- port: {{ .workload.services.metrics.ports.prom }}
"networkpolicy.yaml":
$import: ./artifacts/networkpolicy.yaml
"crd-registration.yaml":
$import: ./artifacts/crd-registration.yaml

Шляхи $import: відносні до каталогу сутності Recipe і мають залишатися всередині нього, оскільки кожен файл, який містить публікація сутності Recipe, береться з цього каталогу — кожен файл, названий імпортом, переміщується разом із нею, — а файл поза ним не переміщувався б. Типова домовленість розміщує їх у підкаталозі ./artifacts/, хоча компілятор цього не вимагає. Ключ мапи називає кожен виведений файл — наступний розділ пояснює, що це означає в кожній із трьох форм.

Кожен запис (вбудований або завантажений через $import:) обробляється шаблонізатором Go з повним контекстом шаблону перед виведенням у вихідний каталог.

Що називає кожен вихідний файл

Мапа індексується за назвою запису, і ключ називає те, що виводить запис, у кожній формі написання. Для вбудованого запису ключ — це ім’я вихідного файлу, використане як написано:

artifacts:
"configmap-config.yaml": |
...
"pdb.yaml": |
...

Створює configmap-config.yaml і pdb.yaml. Ключ фіксує ім’я файлу; куди потрапляє файл, вирішує ціль, і це описано в розділі про виведення для кожного провайдера нижче.

Для запису файлового $import: ключ так само є ім’ям вихідного файлу. Імпортований файл надає вміст; він не надає ім’я, тож автор, якому потрібне певне ім’я вихідного файлу, записує це ім’я як ключ:

artifacts:
"monitor.yaml":
$import: ./artifacts/monitor.yaml
"netpol.yaml":
$import: ./artifacts/subdir/some-other-name.yaml

Створює .../monitor.yaml і .../netpol.yaml. Імпортований файл другого запису називається some-other-name.yaml, і це ім’я не потрапляє у вихід — потрапляє ключ. Тому два записи, що імпортують різні файли з однаковим ім’ям, ./extras/shared.yaml і ./overrides/shared.yaml, є двома окремими виходами, кожен з яких названо власним ключем.

Для запису бібліотечного $import:, який підтягує пакет файлів як одне ціле, запис розгортається в один вихід на кожен файл пакета, кожен вкладений під ключем як <key>/<filename>. Один ключ називає багато файлів, тож сам ключ не може назвати їх: він є каталогом, у який потрапляють файли пакета, а не ім’ям будь-якого з них.

Оскільки кожна форма називає свій вихід за ключем, ключ на поверхні написання обмежено тим, чим може бути одне ім’я файлу: початкова літера або цифра, далі літери, цифри, крапки, дефіси й підкреслення. Крапки несуть розширення, якого очікує споживач, і саме це дає змогу використовувати ключ безпосередньо як ім’я файлу; а алфавіт не містить / і початкової ., тож один ключ ніколи не може скласти більше одного сегмента шляху і ніколи не може бути сегментом батьківського каталогу. Ключ поза алфавітом не проходить валідацію оболонки під час завантаження робочого простору, під час aggrega validate та в діагностиці редактора.

Два виходи artifacts: з однаковим ім’ям файлу зупиняють збирання під час рендерингу вузла, незалежно від того, які форми їх створили. Два записи однієї мапи artifacts: ніколи не називають один вихід: ключ унікальний у межах одного документа і є одним ім’ям файлу, тож ім’я виходу однофайлового запису — це його ключ, а всі виходи запису-пакета розташовані в каталозі, названому його ключем. Отже, перший сегмент кожного виведеного шляху — це ключ, що його створив, і різні ключі залишаються різними іменами виходів. Зупинка охоплює випадок, що перетинає види вхідних даних, — одне ім’я файлу, яке надають два з них, наприклад шаблон чарту і запис артефакту, що обидва створюють servicemonitor.yaml, — з діагностикою, яка називає кожне джерело внеску.

Контекст шаблону для артефактів

Шаблони артефактів мають доступ до повного контексту стовпів:

  • .values, .infra, .context.*, .locals, .provides, .features, .metadata — стандартні стовпи Aggrega, описані в 06-data-taxonomy-and-composition.md.
  • .workload — розібрана специфікація Workload для цієї сутності Recipe (якщо є). Дає змогу артефактам посилатися на значення сутності Workload без дублювання, напр., ServiceMonitor, що посилається на .workload.services.metrics.ports.prom.
  • .source — розв’язаний вміст поля source: (якщо є).

Артефакти обчислюються після розбору сутності Workload, тож .workload доступне, коли воно є. Для сутностей Recipes без workload: значення .workload дорівнює nil; шаблон, що намагається його розіменувати, завершується зрозумілою помилкою. Для сутностей Recipes без source: значення .source дорівнює nil з тим самим способом збою.

Інваріант самодостатності

Артефакти мають бути самодостатніми. Вони можуть посилатися лише на оголошені вхідні дані сутності Recipe: контекст стовпів, власну сутність Workload цієї сутності Recipe (коли вона є) і власне значення source: сутності Recipe. Вони не можуть посилатися на:

  • Виходи інших сутностей Recipes у тій самій межі.
  • Навколишні ресурси Kubernetes, яких сутність Recipe не оголосила.
  • Secrets, ConfigMaps або інші ресурси, що, як припускається, існують зовні (якщо на них не посилаються через оголошений стовп).

Артефакт ConfigMap, на який посилається volumes.*.configmap.source сутності Workload, має виводитися ЦІЄЮ сутністю Recipe (через artifacts:, що створює цей ConfigMap) або сутністю Feature, приєднаною до цього вузла. Залежності між сутностями Recipes у межах однієї межі не підтримуються.

Цей інваріант зберігає повторну використовуваність сутності Recipe: сутність Recipe можна вставити в будь-яку комбінацію Aggregate + Release, що задовольняє її контракт стовпів, без прихованих залежностей.

Мітки походження

Після трансляції кожен згенерований файл містить у своїх метаданих відомості про походження aggrega.ai/* — незалежно від того, чи його відрендерено з джерела, синтезовано з робочого навантаження, чи згенеровано з шаблону артефакту. Кожна поверхня генерації проставляє їх за допомогою одного спільного набору побудовників, тож той самий файл завжди має те саме походження, хоч би який тип вхідних даних його створив. Набір поділяється залежно від того, чи задовольняє значення набір символів для значень міток Kubernetes: ключі, безпечні для міток, є мітками (за ними можна робити запити); ключі з недопустимими символами — recipe-uri (містить :), boundary-path (вкладений шлях містить /) і sync-wave (початковий - від’ємної хвилі) — є анотаціями, значення яких не обмежені. Значення ідентичності, яке збірка не підпорядковує правилам міток, — назва агрегату, середовище, назва провайдера, версії компілятора й провайдера — є міткою, записаною у формі, яку допускає мітка, а там, де ця форма відрізняється від значення, дослівне значення також є анотацією під тим самим ключем (сутність Aggregate з назвою imported/flow отримує мітку imported-flow та анотацію imported/flow). Усі файли з виводом тієї самої сутності Recipe мають однакове походження:

metadata:
labels:
aggrega.ai/component-id: api
# ... plus the recommended app.kubernetes.io/name label
annotations:
aggrega.ai/recipe-uri: api-server-helm:1.0.0
aggrega.ai/boundary-path: production

Цей поділ однаковий для всіх трьох типів вхідних даних. (Провайдер Compose не має поняття анотацій, а значення його міток не обмежені, тому він генерує весь набір як мітки сервісу.) Про проставлення походження під час компіляції див. 11-governance-and-compliance.md.

Оскільки провайдер проставляє походження там, де його передбачає власний формат виводу, провайдер, формат якого не має такого місця для певного файлу, генерує цей файл без змін і повідомляє про це. Compose — випадок, про який слід знати: місцем походження в ньому є блок labels: сервісу, тож фрагмент артефакту compose, що додає лише верхньорівневі volumes:, configs: або models:, не містить походження, і збірка видає попередження «skipped provenance label injection» (пропущено вставлення міток походження), у якому названо артефакт. Для фрагмента такої форми це попередження очікуване і не свідчить про проблему — сервіси, які генерує той самий компонент, мають повний набір, а згенеровані байти ніяк не змінюються. Виключається третя можливість: файл залишає збірку без мітки і без згадки про нього.

CloudFormation — інший випадок, про який слід знати, і відрізняється він тим, де опиняється походження, а не тим, чи воно опиняється. Шаблон CloudFormation не має блоку метаданих рівня документа, який супроводжує ресурс, тому походження записується у власний атрибут Metadata кожного ресурсу, під одним ключем aggrega.ai/provenance, що містить увесь набір:

"StoreBucket": {
"Type": "AWS::S3::Bucket",
"Metadata": {
"aggrega.ai/provenance": {
"aggrega.ai/component-id": "store",
"aggrega.ai/recipe-uri": "store-recipe:1.0.0",
"aggrega.ai/boundary-path": "stack"
}
}
}

З такого місця випливають три властивості. Атрибут Metadata доступний у кожному ресурсі незалежно від його типу, тож позначається кожен ресурс зібраного стеку — зокрема й численні типи ресурсів, які взагалі не приймають тегів і для яких позначка на основі тегів не мала б місця. Позначка додається до того Metadata, який написав автор, а не замінює його, тож власні записи автора залишаються поруч із нею. І оскільки вона ставиться для кожного ресурсу, а не для шаблону, стек, у який збирається кілька компонентів, зберігає власну ідентичність кожного ресурсу — його компонент, його сутність Recipe і його межу, — чого не зміг би виразити один запис на весь шаблон.

Увесь набір передається разом під цим ключем. Значення Metadata — це необмежений JSON, тож поділу за набором символів робити не потрібно; два ключі, які читає лише середовище виконання Kubernetes, — стандартне рекомендоване ім’я мітки та анотацію порядку розгортання, яку використовує контролер GitOps, — опущено, бо жоден із них нічого не позначає у стеку. Звичайний запис походження aggrega.ai/sync-wave залишається, бо він фіксує хвилю, яку оголосив компонент, а не дає вказівку контролеру.

Форма, яка тут не має місця, — це шаблон або фрагмент, що не оголошує жодного ресурсу, тобто додає лише Parameters, Mappings, Conditions або Rules. Він не містить походження, потрапляє до зібраного стеку з незміненим вмістом, а збірка видає попередження «skipped provenance injection» (пропущено вставлення походження), у якому його названо. Як і з compose, для внеску такої форми це попередження очікуване: ресурси, які той самий компонент додає деінде, мають повний набір, а згенеровані байти однакові незалежно від того, чи хтось їх відстежує.

Семантика артефактів для кожного Provider

Наведена нижче семантика для кожного провайдера описує, як кожен провайдер інтегрує артефакти у свій нативний вивід.

Провайдер helm: артефакти — це документи Kubernetes YAML, що записуються в каталог, названий за компонентом, який їх оголосив, усередині вихідного каталогу з маніфестами, відрендереними з чарта та синтезованими з Workload. Причина в іменуванні: відрендерений або синтезований маніфест провайдер називає за компонентом, якому той належить, тоді як артефакт названо ключем, який написав його автор, і цей ключ нічого не каже про те, який це компонент, — тож два компоненти, прив’язані до одного Recipe, записали б один шлях, і жоден автор не зміг би їх розділити. Каталог має власне ім’я компонента, тож файл, який автор бачить у виводі, має ім’я, яке він написав, на один рівень нижче.

Оператор, якому потрібна інша структура, має шаблон subDirectory: межі, що переміщує кожен файл, який виводить учасник, а не лише артефакти. Див. ../language-reference/path-template-variables.md.

Провайдер compose: артефакти — це фрагменти compose. Ключі верхнього рівня (services:, volumes:, configs:, models:) об’єднуються в спільний для межі docker-compose.yaml під час кроку композиції межі.

Провайдер helm-chart (особливий випадок): артефакти не записуються у вихідний каталог як окремі файли — конвеєр рендерингу належить Helm. Натомість провайдер helm-chart розміщує кожен запис artifacts: усередині самого чарта, і авторська форма запису визначає, куди він потрапить. Кожен запис СПОЧАТКУ обробляється шаблонами Go з контекстом стовпів Aggrega, ще до будь-якого розміщення; далі дві форми розходяться. Запис, завантажений через $import:, — це файл шаблону до Helm: його вставляють у каталог templates/ чарта ДО рендерингу Helm, тож Helm рендерить його разом із власними шаблонами вихідного чарта. Вбудований блоковий скаляр — це вільний файл чарта: його розміщують у корені чарта під авторським ключем, без префікса templates/ і без об’єднаних міток походження, тож власні шаблони чарта можуть читати його через .Files.Get / .Files.Glob Helm — патерн ConfigMap-from-files. Це дає провайдеру helm-chart механізм розширення, рівноцінний тому, що artifacts: надає звичайному провайдеру helm, з дотриманням моделі чартів Helm.

Вставлений файл потрапляє до boundaries/<bp>/charts/<nodeID>/templates/<authored-key> — файли пакета вкладено під цим ключем, — тож він лежить поруч із шаблонами вихідного чарта, і Helm підхоплює його під час подальшого проходу рендерингу. Вбудований блоковий скаляр потрапляє до boundaries/<bp>/charts/<nodeID>/<authored-key> — у корінь чарта, на рівень вище за templates/, — бо файл, що читається через .Files, має лежати там, де чарт його шукає, а файл, розміщений у templates/, натомість рендериться як маніфест. Обидві форми названо ключем, під яким їх написано; відрізняє їх лише каталог, у який їх розміщує провайдер.

Домовленість щодо роздільників helm-chart. Попередній прохід шаблонізації Aggrega для записів артефактів helm-chart — як завантажених через $import:, так і вбудованих — використовує роздільники [[ ]] замість типових {{ }}, щоб власний синтаксис Helm {{ ... }} у файлі без змін дійшов до проходу рендерингу Helm. Автори пишуть підстановки на боці Aggrega як [[ .context.instance_id ]], [[ .values.name ]] тощо; підстановки на боці Helm лишаються як {{ .Values.x }}, {{ .Release.Name }}, {{- include "common.labels" . }} тощо. Поєднання двох пар роздільників в одному файлі — підтримувана форма написання.

Походження та артефакти helm-chart. Походження об’єднується в metadata.labels і metadata.annotations (згідно з розподілом за набором символів вище) для файлів, завантажених через $import:, які проходять повний цикл через YAML зі збереженими токенами Helm, — файлів, що використовують лише контекст Aggrega [[ ]] або мають Helm {{ }} лише в позиціях скалярів у лапках. Файли зі структурними діями шаблонів Helm ({{- include ... }}, {{- if ... }}, {{- range ... }}, {{- with ... }} у позиціях, де вони виводять структуру YAML, а не скалярні листки) або файли з {{ ... }} без лапок у позиціях значень не витримують повного циклу YAML в Aggrega; збірка виводить попередження «skipped provenance label injection» (пропущено вставлення міток походження) з назвою артефакту і передає файл без змін. Це попередження очікуване для будь-якого файлу артефакту helm-chart, завантаженого через $import:, що використовує структурні дії шаблонів Helm або підстановки значень Helm без лапок — це типовий випадок у продакшн-написанні Helm, а не крайній. Автори, яким потрібні мітки походження на таких файлах, вставляють їх через іменований шаблон, який вони самі пишуть у власному _helpers.tpl чарта (наприклад, шаблон з назвою aggrega.commonLabels), або рівноцінний механізм на боці Helm, а не через попередню вставку шаблонів Aggrega.

Колізії імен файлів у корені чарта. Артефакт, завантажений через $import:, чий авторський ключ збігається з ім’ям файлу в корені чарта (Chart.yaml, values.yaml, .helmignore тощо), не виявляється перевіркою колізій імен файлів Aggrega — артефакт потрапляє до templates/<authored-key>, а файл кореня чарта лежить у корені, і префіксування шляху робить їх різними з погляду Aggrega. Автори уникають таких імен ключів; наслідок їх використання — Helm бачить обидва файли (один у корені чарта, один у templates/) і може неочікувано відрендерити копію з боку шаблонів.

Провайдер terraform: артефакти — це файли конфігурації Terraform, що виводяться дослівно у власний каталог компонента в дереві modules/ межі. HCL (main.tf) — зручний типовий варіант, і Terraform JSON (.tf.json) приймається рівноцінно; жоден не транспілюється і не переформатовується. Коренева конфігурація межі оголошує цей компонент як блок module, чиє source вказує на цей каталог, тож уся межа лишається одним графом залежностей; це той самий каталог, який займають файли вендореного модуля, тож Recipe, що оголошує і source:, і artifacts:, записує їх поруч. Походження передається як початковий блок коментарів Terraform; коли компонент додає тіло JSON, яке не має синтаксису коментарів, кожне тіло виводиться без змін, а походження передається в супутньому файлі .tf, що містить лише коментарі, поруч із ними, тож мітка ніколи не дублюється в обох. Див. сторінку провайдера terraform.

Провайдер cloudformation: артефакти — це фрагменти стека: ресурси, які додає один компонент, а не цілий шаблон. Провайдер нормалізує кожен фрагмент до довгої форми вбудованих функцій у чистому JSON і об’єднує його в єдиний стек, зібраний для цього вихідного каталогу, де ресурси потрапляють до однієї мапи Resources, а provides компонента стають Outputs стека під іменами, обмеженими компонентом, що їх публікує. Які інші розділи верхнього рівня фрагмента зберігаються під час збирання, описано в розділі What a merged document carries from artifacts:. Див. сторінку провайдера cloudformation.

Область межі: файли для спільного виводу межі

Механізм артефактів має другу область. Усе описане вище записується в позицію самого компонента у виводі його межі; spec.boundary.artifacts у Recipe — це та сама мапа (ті самі три форми, те саме правило відповідності ключа імені файлу, той самий контекст шаблонів), але записана один раз для межі загалом. Вона існує для файлу, який ціль зчитує один раз для всього, що розгортає межа, і який не може вмістити позиція жодного окремого компонента: документація Terraform зазначає, що модуль, призначений для виклику, не повинен містити блоків provider, а модуль, який їх містить, не можна викликати з depends_on, count чи for_each, тож конфігурація провайдера належить до кореневої конфігурації межі, а не до модуля компонента.

Куди він потрапляє. У каталог, що містить зібраний вивід групи диспетчеризації, поруч із файлами, які записує туди власне збирання провайдера; для terraform — поруч із кореневою конфігурацією. Компілятор обчислює кожен запис один раз для кожного компонента, який рендерить Recipe, у контексті цього компонента, і записує файл сам: провайдер не отримує жодного з цих файлів, і в жоден із них не вставляється позначка про те, з якого компонента він походить, бо він належить кожному учаснику, що його оголосив.

Як зустрічаються учасники. Файли, оголошені всіма учасниками однієї групи диспетчеризації, об’єднуються за іменем. Одне ім’я, оголошене з ідентичними байтами, — це один файл; одне ім’я, оголошене з різними байтами, або ім’я, яке записує саме збирання провайдера, зупиняє збирання з назвою файлу та всіх учасників — та сама відмова, з якою стикаються два учасники, що записують один шлях виводу. Тож конфігурацію провайдера, потрібну двом Recipes, обидва записують під одним ім’ям, а збирання перевіряє, що вони збігаються.

Хто її приймає. Чи має сенс файл, розміщений поруч із зібраним виводом межі, залежить від цілі провайдера, тож це власне твердження провайдера, яке зчитується з власного оголошення провайдера, як і його типи вхідних даних. Recipe, що оголошує цей блок для провайдера, який цього не заявляє, відхиляється ще до будь-якого рендерингу. Таблиця нижче містить це твердження в останньому стовпці; серед провайдерів, що поширюються разом із компілятором, його робить terraform.

Чим артефакти не є

Три структурні відмінності:

Не міжпровайдерні в межах одного Recipe. Recipe оголошує рівно одну capability: на початку свого spec. Усе, що створює Recipe (вивід, відрендерений із джерела, вивід, синтезований із workload, і артефакти), має нативний формат цього провайдера. Артефакти helm Recipe містять Kubernetes YAML. Артефакти compose Recipe містять фрагменти compose. Recipe націлений на один провайдер; увесь вивід має нативний формат цього провайдера.

Багатопровайдерна композиція відбувається на рівні Release. Межі містять компоненти різних провайдерів; учасники кожного провайдера за обчисленим шляхом межі диспетчеризуються та збираються незалежно для кожної пари (шлях, провайдер). Release із компонентами, націленими відповідно на helm, helm-chart і compose, може розмістити всі три в одній межі; групування диспетчеризації розділяє їх за провайдерами, учасники кожного провайдера потрапляють у власний зібраний вивід під шляхом межі, а оператор задає міжпровайдерну координацію через обрану ним структуру меж. Міжпровайдерна координація — відповідальність автора сутності Release.

Не Recipes у Recipes. Артефакти не завантажують і не компонують інші Recipes. Це вбудовані маніфести (або шляхи до файлів із вбудованими маніфестами), шаблонізовані стовпами цього Recipe й видані у вивід цього Recipe. Повторне використання Recipe відбувається через три механізми: extends: сутності Component (Recipe, написаний для базової Component, обслуговує кожну Component, що її розширює; успадковуються метадані та схеми, а не вихідні файли — сам Recipe не оголошує extends:); пласке відображення URI у сутності Manifest (той самий Component може розв’язуватися в різні Recipes у різних каталогах — див. ../language-reference/entities/manifest.md); а також Features + FeatureRecipes (наскрізні аспекти, приєднані ортогонально).

Не шар зв’язування між Recipe. Артефакти не можуть посилатися на імена, ресурси чи стан, які Recipe не оголосив сам. Артефакт ConfigMap, на який посилається Workload цього Recipe, має видаватися цим Recipe. Артефакт, що очікує зовнішньо створений Secret, має отримати ім’я цього Secret через стовп .features (із розв’язаних provides приєднання, яке його видає), а не припускати, що він існує. Це інваріант самодостатності (див. вище), сформульований з погляду автора артефактів: кожен Recipe видає файли в одному форматі, що застосовуються одним інструментом, в один каталог виводу межі.

Матриця можливостей Provider

Кожен провайдер оголошує, які типи вхідних даних він рендерить; центральний шлюз типів вхідних даних приймає підтримувані комбінації та відхиляє решту з уніфікованою діагностикою під час рендерингу вузла. Можливість — це властивість провайдера, а не Recipe: провайдер рендерить підмножину з трьох типів. Стовпець artifacts: розрізняє артефакти, що йдуть поряд з основним вмістом із джерела чи синтезованим, та автономний Recipe лише з артефактами (без source:, без workload:). Останні два стовпці — це заяви провайдера про те, що він враховує omits: і що він приймає файли, які Recipe додає до спільного виводу своєї межі через boundary.artifacts: (вище); жоден із них не є типом вхідних даних.

Читайте кожен стовпець окремо. Рядок показує, які типи провайдер рендерить, якщо брати їх по одному. Він не стверджує, що два позначені типи можна оголосити разом. Оскільки типи компонуються додаванням, кожен оголошений тип диспетчеризується та виводиться окремо, тож пару може бути відхилено з причини, якої не відображає жоден стовпець, — найчастіше тому, що обидва типи створюють файл з однаковою вихідною назвою. Які комбінації кожен провайдер справді приймає, описано текстом у розділі Що саме приймає кожен провайдер.

Providersource: + valuesMapping:workload:artifacts: (поряд)лише артефакти (автономно)omits:boundary.artifacts:
helm✅✅✅✅✅❌
compose✅✅✅✅✅❌
helm-chart✅❌✅ шаблонізується з роздільниками [[ ]]❌❌❌
terraform✅❌✅✅❌✅
cloudformation✅❌✅✅✅❌

Ця таблиця охоплює провайдерів, що постачаються разом із компілятором. Провайдер, що постачається окремо, так само оголошує, які типи вхідних даних він приймає, чи враховує він omits: і чи приймає boundary.artifacts:, а компілятор читає це оголошення тим самим шляхом; його тут не перелічено, бо опублікована сторінка не може перелічити провайдерів, яких вона ніколи не бачила.

Клітинки з позначкою ✅ рендеряться; ❌ — це відмова через можливості провайдера, яку повідомляє шлюз. Фрагменти compose окремих вузлів об’єднуються за шляхом збирання, тож межі зі спільним directory: мають один спільний файл.

Що саме приймає кожен провайдер

helm — будь-яка комбінація. source: + valuesMapping:, workload:, artifacts:, будь-які два з них або всі три. Це єдиний провайдер із постачання компілятора, що не відхиляє жодної комбінації, і причина в тому, як він називає вивід: кожен файл називається за ресурсом у ньому, тож відрендерені маніфести чарту й маніфести синтезованого Workload ніколи не отримують однакову назву. Recipe, що оголошує всі три, виводить файли чарту, файли Workload і файли артефактів поруч у вихідному каталозі межі.

compose — будь-яка комбінація, крім двох, у яких source: і workload: трапляються разом. Кожен тип окремо збирається, а artifacts: може йти поряд із будь-яким із них. source: разом із workload: зібрати не можна, як і всі три разом; чому — пояснено в розділі Чому compose не може поєднати джерело з workload, і це не відмова через можливості.

helm-chart — source: + valuesMapping:, окремо або з artifacts: поряд. Більше нічого. Він не синтезує workload: і не має форми лише з артефактами: Recipe, єдиним типом вхідних даних якого є artifacts:, зупиняє збирання. Причина в тому, куди цей провайдер кладе артефакт — у власний чарт компонента, тож Recipe без source: не залишає чарту, куди його покласти.

terraform — три форми: лише source: + valuesMapping:, лише artifacts: або обидва разом. Він не синтезує workload:.

cloudformation — ті самі три форми, що й terraform, з тим самим єдиним винятком. Лише source: + valuesMapping:, лише artifacts: або обидва разом; без workload:.

Як виглядає відхилений тип вхідних даних

Recipe, що оголошує тип вхідних даних, який пов’язаний провайдер не рендерить, зупиняє збирання під час рендерингу вузла, і зупиняє його незалежно від того, що ще Recipe оголошує поряд із цим типом: поєднання workload: із source:, який провайдер може відрендерити, не проводить workload далі. Повідомлення про зупинку називає провайдера, тип, який він не може відрендерити, і типи, які він рендерить:

[CATALOG_ERROR E0265] instance unit
provider does not support the node's input kind (node "unit"). provider "terraform" does not support synthesized recipes (this provider supports: sourced, artifacts-only); declare one of the supported input kinds, or target a provider that supports synthesized

Відмова для форми лише з артефактами читається так само й називає цю форму: provider "helm-chart" does not support artifacts-only recipes (this provider supports: sourced). E0265 — ідентифікатор, який слід записувати, коли цю зупинку потрібно зафіксувати надовго: у шлюзі безперервної інтеграції, у задачі чи в регламенті; таблиця всіх умов його розшифровує.

Чому compose не може поєднати джерело з workload

Провайдер compose створює один фрагмент на компонент і називає цей фрагмент за компонентом. Рендеринг із джерела та синтез Workload кожен створюють фрагмент цього компонента під тією самою назвою, тож Recipe, що оголошує обидва, створює два однаково названі файли, і збирання зупиняється через колізію:

[CATALOG_ERROR E0211] instance unit
rendering node "unit"
caused by: [CATALOG_ERROR] aggregate.yaml at .spec.components.unit
filename collision across input kinds: two input-kind blocks produced a file under one output name (output name "unit.compose-fragment.yaml", produced by "source, workload")

Назва фрагмента походить від власного ідентифікатора компонента, і задати її під час авторингу неможливо, тож жодна зміна власного вмісту Recipe не усуває колізії. Зупинка — властивість пари, а не котрогось із типів: compose рендерить джерело, compose синтезує Workload, і таблиця слушно позначає обидва. Щоб використати обидві форми для одного компонента в compose, рознесіть їх на два компоненти або перенесіть вміст джерела у Workload.

Що об’єднаний документ переносить з artifacts:

Два провайдери об’єднують своїх учасників в один документ на кожен шлях збирання: compose — в один docker-compose.yaml, cloudformation — в один шаблон стека. Об’єднаний документ може переносити лише ті розділи, які моделює його збирач, тому позначка artifacts: вказує, куди розміщується вміст фрагмента, а не те, що кожен ключ усередині фрагмента зберігається.

compose переносить з фрагмента артефакту services:, volumes:, configs: і models: разом із його ключами розширення з префіксом x-. Фрагмент, що оголошує на верхньому рівні щось інше, зупиняє збірку із зазначенням ключа — networks:, оскільки мережі виводяться для кожної межі, а не накопичуються від учасників, а так само блок secrets: чи name: верхнього рівня. Сторінка провайдера compose наводить правила об’єднання для кожного ключа та альтернативу для маршрутизації між мережами.

cloudformation переносить Resources, Outputs, Parameters, Mappings, Conditions, Metadata і Rules, а Transform будує з відповідних розділів усіх учасників. Трансформації об’єднуються в порядку, який документує CloudFormation, причому Globals від SAM переноситься разом із трансформацією, що їх читає, а трансформація, яка змінила б спосіб розгортання вмісту іншого учасника, зупиняє збирання з зазначенням її назви. Description не переноситься, і збирання про це повідомляє: воно видає попередження про непідтримуване поле із зазначенням розділу та компонента, як і для будь-якого іншого ключа верхнього рівня, який стек не переносить, тож ніщо не відкидається мовчки. Попередження має рекомендаційний характер — згенерований шаблон байт у байт такий самий, яким був би без нього, а --no-unsupported-field-warnings вимикає цей клас попереджень. Outputs переноситься під назвою, яку провайдер обмежує компонентом-учасником, тож два компоненти, що додають до одного стека вихідне значення з однаковою назвою, не змішують їх. Розділи верхнього рівня у зібраному стеку описує кожен розділ окремо.

Інші три провайдери не виконують злиття, тож жодному ключу артефакту не загрожує відкидання асемблером. helm нічого не збирає: маніфести кожного компонента потрапляють до вихідного каталогу межі такими, як є. terraform і helm-chart вкладають — файли кожного компонента потрапляють до окремого каталогу, каталогу модуля Terraform або субчарта, а кореневий документ на рівні межі посилається на них, — тож запис артефакту розміщується як цілий файл, а не зчитується до спільного документа. Куди потрапляє запис артефакту helm-chart і чому його пара роздільників відрізняється, описано в розділі Per-Provider Artifact Semantics (семантика артефактів для кожного провайдера).