Композиция входных данных Recipe — три вида входных данных, Workload, артефакты
Сущность Recipe создаёт файлы манифестов для своего целевого провайдера. В этой главе описано, как Recipes составляют свой вывод из трёх ортогональных видов входных данных — получаемых из источника (sourced), синтезируемых (synthesized) и артефактов (artifacts), — как устроен каждый вид входных данных и какой провайдер какой вывод создаёт. Концептуальная роль сущности Recipe (созданного Ops шаблона трансляции, который отображает намерение разработчика (Developer Intent) на один физический провайдер) описана в 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/volumesnodeSelector/affinity/tolerationsserviceAccount/securityContext- Поды с несколькими контейнерами, sidecar-контейнеры
- Ресурсы ConfigMap / Secret / PVC / CRD
- Сервисы, отличные от ClusterIP (LoadBalancer, NodePort, Headless)
Уровень абстракции должен описывать полную форму рабочей нагрузки, а не фиксированный набор ключей. Три вида входных данных, описанные ниже, и есть эта абстракция: сущность Recipe аддитивно составляет свой вывод из загружаемого извне чарта или модуля (source:), абстрактной спецификации Workload, которую провайдер синтезирует в нативные манифесты провайдера (workload:), и шаблонизированных нативных манифестов провайдера, которые Recipe выдаёт напрямую (artifacts:).
Три вида входных данных
Композиция через сложение
Существует три способа получить из сущности Recipe нативные для провайдера файлы манифестов, и они комбинируются через сложение, а не взаимно исключают друг друга:
source:— внешне загружаемый артефакт (Helm-чарт, compose-файл), который провайдер рендерит нативно, аvaluesMapping:поставляет накладываемые значения.workload:— абстрактная спецификация Workload (вид, принадлежащий платформе), которую провайдер синтезирует в нативные для провайдера манифесты. Поле принимает встроенный блочный скаляр YAML или$import:одного локального файла или записи библиотеки; выбор способа определяется формой содержимого.artifacts:— словарь нативных для провайдера манифестов, встроенных или загружаемых через$import:, обрабатываемых шаблонизатором Go с полным контекстом столпов. Каждую запись можно написать встроенно (значение записи — блочный скаляр) или через$import:одного файла или содержимого библиотеки.
Все три способа создают файлы, которые компилятор выводит в выходной каталог границы. Все три могут сосуществовать в одной сущности Recipe с учётом правил валидации ниже. Семантика слияния — только на верхнем уровне: каждый вид входных данных создаёт целые файлы; файлы выводятся рядом друг с другом; совпадение имён выходных файлов является фатальной ошибкой.
Описательные названия режимов
Три «режима» — это описательная терминология для документации и диагностики. Авторы сущностей Recipe не объявляют режим; они пишут нужные им ключевые слова. Сущность Recipe характеризуется своим преобладающим видом входных данных:
| Преобладающие ключевые слова | Описательное название режима |
|---|---|
source: + valuesMapping: (без workload:, без artifacts) | sourced |
workload: (без source:, без artifacts) | synthesized |
artifacts: (без source:, без workload:) | artifacts-only (неформально: «inline») |
| Любое сочетание двух и более | описывается явно (например, «sourced with artifacts», «synthesized with artifacts») |
Ключевого слова mode: и перечисления нет. Режим — это эмерджентное свойство, определяемое тем, какие входные данные присутствуют.
Структура Recipe вкратце
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: ... version: 1.0.0spec: 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 и валидация при загрузке обеспечивают следующие правила композиции:
valuesMapping:требуетsource:. Безsource:, на который накладываются значения, сопоставленные значения некуда передать. Сущность Recipe сvaluesMapping:и безsource:— ошибка при загрузке. (source:безvaluesMapping:допускается — чарт или модуль рендерится со своими значениями по умолчанию.)workload:принимает один источник — встроенный или$import:, но не оба. Сущность Recipe задаёт Workload либо как встроенный блочный скаляр, либо как$import:одного файла. Форма$import:допускает один источник согласно единой терминологии импорта файлов; слияние нескольких источников вworkload:не поддерживается. Некорректная форма приводит к ошибке при загрузке.workload:требует провайдера, способного к синтезу. Поддержка синтеза — свойство самого провайдера, а не какого-либо объявленного поля. Recipe сworkload:, привязанный к провайдеру, который не умеет синтезировать, отклоняется при рендеринге узла — через проверку возможностей провайдера (см. матрицу возможностей провайдеров, Provider Capability Matrix) — с понятной диагностикой. Каталог стандартной библиотеки по соглашению объявляетworkloadSchemaу провайдеров, способных к синтезу, как документированный контракт трансляции, однако проверка опирается на возможность, о которой сообщает сам провайдер, а не на наличие этого поля.- Должен присутствовать хотя бы один вид входных данных. Сущность Recipe без
source:+valuesMapping:,workload:иartifacts:не создаёт выходных данных и является ошибкой при загрузке. - Встроенные записи артефактов и записи через
$import:могут сосуществовать. Сущность Recipe может объявить одни записиartifacts:встроенно, а другие — через директивы$import:для отдельных записей. Ключ каждой записи задаёт имя её собственного вывода, поэтому записи двух форм никогда не конфликтуют друг с другом (см. Что задаёт имя каждого выходного файла). - Совпадения имён файлов между видами входных данных — ошибки при рендеринге. Если два вида входных данных сущности 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 — рекомендации по отдельным полям: что означает каждое поле, во что его преобразует каждый провайдер и какие сочетания сборка отвергает.
Объявление Workload на JSON Schema 2020-12 является авторитетным и поставляется встроенным в двоичный файл компилятора. Провайдеры helm и compose синтезируют workload: сущности Recipe, встроенный или загруженный через $import:; поддержку по каждому провайдеру см. в матрице возможностей 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 (например, черезexistingSecretв Helm), а не через Workload.
Пример:
# In the Componentspec: featuresSchema: db_password: required: true inject: [env, file] # transparent: Workload may dictate delivery root_password: required: true inject: [] # blackbox: Recipe handles internally
# In the Recipeworkload: | 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: 10Providers транслируют каждое намерение в свою нативную форму:
| Намерение | Helm (K8s) | Compose |
|---|---|---|
http: /path | httpGet.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 |
|---|---|---|---|
ephemeral | Tmpfs / emptyDir; исчезает вместе с подом | emptyDir: { sizeLimit } | монтирование tmpfs: без размера (о заданном sizeLimit сообщает предупреждение) |
configmap | Конфигурационные файлы только для чтения | Ссылка на том ConfigMap | ссылка configs: уровня сервиса на конфигурацию верхнего уровня, объявленную в artifacts: сущности Recipe |
secret | Файлы секретов только для чтения | Ссылка на том Secret | bind-монтируемый файл секрета только для чтения |
persistent | Один PVC; сохраняется при перезапусках пода | Ресурс PVC + volume.persistentVolumeClaim | именованный том |
persistentTemplate | PVC на каждую реплику; используется вместе с form: stateful | StatefulSet.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При рендеринге провайдером helm каждый из них становится отдельным объектом Kubernetes Service; на записи Loopback этот провайдер останавливает сборку. В compose сервисы NodePort и LoadBalancer публикуют свои порты на всех интерфейсах хоста сервиса compose, Loopback — только на loopback-адресе хоста, а ClusterIP и Headless ничего не публикуют.
Имена сервисов в выводе K8s для уникальности получают префикс instance_id компонента. Имена портов должны совпадать с именами портов контейнера, объявленными в containers.<name>.ports.
Provider-Side: контракт трансляции на стороне провайдера — workloadSchema
Сущность Plugin, выполняющая рендеринг провайдера (pluginType: provider), объявляет spec.provider.workloadSchema — объявление на JSON Schema 2020-12, документирующее, как поля Workload транслируются в нативный вывод этого провайдера. Это самодокументируемый контракт трансляции. Описание сущности Plugin, включая блок spec.provider, см. в ../language-reference/entities/plugin.md.
apiVersion: aggrega.ai/v1beta1kind: Pluginmetadata: name: helm-renderer version: 1.0.0 pluginType: providerspec: 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. Это документированный контракт трансляции, объявляемый по соглашению у провайдеров, поддерживающих синтез, — но поддержка синтеза определяется самим провайдером, а не наличием этого поля. Сущность Recipe с workload:, нацеленная на провайдер, не поддерживающий синтез, отклоняется при рендеринге узла — через проверку возможностей провайдера — с понятной ошибкой, независимо от того, объявляет ли провайдер workloadSchema.
Схема Plugin объявляет spec.provider.workloadSchema — его тело компилируется в JSON Schema 2020-12 при загрузке сущности Plugin, — и использование workload: на стороне Recipe уже поставляется. Поддержка синтеза проверяется при рендеринге проверкой возможностей провайдера, опирающейся на возможности, о которых сообщает привязанный провайдер; workloadSchema — документированный контракт, который каталог стандартной библиотеки поддерживает в соответствии с этой возможностью, а не входные данные самой проверки. Кроме того, aggrega validate, запущенный по всему каталогу, заранее, до сборки, выявляет сущность Recipe с workload:, привязанную к провайдеру без поддержки синтеза, если каталог содержит сущность Plugin этого провайдера.
Вспомогательные ресурсы находятся вне Workload
В спецификации Workload нет поля additionalResources, нет extras и нет встроенных объявлений ConfigMap/Secret/CRD. Workload моделирует только форму рабочей нагрузки: контейнеры, тома, сервисы, реплики, планирование, контекст безопасности, сервисную учётную запись — всё, что описывает, как работает единственная вычислительная единица.
У вспомогательных ресурсов есть два законных места вне Workload:
- Features + FeatureRecipes — механизм для сквозных задач. ServiceMonitor, прикреплённый к «любому серверу с открытыми метриками», — это
core/prometheus-exporterв виде сущности Feature. Ресурс маршрутизации, публикующий сервер по имени хоста, тоже является сущностью Feature, и выбор определяется формой маршрутизации:core/public-ingress, если целевая среда согласует Ingress, иcore/http-route, если она использует Gateway API, — каждый реализуется сущностью FeatureRecipe, которую Manifest выбирает для каждой сущности Release. NetworkPolicy, применяемая ко всем рабочим нагрузкам в production, — это Feature, которую production-сущность Release присоединяет на всю границу. Features компонуются ортогонально и могут повторно использоваться в разных Recipes. О генерации ресурсов в FeatureRecipe см. 14-extensibility.md. artifacts:уровня Recipe — для ресурсов, которые относятся к реализации именно этой сущности Recipe и ради которых не стоит создавать Feature. Разовая регистрация CRD, необходимая Recipe. Специфичный для Recipe PodDisruptionBudget, который применяется только при использовании этой сущности Recipe. ConfigMap, на который ссылается Workload этой сущности Recipe. Каждая запись задаётся встроенно или загружается через$import:; см. раздел о механизме артефактов ниже.
Граница между Feature и артефактом — общественное соглашение. Если вспомогательный ресурс сквозной (применяется ко многим Recipes или прикрепляется условно через селекторы), это Feature. Если он неотъемлем от этой одной сущности Recipe (Recipe не может выполнить свою задачу, не создав этот ресурс), это артефакт. Авторы выбирают исходя из повторного использования и семантики прикрепления; компилятор не контролирует этот выбор.
Features и артефакты Recipe вместе покрывают вспомогательные ресурсы, которые нужны сущности Recipe.
Механизм артефактов
Встроенные и загружаемые из файлов артефакты
Вид входных данных 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, прикреплённой к этому узлу. Зависимости между сущностями Recipe в пределах границы не поддерживаются.
Этот инвариант сохраняет переиспользуемость сущности Recipe: сущность Recipe можно поместить в любую комбинацию Aggregate + Release, удовлетворяющую её контракту столпов, без скрытых зависимостей.
Метки происхождения
После трансляции каждый выпущенный файл несёт в своих метаданных сведения о происхождении aggrega.ai/* — независимо от того, был ли он отрисован из источника, синтезирован из workload или выпущен из шаблона артефакта. Каждая выпускающая поверхность проставляет их с помощью одного общего набора построителей, поэтому один и тот же файл всегда несёт одни и те же сведения о происхождении, каким бы видом входных данных он ни был создан. Набор делится по тому, удовлетворяет ли значение набору символов для значений меток 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: артефакты — это YAML-документы Kubernetes, записываемые в каталог, названный по имени объявившего их компонента, внутри выходного каталога, где лежат манифесты, отрендеренные из чарта и синтезированные из сущности 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 стека под именами, привязанными к публикующему компоненту. О том, какие другие разделы верхнего уровня фрагмента сохраняются при сборке, см. Что объединённый документ переносит из artifacts:. См. страницу провайдера cloudformation.
Область границы: файлы для общего вывода границы
У механизма artifacts есть вторая область действия. Всё описанное выше записывается в собственную позицию компонента в выводе его границы; spec.boundary.artifacts сущности Recipe — та же карта (те же три формы, то же правило сопоставления ключа и имени файла, тот же контекст шаблона), но записываемая один раз для границы в целом. Она существует для файла, который целевая система читает один раз для всего, что развёртывает граница, и который не может храниться ни в чьей собственной позиции компонента: документация Terraform говорит, что модуль, предназначенный для вызова, не должен содержать блоков provider, а модуль, который их содержит, нельзя вызывать с depends_on, count или for_each, поэтому конфигурация провайдера относится к корневой конфигурации границы, а не к модулю компонента.
Куда он попадает. В каталог, содержащий собранный вывод группы диспетчеризации, рядом с файлами, которые записывает туда собственная сборка провайдера; для terraform — рядом с корневой конфигурацией. Компилятор вычисляет каждую запись один раз для каждого компонента, который отрисовывает Recipe, в контексте этого компонента, и сам записывает файл: провайдеру не передаётся ни один из этих файлов, и в файл не вносится отметка о том, от какого компонента он пришёл, поскольку он принадлежит каждому участнику, который его объявил.
Как сходятся участники. Файлы, объявленные всеми участниками одной группы диспетчеризации, объединяются по имени. Одно имя, объявленное с идентичными байтами, — это один файл; одно имя, объявленное с разными байтами, или имя, которое записывает сама сборка провайдера, останавливает сборку с указанием файла и каждого участника — тот же отказ, что и при записи двумя участниками одного пути вывода. Поэтому конфигурация провайдера, нужная двум сущностям Recipes, записывается обеими под одним именем, а сборка проверяет, что они совпадают.
Кто его принимает. Имеет ли смысл файл, размещённый рядом с собранным выводом границы, — это свойство целевой системы провайдера, поэтому это собственное заявление провайдера, читаемое из его собственного объявления, как и его виды входных данных. Сущность Recipe, объявляющая этот блок для провайдера, который его не заявляет, отклоняется до какой-либо отрисовки. Таблица ниже содержит это заявление в последнем столбце; из провайдеров, распространяемых вместе с компилятором, его делает terraform.
Чем artifacts не являются
Три структурных различия:
Не межпровайдерные в пределах одной сущности 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 происходит через три механизма: 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: (выше); ни то ни другое не является видом входных данных.
Читайте каждый столбец отдельно. Строка показывает, какие виды провайдер отрисовывает, если брать их по одному. Она не говорит, что два отмеченных вида можно объявить вместе. Поскольку виды компонуются сложением, каждый объявленный вид диспетчеризуется и выводится отдельно, поэтому пара может быть отклонена по причине, которой нет ни в одном столбце, — чаще всего потому, что оба вида создают файл с одним и тем же именем. Какие комбинации каждый провайдер принимает на самом деле, описано текстом в разделе Что принимает каждый провайдер, полностью.
| Provider | source: + 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 не может сочетать источник с рабочей нагрузкой, и это не отказ по возможностям.
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:, который провайдер может отрисовать, не проводит рабочую нагрузку дальше. Остановка называет провайдера, вид, который он не может отрисовать, и виды, которые он отрисовывает:
[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 — идентификатор, который следует записать, когда эту остановку нужно надёжно обозначить: в шлюзе непрерывной интеграции, задаче или runbook; таблица всех условий разрешает его.
Почему compose не может сочетать источник с рабочей нагрузкой
Провайдер 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 и почему её пара разделителей отличается, описано в разделе Семантика артефактов для каждого Provider.