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

Общеизвестные аннотации

Providers считывают определённые аннотации, чтобы настроить контекст, специфичный для платформы, — заданные на границе сущности Release или в записи компонента сущности Release либо объявленные в сущности Aggregate на подсистеме или экземпляре компонента. Сам компилятор агностичен по отношению к значениям этих аннотаций — он передаёт их дальше как непрозрачные строки. Каждый провайдер объявляет, какие аннотации он считывает, в какой области действия и какое значение по умолчанию применяется, если аннотация отсутствует. Это объявление находится в поле spec.provider.wellKnownAnnotations сущности Plugin, выполняющей Provider-рендеринг, и оно намеренно узкое: провайдер указывает ключ, только если действительно его считывает. Провайдер, который не считывает ни одной из них, вместо этого объявляет spec.provider.readsNoWellKnownAnnotations: true.

Матрица поддержки в этой главе генерируется из этих объявлений с той степенью детализации, которую несёт объявление, — по каждому провайдеру для каждого вида входных данных, поскольку провайдер может считывать ключ, когда синтезирует единицу развёртывания, и не иметь возможности считать его, когда рендерит вендорный артефакт. Ориентируйтесь при написании на приведённую здесь матрицу: ячейка сообщает, что этот провайдер считывает на этом пути, поскольку ячейка не может сообщить ничего, что провайдер не объявил. Объявление, в котором указан вид входных данных, не рендерящийся согласно собственному контракту поведения рендеринга провайдера, отклоняется при чтении сущности Plugin, поэтому эти два утверждения не могут расходиться.

Зарезервированный словарь — более широкий набор, и он находится в двух других местах: в этой главе, где названы все зарезервированные ключи, включая те, которые не считывает ни один провайдер, и в наборе зарезервированных префиксов, который проверяет линтер публикации.

Инварианты

  1. Компилятор никогда не интерпретирует и не проверяет значение общеизвестной аннотации провайдера: он передаёт ключ и его значение через каскад и выдаёт предупреждение там, где цель не действует по этому ключу.
  2. Каждый провайдер документирует, какие аннотации он читает и какие значения по умолчанию применяет.
  3. Аннотации применяются единообразно в пределах границы. Если значение различается для разных компонентов, его следует задавать в аннотациях уровня компонента (переопределяющих аннотации границы) или в infra компонента.
  4. Общеизвестные аннотации Provider никогда не дублируют метки Component. Метки Component описывают, что представляет собой компонент. Аннотации границы описывают, куда развёртывается компонент.
  5. Сущности Recipes не обрабатывают общеизвестные аннотации провайдеров. Провайдер автоматически применяет контекст размещения (пространство имён, префикс реестра, сервисную учётную запись) после того, как Recipe сформирует своё содержимое.
  6. Префикс aggrega.ai/ зарезервирован для стандартной библиотеки. Собственные корпоративные аннотации используют свой префикс.
  7. Аннотации уровня Component в сущности Release переопределяют аннотации уровня границы (глубокое слияние, приоритет у компонента). Если провайдер собирает выходные данные нескольких границ в один артефакт, он может требовать, чтобы аннотация разрешалась одинаково для всех них: провайдер helm-chart берёт имя зонтичного чарта из aggrega.ai/chart-name, и если в один и тот же чарт вносят вклад несколько границ, которые разрешают эту аннотацию в разные значения, сборка останавливается с указанием расходящихся границ, поскольку у одного чарта не может быть двух имён.
  8. Аннотации, которые объявляет сущность Aggregate, достигают тех же ключей с более низким приоритетом, чем аннотации сущности Release. Ключ, объявленный на подсистеме или на экземпляре компонента — в самой сущности Aggregate или в импортируемом ею модуле, где он достигает собственных компонентов модуля, — применяется к компоненту везде, где сущность Release не задаёт значения для этого ключа; там, где сущность Release его задаёт, на границе или в записи компонента, применяется значение сущности Release. Собственные аннотации сущности каталога никогда его не задают. aggrega.ai/chart-name — исключение из охвата сущности Aggregate: он именует компоновку, а не компонент, и считывается с границ сущности Release, которые вносят в неё вклад.

Полная матрица аннотаций

Как читать эту матрицу

Шесть таблиц категорий ниже перечисляют все аннотации зарезервированного словаря aggrega.ai/, то, чем каждая управляет, и то, что делает провайдер, когда она отсутствует. Применяет ли конкретный провайдер конкретный ключ — вопрос более тонкий, поскольку провайдер отрисовывает более одного вида входных данных — внешний артефакт (sourced), Workload, который провайдер синтезирует сам (synthesized), или artifacts: сущности Recipe как весь вывод узла (artifacts-only), — и ключ может читаться на одном из этих путей, оставаясь недостижимым на другом. Какой провайдер отрисовывает какой вид входных данных, описано в ../../architecture/16-recipe-input-composition.md; что применяет каждый из них — в разделе Поддержка по провайдерам и видам входных данных ниже, который является авторитетным изложением этой страницы.

Каждая ячейка этой сетки относится к одному из трёх уровней:

  • Применяется — провайдер применяет ключ на этом виде входных данных, и отрисованный вывод в результате детерминированно меняется.
  • Применяется условно — компилятор выдаёт дополняющее переопределение рядом с целевым артефактом вместо редактирования самого артефакта, поэтому вступит ли значение в силу, зависит от того, предоставляет ли этот артефакт собственный соответствующий ключ. На практике это работает, но никогда не является гарантией. Ни один провайдер не реализует условную ячейку, и поверхность объявлений не позволяет её выразить, поэтому сгенерированная сетка ниже выдаёт только два других уровня. Уровень назван потому, что такой путь действительно существует для внешнего артефакта, а словарь из двух уровней вынудил бы матрицу либо заявлять гарантию, которую она дать не может, либо отрицать само существование этого пути.
  • Не применяется — ни один провайдер не применяет ключ на этом пути: у цели там нет слота отрисовки для него, поэтому механизм размещения ничего не вносит в отрисовываемое, а столбец По умолчанию таблицы категории указывает, что вы получаете вместо этого. Значение по-прежнему проходит через сборку как непрозрачная строка, без изменений. Уровень назван по механизму, а не по судьбе значения, потому что это разные вопросы и ячейка может ответить только на первый: то, что применяет провайдер, — свойство слотов отрисовки этой цели, и именно это утверждает объявление, стоящее за каждой ячейкой.

Есть две области действия, и лишь в одной из них вид входных данных является осмысленной осью:

  • На уровне узла — aggrega.ai/namespace, aggrega.ai/image-registry, aggrega.ai/image-pull-secret, aggrega.ai/service-account и aggrega.ai/kubernetes-version формируют собственный отрисованный вывод одного компонента, который производит путь, выбранный его видом входных данных. Это столбцы сетки.
  • На уровне сборки и ссылки — aggrega.ai/chart-name разрешается один раз при сборке umbrella-чарта, а три ключа aggrega.ai/aws-* разрешаются, когда ссылка пересекает границу. Ни для одного из них вид входных данных не является осью: значение читается при сборке или у ссылки, как бы ни был отрисован каждый участвующий узел. Для них есть отдельная таблица в разделе Ключи, разрешаемые для сборки и для ссылки.

Категория 1 — Размещение

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/namespacehelm (sourced, synthesized); compose (sourced, synthesized)Пространство имён Kubernetes (helm); имя сети Docker (compose)Не внедряется при отсутствии (helm); сеть, названная по пути файла compose и общая для всех узлов этого файла без аннотации (compose)
aggrega.ai/project-nameзарезервировано; ни один провайдер её не читаетЗарезервировано для имени проекта Docker Compose—
aggrega.ai/regionзарезервировано; ни один провайдер её не читаетЗарезервировано для облачного региона в области размещения—
aggrega.ai/account-idзарезервировано; ни один провайдер её не читаетЗарезервировано для идентификатора облачного аккаунта в области размещения—
aggrega.ai/kubernetes-versionhelm (sourced)Версия Kubernetes кластера, в который развёртывается компонент; чарт, отрисованный из исходников, читает её как .Capabilities.KubeVersionВерсия, для которой отрисовывает стандартный helm template того же выпуска helm: версия клиентской библиотеки Kubernetes, с которой собран провайдер

aggrega.ai/namespace намеренно двойного назначения. Она выражает одно и то же намерение логической изоляции — «ресурсы этой границы живут в собственной адресуемой области» — в родной форме каждой цели: metadata.namespace Kubernetes для helm, имя сети Docker для compose. Авторы сущностей Recipe задают одну аннотацию; каждый провайдер воплощает её подходящим для цели образом. В случае compose имя сети разрешается для каждого узла по аннотации на этом узле, а если узел аннотации не несёт — по пути файла compose, поэтому неаннотированные границы, разделяющие один файл compose, разделяют одну сеть, и разделяет их именно aggrega.ai/namespace. Какой бы из двух источников ни дал идентичность, она затем записывается символами, допустимыми в имени сети compose: любой другой символ записывается как экранирование, а не заменяется, поэтому две идентичности, хоть чем-то различающиеся, остаются в двух разных сетях, а регистр идентичности сохраняется таким, как задан. Справочник по провайдеру compose полностью описывает это выведение, включая то, как читать закодированное имя и чего стоит переименование.

aggrega.ai/kubernetes-version задаёт свойство кластера, в который развёртывается компонент, а не место компонента в нём: шаблоны чартов выбирают версию API, поле или целый механизм в зависимости от версии, для которой их отрисовывают, а у сборки нет кластера, который можно было бы спросить. Провайдер helm читает значение так же, как helm template --kube-version читает свой флаг, и останавливает сборку на значении, не являющемся версией; если версия не указана, чарт отрисовывается для той версии, для которой отрисовывает helm template того же выпуска helm. Справочник по провайдеру helm описывает допустимые формы и значение по умолчанию.

Категория 2 — Реестр

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/image-registryhelm, compose — только synthesizedПрефикс реестра для образов контейнеров, применяемый к каждой ссылке на образ синтезированного контейнераБез префикса
aggrega.ai/image-pull-secrethelm — только synthesizedИмя imagePullSecrets Kubernetes, объединяемое с существующими записями синтезированного подаНет

Категория 3 — Сеть

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/cluster-domainзарезервировано; ни один провайдер её не читаетЗарезервировано для DNS-суффикса для обнаружения сервисов между пространствами имён—
aggrega.ai/ingress-classзарезервировано; ни один провайдер её не читаетЗарезервировано для IngressClass Kubernetes на ресурсах Ingress—
aggrega.ai/service-meshзарезервировано; ни один провайдер её не читаетЗарезервировано для аннотаций внедрения sidecar сервисной сетки—

Категория 4 — Безопасность

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/service-accounthelm — только synthesizedServiceAccount Kubernetes для синтезированных подов; переопределяет workload.serviceAccount сущности Recipe, если заданы обаworkload.serviceAccount сущности Recipe или не задано, если Recipe его не объявляет
aggrega.ai/pod-security-standardзарезервировано; ни один провайдер её не читаетЗарезервировано для уровня Pod Security Standards—
aggrega.ai/iam-roleзарезервировано; ни один провайдер её не читаетЗарезервировано для облачной роли идентификации, привязанной к рабочей нагрузке—

Категория 5 — Упаковка

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/chart-namehelm-chart — для сборкиИмя umbrella-чартаИмя Aggregate и путь сборки зонтичного чарта, соединённые вместе, — см. Разрешение имени чарта
aggrega.ai/chart-versionзарезервировано; ни один провайдер её не читаетЗарезервировано для версии чарта Helm—
aggrega.ai/stack-nameзарезервировано; ни один провайдер её не читаетЗарезервировано для явно именованного стека—
aggrega.ai/tf-backendзарезервировано; ни один провайдер её не читаетЗарезервировано для идентификатора бэкенда состояния Terraform—

Категория 6 — облачная цель

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/aws-accountcloudformation — для каждой межграничной ссылкиУчётная запись AWS, в которую развёртывается стек (граница)Та же учётная запись — межстековая ссылка разрешается через импорт экспорта стека в пределах одной учётной записи
aggrega.ai/aws-regioncloudformation — для каждой межграничной ссылкиРегион AWS, в который развёртывается стек (граница)Тот же регион — межстековая ссылка разрешается через импорт экспорта стека в пределах одного региона
aggrega.ai/aws-assume-role-arncloudformation — для каждой межграничной ссылкиARN роли IAM, которую принимает межаккаунтное чтение стека, чтобы получить экспортированные значения соседнего стекаДля межаккаунтной ссылки роль не передаётся

Каждая граница CloudFormation рендерится в один стек. Когда ребро uses пересекает границу и ведёт в другую, провайдеру cloudformation нужно знать, где находится парный стек, чтобы сформировать ссылку: два стека в одном аккаунте и регионе обмениваются значениями через экспорт и импорт стека; парному стеку в другом аккаунте или регионе требуется межаккаунтное чтение выходных значений стека, при необходимости — от имени принятой роли. Эти аннотации несут такой контекст размещения. Каждая из них читается в тот момент, когда провайдер формирует такую ссылку, и разрешается в этот момент через обычный каскад аннотаций — значение, заданное на компоненте, имеет приоритет над значением, заданным на границе, а значение, заданное сущностью Release, — над значением, объявленным в сущности Aggregate. Поэтому значение на уровне границы — распространённый способ их задать, но не единственный. Это непрозрачные скалярные строки-указатели — провайдер передаёт их в создаваемую ссылку и никогда не разрешает их по живому состоянию AWS; аккаунт, регион и роль предоставляет сущность Release или объявляет сущность Aggregate, а итоговое физическое чтение разрешает среда выполнения. Если все аннотации отсутствуют, провайдер считает парный стек находящимся в том же аккаунте и том же регионе и не предоставляет роль.

Поддержка по провайдерам и видам входных данных

Ключи уровня узла для каждого провайдера и каждого вида входных данных. В заголовках столбцов опущен префикс aggrega.ai/, который есть у каждого ключа. applied и — обозначают уровни, определённые выше, причём — означает не применяется; n/a означает, что провайдер вообще не рендерит этот вид входных данных, поэтому там нет пути, на котором ключ мог бы быть применён или пропущен.

ProviderВид входных данныхnamespaceimage-registryimage-pull-secretservice-accountkubernetes-version
helmsourcedapplied———applied
helmsynthesizedappliedappliedappliedapplied—
helmartifacts-only—————
composesourcedapplied————
composesynthesizedappliedapplied———
composeartifacts-only—————
helm-chartsourced—————
helm-chartsynthesizedn/an/an/an/an/a
helm-chartartifacts-onlyn/an/an/an/an/a
terraformsourced—————
terraformsynthesizedn/an/an/an/an/a
terraformartifacts-only—————
cloudformationsourced—————
cloudformationsynthesizedn/an/an/an/an/a
cloudformationartifacts-only—————

Каждый провайдер, поставляемый с компилятором, имеет здесь строки, включая тот, что не читает ни одной аннотации размещения, — пустой набор строк было бы невозможно отличить от провайдера, которого ещё никто не описал. Провайдер, поставляемый отдельно, объявляет, что он читает, тем же способом и здесь не указан, поскольку опубликованная страница не может перечислить провайдеры, которых никогда не видела.

Recipe может объявлять сразу несколько видов входных данных — например, workload: вместе с artifacts:. Читайте таблицу по видам: синтезированный вывод такого узла соответствует строке synthesized, а его файлы артефактов — случаю артефактов. Строка artifacts-only — это вид входных данных, при котором Recipe объявляет artifacts: и ничего больше.

Чтобы это выяснить, обращаться к таблице не обязательно. Если задать ключ, который цель одного из ваших рендеров не читает ни на одном из видов входных данных этого рендера, выдаётся предупреждение с указанием ключа, цели и всех видов входных данных, объявленных этим рендером, — так ячейка, в которую вы попали случайно, проявляет себя в момент сборки, а не ждёт, пока вы догадаетесь заглянуть сюда:

warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored it

Для рендера, объявляющего несколько видов входных данных, предупреждение относится к рендеру целиком, а не к одной из его половин. Поскольку виды складываются, цель, читающая ключ хотя бы на одном из них, действительно его применяет, и вывод этого рендера содержит результат — поэтому предупреждение не выдаётся. Предупреждение появляется, только когда ключ пропускают все виды, объявленные рендером, и в нём перечислены они все:

warning: node "backend" (provider "helm"): target "helm" does not support annotation aggrega.ai/cluster-domain on sourced or synthesized input and ignored it

Таким образом, workload: вместе с source: достаточно, чтобы aggrega.ai/service-account подействовал на этом узле, и сборка об этом молчит — и это честный отчёт, поскольку значение доходит до синтезированной половины и появляется в выпущенных манифестах.

Читайте таблицу по рендерам, а не по компонентам. Функция, прикреплённая к узлу, генерирует свои ресурсы через цель, которую называет её собственный FeatureRecipe, на видах входных данных, которые этот FeatureRecipe объявляет, — поэтому она попадает в собственную строку таблицы, которая не обязана совпадать со строкой компонента-хозяина. Компонент, синтезирующий свой Workload, к которому прикреплённая функция добавляет artifacts:, читает строку synthesized для собственных манифестов компонента и строку artifacts-only для файлов прикрепления, и ключ, применённый в первом случае, может быть пропущен во втором. Предупреждение следует тому же разделению и сообщает о каждом отдельно, поскольку это разные файлы. Функция, прикреплённая к границе, а не к именованному компоненту, читает таблицу так же.

Значение по-прежнему проходит без изменений — сборка не останавливается, поскольку у границы, охватывающей компоненты на разнородных целях, всегда найдётся рендер, который не может обработать данный ключ, и это обычная сущность Release, а не ошибка. Аннотация границы распространяется каскадом, поэтому одна написанная строка даёт по одному предупреждению на каждый рендер, который не может её обработать, — так видно, какие части вывода затронуты. Предупреждение относится к классу unsupported-field и отключается флагом этого класса; подробности — в разделе Warnings. Два ограничения, о которых стоит знать: проверяются только голые ключи aggrega.ai/, поскольку ключ с подпрефиксом — ваш собственный словарь, а провайдер, не объявляющий никакой поддержки, предупреждений не выдаёт, поскольку написанное вами не с чем сравнить. Провайдер, объявляющий, что не читает ни одного из этих ключей, так не молчит: readsNoWellKnownAnnotations: true в его сущности Plugin — это заявление, не охватывающее ни одного ключа, поэтому каждый голый ключ, доходящий до одного из его рендеров, вызывает предупреждение. Провайдер terraform это объявляет.

Почему поставляемый артефакт применяет меньше ключей. Аннотация уровня узла применяется там, где у провайдера есть для неё слот рендеринга. Когда провайдер сам синтезирует единицу развёртывания, он владеет каждым полем результата, поэтому префиксу реестра, секрету для загрузки образов и сервисному аккаунту есть куда попасть. Поставляемый артефакт — Helm-чарт, файл compose, модуль Terraform — вместо этого имеет собственный интерфейс конфигурации, а компилятор этот интерфейс не читает, поэтому не может знать, каким собственным ключам артефакта соответствовали бы префикс реестра или сервисный аккаунт. Размещение, которым управляет окружающий вызов рендеринга, по-прежнему применяется, поэтому aggrega.ai/namespace применяется к чарту, отрендеренному из исходников. Размещение, которое означало бы решать, где внутри чужого артефакта должно находиться значение, не применяется, и автор задаёт его через собственные values этого артефакта. Поэтому строки sourced разрежены там, где строки synthesized заполнены, и такой же картины следует ожидать от любого ключа, добавленного позже.

Ключи, разрешаемые для каждой сборки и каждой ссылки

Четыре из поставляемых ключей не привязаны к узлу, поэтому они находятся вне приведённой выше таблицы, а не включены в неё: вид входных данных для них не является значимым измерением, и строка для каждого вида входных данных трижды повторила бы одну и ту же ячейку и подразумевала бы различие, которого нет. Каждый из них объявляет область действия границы, и таблица ниже сгенерирована из этих объявлений.

АннотацияПрименяется вНазначениеПо умолчанию
aggrega.ai/chart-namehelm-chartИмя собранного зонтичного Helm-чарта.Используются имя сущности Aggregate и путь сборки зонтичного чарта — его выходной каталог в dist/, например boundaries/data/helm-chart, — каждый из них кодируется, после чего они соединяются.
aggrega.ai/aws-accountcloudformationУчётная запись AWS, в которую развёртывается стек (граница). Межграничная ссылка считывает её, чтобы определить, находится ли стек-партнёр в той же учётной записи.Партнёр считается находящимся в той же учётной записи, и межстековая ссылка разрешается через импорт экспорта стека в пределах одной учётной записи, а не через чтение выходных значений стека из другой учётной записи.
aggrega.ai/aws-regioncloudformationРегион AWS, в который развёртывается стек (граница). Межграничная ссылка считывает его, чтобы определить, находится ли стек-партнёр в том же регионе.Партнёр считается находящимся в том же регионе, и межстековая ссылка разрешается через импорт экспорта стека в пределах одного региона.
aggrega.ai/aws-assume-role-arncloudformationARN роли IAM, которую принимает чтение стека из другой учётной записи, чтобы получить доступ к экспортированным значениям стека-партнёра.Роль не передаётся, и ссылка между учётными записями не содержит assume-role.

Когда разрешается каждый из них — этого само объявление не содержит. aggrega.ai/chart-name разрешается один раз для каждой сборки зонтичного чарта из каскада аннотаций границы; каждый участник одной сборки должен разрешить его в одно и то же значение, а расхождение останавливает сборку с указанием границ. Три ключа aggrega.ai/aws-* разрешаются для каждой межграничной ссылки с приоритетом компонента над границей, так что значение компонента имеет преимущество перед значением границы; категория 6 выше описывает ссылку, которую формирует каждый из них.

Зарезервированные имена, которые не читает ни один провайдер

Одиннадцать ключей в приведённой выше матрице помечены как зарезервированные; ни один провайдер их не читает: aggrega.ai/project-name, aggrega.ai/region, aggrega.ai/account-id, aggrega.ai/cluster-domain, aggrega.ai/ingress-class, aggrega.ai/service-mesh, aggrega.ai/pod-security-standard, aggrega.ai/iam-role, aggrega.ai/chart-version, aggrega.ai/stack-name и aggrega.ai/tf-backend.

Установка одного из них для сущности Release или в сущности Aggregate не влияет на результат рендеринга. Ни один провайдер их не читает, и никакое значение по умолчанию вместо них не применяется — в частности, для aggrega.ai/cluster-domain не применяется DNS-суффикс, поэтому Recipe, которому нужен домен кластера, должен передать его как обычное значение, а не полагаться на эту аннотацию. Автор Recipe, которому нужно одно из этих поведений, выражает его как значение Recipe или поле компонента infra.

Ни один провайдер не объявляет эти одиннадцать ключей. wellKnownAnnotations провайдера перечисляет только то, что он читает, поэтому ни один из одиннадцати там не появляется — читатель, открывший Plugin helm, helm-chart, compose или cloudformation, видит работающие ключи и ничего больше. В этом смысл узкого объявления: объявленный ключ — это работающий ключ, а область действия рядом с ним указывает, на каком пути.

Два зарезервированных имени близки к действующим ключам, но не взаимозаменяемы с ними. aggrega.ai/region и aggrega.ai/account-id обозначают регион и учётную запись в области размещения и не доходят ни до одного провайдера; ключи, которые читает провайдер cloudformation, — это aggrega.ai/aws-region и aggrega.ai/aws-account из облачного пространства имён в категории 6. Если вам нужен контекст межстекового размещения CloudFormation, используйте форму aws- — пара без префикса зарезервирована во избежание коллизий и ни к чему не подключена. Ещё два зарезервированных имени покрываются другими механизмами, а не аннотацией: aggrega.ai/stack-name зарезервирован, а имя стека, в который рендерится граница cloudformation, детерминированно выводится из идентичности релиза и границы; облачная роль идентичности рабочей нагрузки задаётся как обычное поле, устанавливаемое оператором, в сущности Feature, которая создаёт привязку, а не через aggrega.ai/iam-role.

Эти имена остаются зарезервированными и остаются перечисленными здесь, потому что префикс aggrega.ai/ зарезервирован: корпоративный каталог не должен повторно использовать один из этих ключей в своём значении, поскольку платформа удерживает этот ключ для собственного значения. Эта матрица и набор зарезервированных префиксов, проверяемый линтером публикации, вместе образуют реестр резервирования, и они поддерживаются в соответствии одному набору имён проверкой, которая читает оба и завершается с ошибкой при их расхождении. Поэтому указание одного из одиннадцати ключей не приводит ни к ошибке валидации, ни к срабатыванию правила «не использовать голый префикс aggrega.ai/» — оно просто не имеет эффекта.

Версия зонтичного чарта, которую создаёт граница helm-chart, всегда 0.1.0; это фиксированное значение, а не значение по умолчанию для aggrega.ai/chart-version.

Примечание: привязки features.annotations в сущности Manifest, использующие префикс aggrega.ai/, отклоняются при загрузке; префикс зарезервирован исключительно для общеизвестных аннотаций провайдеров, описанных в этой главе. Авторы привязок Feature на основе аннотаций используют feature.aggrega.ai/ для сокращений стандартной библиотеки или собственный домен для корпоративных сокращений.

Примечание: явное значение null в аннотации сущности Release удаляет унаследованную привязку из переопределяющей границы или компонента (отказ от Feature на основе аннотаций). Соседние компоненты в той же границе, которые не отказались, сохраняют унаследованную привязку; отсутствующие ключи по-прежнему наследуются из родительского каскада как обычно.

Аннотации, создаваемые в каталоге и читаемые компилятором

Всё описанное выше — это аннотации провайдеров: они задаются в сущности Release или объявляются в сущности Aggregate, передаются компилятором как непрозрачная строка и читаются провайдером. Второй, гораздо меньший словарь работает в обратном направлении: его ключи задаёт архитектор в собственных metadata.annotations сущности каталога, читает их компилятор, и провайдер их никогда не видит. Инвариант 1 выше относится к словарю провайдеров и на эти ключи не распространяется; компилятор читает ровно перечисленные здесь ключи и никакие другие.

Эти ключи находятся под подпрефиксом <scope>.aggrega.ai/, а не под голым префиксом aggrega.ai/, поэтому они не входят в реестр резервирования, который содержит матрица выше, и на них не распространяется правило зарезервированного префикса, которое проверка публикации применяет к ключам с голым префиксом.

АннотацияГде задаётсяКто читаетНазначение
features.aggrega.ai/requiredType.<label>metadata.annotations сущности Componentкомпилятор, по окончательному графуОбъявляет обязательное наличие: каждый экземпляр этой сущности Component должен иметь хотя бы одно подключение, тип которого совпадает со значением аннотации. <label> — выбираемый автором суффикс, который называет требование в диагностике; это не имя слота, и ничто его не разыменовывает. Чтобы объявить несколько требований, повторите ключ с разными метками.

Требование выполняется подключением на любом уровне — блоком features: уровня компонента или подсистемы, блоком уровня границы или компонента в сущности Release или развёртыванием по аннотациям, — поскольку проверяется итоговый набор подключений экземпляра, а не то, откуда пришло каждое подключение. Невыполненное требование останавливает сборку с указанием метки и требуемого типа; значение, не являющееся URI типа Feature, или ключ без метки после префикса останавливают сборку с отдельной диагностикой некорректного объявления. Полное описание создания и отличия такого требования от слота featuresSchema приведены в entities/component.md, раздел «Presence mandates».

Метки происхождения, выпускаемые провайдерами

Аннотации выше поступают в сборку: их задаёт сущность Release или сущность Aggregate, а провайдеры их потребляют. Providers также выпускают параллельный набор меток из сборки и прикрепляют их к отрендеренному выводу, чтобы инструменты ниже по цепочке могли сопоставить ресурсы времени выполнения с содержимым каталога, из которого они получены. Эти метки происхождения не задаются в сущности Release: они выводятся из собственного состояния сборки (идентичность Recipe, путь границы, имя агрегата, окружение, волна синхронизации, версия компилятора) и выпускаются провайдером во время рендеринга.

Набор, который создают провайдеры и который прикрепляется к каждому манифесту Kubernetes, отрисованному провайдером helm, к каждому загруженному через $import: артефакту, который провайдер helm-chart добавляет в подчарт, и к каждому сервису, создаваемому compose; собственные шаблоны подчарта helm-chart копируются в том виде, в каком их написал автор, поэтому они несут то, что написал этот автор:

МеткаИсточникВыпуск
app.kubernetes.io/nameID узла (или, для ресурса, который выпускает FeatureRecipe, идентификатор, выведенный для этого присоединения, — см. ниже)Только helm и helm-chart — стандартная метка Kubernetes, не выпускается для сервисов compose
aggrega.ai/component-idID узла (или, для ресурса, который выпускает FeatureRecipe, идентификатор, выведенный для этого присоединения, — см. ниже)Все три провайдера
aggrega.ai/recipe-uri<recipe-name>:<recipe-version> породившей сущности Recipe (или породившей сущности FeatureRecipe для ресурсов, выпущенных FR)Все три провайдера, если у породившей сущности заданы и имя, и версия; на helm и helm-chart — аннотация
aggrega.ai/boundary-pathПуть границы, в которую был направлен компонентВсе три провайдера, если путь границы не пуст; на helm и helm-chart — аннотация
aggrega.ai/aggregate-namemetadata.name сущности AggregateВсе три провайдера, если задано
aggrega.ai/compiler-versionВерсия компилятора, проставляемая во время сборкиВсе три провайдера, если задано
aggrega.ai/providerПровайдер, отрисовавший ресурсВсе три провайдера
aggrega.ai/provider-versionВерсия этого провайдераВсе три провайдера
aggrega.ai/environmentmetadata.environment сущности ReleaseВсе три провайдера — каждая сущность Release его объявляет
aggrega.ai/sync-waveЦелое число syncWave для каждой границыВсе три провайдера, если значение ненулевое; на helm и helm-chart — аннотация

Значения aggrega.ai/aggregate-name, aggrega.ai/environment, aggrega.ai/compiler-version, aggrega.ai/provider и aggrega.ai/provider-version берутся из строк, которые сборка не обязывает соответствовать правилам Kubernetes для значений меток, — сущность Aggregate с именем imported/flow, окружение с именем eu/prod, версия (devel) сборки для разработки. В helm и helm-chart каждая из этих меток несёт своё значение в написанном виде, если значение уже является допустимым значением метки: буквы, цифры, -, _ и ., буква или цифра на обоих концах, не более 63 символов. В противном случае метка несёт значение, переписанное в эту форму, — каждый прочий символ становится -, последовательности - схлопываются в один, концы обрезаются до буквы или цифры, а результат усекается до не более чем 63 символов, — а дословное значение добавляется как аннотация под тем же ключом. Поэтому сущность Aggregate с именем imported/flow получает метку aggrega.ai/aggregate-name: imported-flow и аннотацию aggrega.ai/aggregate-name: imported/flow; значение без единого символа, который сохраняет метка, передаётся только аннотацией. Селектор сопоставляет значение метки в том виде, в каком оно появляется в отрисованном выводе, а инструменты, которым нужно точное имя, читают аннотацию, если она есть. Compose, значения меток которого не ограничены, несёт дословное значение в качестве метки.

Особенности выпуска по провайдерам

  • helm — метки попадают в metadata.labels каждого отрисованного ресурса Kubernetes (Deployment, Service, PVC и т. д.), а ключи, которые не может содержать значение метки, — aggrega.ai/recipe-uri, aggrega.ai/boundary-path, aggrega.ai/sync-wave и дословное значение любой метки, переписанной так, как описано выше, — попадают в metadata.annotations. Пути режима с источником (отрисовка через Helm SDK с внедрением меток после отрисовки), синтезированного режима (синтез рабочей нагрузки) и artifacts: дают один и тот же набор.
  • helm-chart — те же метки и аннотации попадают на каждый загруженный через $import: артефакт, который провайдер добавляет в templates/ подчарта. Собственные шаблоны исходного чарта, а также артефакт со встроенным содержимым, размещённый в корне подчарта, не несут ни одной из них — см. helm-chart.md.
  • compose — метки попадают в services.<name>.labels каждого выпущенного сервиса compose. Режим с источником (внедрение меток после слияния в объединённый документ базы + valuesMapping) и синтезированный режим (синтез рабочей нагрузки, напрямую задающий блок меток сервиса) дают один и тот же набор. Специфичная для Kubernetes метка app.kubernetes.io/name в выходных данных compose опускается.

Для ресурсов, которые выпускает FeatureRecipe, значение aggrega.ai/component-id строится из присоединения, а не из имени компонента-хоста, — при любом способе, которым FeatureRecipe может доставить эти ресурсы, поэтому ресурсы присоединения никогда не неотличимы по метке от собственных ресурсов компонента-хоста. Получают ли эти ресурсы также имена по этой идентичности, зависит от способа доставки: рабочая нагрузка, которую синтезирует Aggrega, именуется по идентичности, тогда как чарт или фрагмент, предоставленный автором присоединения, сохраняет имя релиза Helm и префикс выходного файла компонента-хоста, потому что собственные шаблоны автора отрисовываются с этим именем. Способ составления значения — два варианта начала, части и их соединение через --, запись символа, который метка не может содержать, сокращение значения, слишком длинного для своей цели, и то, для каких имён оно служит основой, а для каких нет, — не зависит от провайдера, поэтому он изложен один раз в vocabulary/labels-and-annotations.md, раздел «Provenance labels emitted on rendered output», а не повторяется здесь. Эта страница отвечает за другую половину: куда в отрисованном результате каждого провайдера попадают метки.

aggrega.ai/recipe-uri разрешается в собственное name:version сущности FeatureRecipe, а не в идентичность потребляющей сущности Recipe, — последующие инструменты, читающие метку для определения породившей сущности, получают корректное происхождение как для вывода, выпущенного компонентом, так и для вывода, выпущенного FR.

Аннотации sync-wave

Приведённый выше ключ aggrega.ai/sync-wave дополняется аннотацией sync-wave, которую внешние инструменты читают, чтобы упорядочить то, что они применяют. В compose этот ключ является меткой, которая делает значение волны доступным для запросов по селекторам; в helm и helm-chart это аннотация, а парная аннотация помещает значение туда, где каждый инструмент по соглашению его читает.

АннотацияВыпускКем используется
argocd.argoproj.io/sync-wavehelm — на каждом ресурсе Kubernetes, который он отрисовывает, и helm-chart — на каждом артефакте, загруженном через $import:, — где syncWave в соответствующей границе не равен нулюУпорядочивание по sync-wave в ArgoCD
helm.sh/hook-weightТолько helm, на манифестах из шаблонов чарта, которые уже содержат аннотацию helm.sh/hook, когда syncWave не равен нулюУпорядочивание по hook-weight в Helm внутри фазы хука

Вывод helm.sh/hook-weight зависит от пути

Тонкость, о которой стоит предупредить авторов чартов: helm.sh/hook-weight выводится только в манифестах, отрисованных через путь шаблонизации чарта, — каталог templates/ чарта, отрисованный через Helm SDK. Manifests, созданные через путь артефактов — в провайдере helm это каждая запись блока artifacts: сущности Recipe, будь то встроенное содержимое или загруженное через $import:, а в helm-chart — запись, загруженная через $import:, — несут аннотацию argocd.argoproj.io/sync-wave и полный набор меток происхождения, но не получают helm.sh/hook-weight — даже если артефакт несёт аннотацию helm.sh/hook.

Это различие структурное: helm.sh/hook и helm.sh/hook-weight — примитивы упорядочивания среды выполнения Helm, применяемые к ресурсам-хукам из шаблонов чарта. Артефакты автора сущности Recipe — это дополнительные ресурсы, объявленные на уровне Recipe; по умолчанию они не участвуют в жизненном цикле хуков Helm.

Если вам нужно упорядочивание по hook-weight в Helm для ресурса-хука, опишите ресурс как шаблон чарта в каталоге source: сущности Recipe, которую отрисовывает провайдер helm, а не как запись artifacts:; шаблоны подчарта helm-chart копируются как написаны и не получают ни одной из этих аннотаций. Шаблон чарта получит и argocd.argoproj.io/sync-wave, и helm.sh/hook-weight, соответствующие значению syncWave соответствующей границы.

Примеры написания

Размещение и конфигурация реестра на уровне границы:

release.yaml
spec:
boundaries:
production:
annotations:
aggrega.ai/namespace: prod-east
aggrega.ai/image-registry: registry.corp.com
aggrega.ai/image-pull-secret: corp-registry-creds
components:
api: {}
worker: {}

Переопределение для отдельного компонента (компонент имеет приоритет над границей для одного и того же ключа аннотации):

release.yaml
spec:
boundaries:
production:
annotations:
aggrega.ai/namespace: prod-east
components:
api: {}
legacy-thing:
annotations:
aggrega.ai/namespace: legacy-east # override — this component deploys elsewhere

Каскад аннотаций на стороне Aggregate

Аннотации также задаются на авторской поверхности сущности Aggregate — в области подсистемы (spec.subsystems.<name>.annotations) и в области экземпляра компонента (spec.subsystems.<name>.components.<name>.annotations или spec.components.<name>.annotations для компонентов верхнего уровня). Каскад на стороне Aggregate передаёт аннотации, написанные разработчиком, вниз по дереву подсистем к содержащимся компонентам.

Правило каскада

Аннотация уровня подсистемы распространяется на каждую вложенную подсистему и каждый содержащийся компонент в поддереве подсистемы. Аннотации более близкого уровня переопределяют аннотации внешнего уровня с гранулярностью по ключу: аннотация уровня компонента переопределяет любую унаследованную аннотацию уровня подсистемы для того же ключа, не затрагивая соседние ключи и соседние компоненты.

Ключ аннотации в области находится в одном из трёх состояний:

  • Отсутствующий ключ — область не объявляет значения для этой аннотации. Вложенные подсистемы и содержащиеся компоненты наследуют любую привязку от области-предка.
  • Строковое значение — область объявляет значение. Вложенные подсистемы и содержащиеся компоненты наследуют это значение, если не объявляют собственное значение и не отказываются от него.
  • Явный YAML null — область удаляет из своего поддерева любую унаследованную привязку для этого ключа. Соседние компоненты и соседние подсистемы сохраняют своё независимое наследование; привязку теряет только поддерево отказавшейся области.
spec:
subsystems:
data:
annotations:
feature.myco/db-pool: "shared-pool" # propagates to api and worker
components:
api:
# inherits feature.myco/db-pool: "shared-pool"
worker:
annotations:
feature.myco/db-pool: null # opts out for this component only
special:
annotations:
feature.myco/db-pool: "vip-pool" # closer-level override

Аннотации сущности Provider, объявленные в сущности Aggregate

Ключи из приведённой выше матрицы каскадно распространяются и через сущность Aggregate, а провайдер применяет то, что каскад оставляет на каждом компоненте. aggrega.ai/namespace подсистемы размещает каждый компонент под ней; собственное значение экземпляра компонента вместо этого размещает этот компонент. Модуль, который импортирует сущность Aggregate, несёт собственный каскад: его подсистемы и экземпляры компонентов достигают собственных компонентов модуля, и ничто из объявленного импортирующей сущностью Aggregate не проникает внутрь модуля.

Сущность Release стоит выше сущности Aggregate по каждому ключу. Там, где сущность Release задаёт ключ для компонента — на его границе или в собственной записи компонента, — применяется значение из Release; там, где не задаёт никакого, — значение из Aggregate. Обе стороны накладываются ключ за ключом, поэтому сущность Release, задающая только aggrega.ai/namespace, оставляет в силе aggrega.ai/image-registry, объявленный сущностью Aggregate.

Явный null в сущности Release отзывает только собственное значение Release. Запись компонента с aggrega.ai/namespace: null убирает пространство имён, которое передала бы ему граница его сущности Release, и тогда компонент получает значение, объявленное его сущностью Aggregate, — или никакого, если сущность Aggregate тоже ничего не объявляет. Сущность Release не может убрать значение, объявленное сущностью Aggregate; она может лишь задать поверх него собственное.

# Aggregate
spec:
subsystems:
billing:
annotations:
aggrega.ai/namespace: billing # api and worker render into billing
components:
api:
type: core/server:1.0.0
worker:
type: core/server:1.0.0
annotations:
aggrega.ai/namespace: billing-batch # worker renders into billing-batch
# Release
spec:
boundaries:
production:
components:
api:
annotations:
aggrega.ai/namespace: prod-billing # the Release's value wins: api renders into prod-billing
worker: {}

aggrega.ai/chart-name — единственный ключ вне этой области действия: он задаёт имя зонтичного чарта, собранного из нескольких компонентов, поэтому читается из границ Release, вносящих вклад в этот чарт, и никогда — из аннотаций компонента.

Шаблон сущности Recipe или FeatureRecipe читает корзины аннотаций по имени — .context.annotations.aggregate, .context.annotations.release и .context.annotations.catalog каждая содержит то, что записала соответствующая сторона, — поэтому шаблон, читающий ключ размещения из одной корзины, видит только значение этой стороны.

Разделение по сторонам и опорам

Инвариант «Aggregate как авторская поверхность» ограничивает аннотации на стороне Aggregate опорой values. Привязка аннотации в сущности Manifest объявляет пути маршрутизации либо в maps.infra (маршрутизация на стороне Release), либо в maps.values (маршрутизация на стороне Aggregate); аннотация на стороне Aggregate, привязка которой объявляет только пути maps.infra, останавливает сборку с понятной диагностикой, называющей ключ аннотации, опору маршрутизации и авторскую сторону. Симметричное правило действует для стороны Release: аннотации на стороне Release могут маршрутизироваться только через maps.infra; аннотация на стороне Release для привязки только к values вызывает аналогичную ошибку. Каждая диагностика относится к домену документа, в котором было написано значение аннотации, — [DEVELOPER_ERROR] для Aggregate, [OPS_ERROR] для Release, — так что заголовок называет поверхность, которую нужно открыть.

Привязки, объявляющие пути в обеих опорах, на каждом проходе маршрутизируют совместимое со стороной подмножество: аннотация на стороне Aggregate задействует только пути опоры values, а аннотация на стороне Release — только пути опоры infra. Межсторонняя композиция — values из Aggregate, infra из Release — даёт одно прикрепление Feature на каждую пару (Component, Feature) с заполненными обеими опорами и с происхождением по листьям, фиксирующим, какая сторона внесла каждый лист.

Пример — аннотация подсистемы маршрутизируется в values

# Manifest binding
spec:
mappings:
features:
type:
core/db-pool: db-pool-helm:1.0.0
annotations:
feature.myco/db-pool:
feature: core/db-pool:1.0.0
maps:
values:
- pool # routes to values.pool
# Aggregate
spec:
subsystems:
data:
annotations:
feature.myco/db-pool: "shared-pool"
components:
api:
type: core/server:1.0.0
worker:
type: core/server:1.0.0

После раскрытия аннотаций и api, и worker несут синтетическое прикрепление Feature feature.myco/db-pool, поле values.pool которого содержит "shared-pool". Граф сборки (aggrega validate --release <release> --ir-graph) записывает каждый лист с origin: annotation, side: aggregate и annotation_source: aggregate.yaml:subsystems.data.annotations.feature.myco/db-pool.

Структурированные значения аннотаций

Для сущности Feature с несколькими настраиваемыми полями удобно иметь один ключ аннотации, который несёт значения сразу для нескольких из них. Структурированная форма аннотации позволяет одному ключу маршрутизироваться в несколько путей привязки в одном объявлении:

# Aggregate Subsystem — Developer's intent for db-pool (values-pillar subkeys)
subsystems:
data:
annotations:
feature.myco/db-pool:
db_name: "prod-db"
read_replicas: 5
# Release Boundary — Operator's sizing for db-pool (infra-pillar subkeys)
boundaries:
prod:
annotations:
feature.myco/db-pool:
pool_size: 20
max_connections: 100

Привязка в Manifest объявляет маршрутизацию всех четырёх подключей в списках maps:, сгруппированных по опорам:

# Manifest
spec:
mappings:
features:
annotations:
feature.myco/db-pool:
feature: core/db-pool:1.0.0
maps:
values:
- db_name
- read_replicas
infra:
- pool_size
- max_connections

Значение аннотации имеет одну из трёх форм:

  • Скалярная строка — одно значение. Привязка должна объявлять ровно один путь в сумме; скаляр маршрутизируется в этот путь.
  • Структурированный объект — отображение подключей на подзначения. Путь каждого подключа должен присутствовать в списке maps.infra или maps.values привязки; подзначение маршрутизируется в указанное поле схемы Feature в объявленной опоре.
  • Явный YAML null — целиком отказывается от унаследованной привязки для этой области каскада.

Каждый подключ внутри структурированного значения разрешается по списку maps привязки независимо. Подключ, отсутствующий и в maps.infra, и в maps.values, останавливает сборку с понятной ошибкой, называющей проблемный подключ и объявленные пути.

Каскадное слияние структурированных значений

Структурированные аннотации каскадируются с глубоким слиянием по подключам. Аннотация дочерней области каскада сливается с аннотацией родителя по каждому подключу; более близкий уровень переопределяет родительский с гранулярностью подключа:

subsystems:
data:
annotations:
feature.myco/db-pool:
db_name: "data-default"
read_replicas: 3
components:
api:
annotations:
feature.myco/db-pool:
db_name: "api-override" # overrides parent at this subkey only
# read_replicas not listed → inherits 3 from parent
analytics:
annotations:
feature.myco/db-pool:
read_replicas: null # per-subkey opt-out: removes inherited subkey
# db_name not listed → inherits "data-default" from parent

Итоговые аннотации после каскада:

  • Component api: { db_name: "api-override", read_replicas: 3 }
  • Component analytics: { db_name: "data-default" } — для read_replicas выполнен отказ от наследования на этой области

Дочерний уровень каскада, значение которого скалярное (при структурированном родителе), заменяет значение целиком, а не сливается с ним. Несовпадения формы между уровнями каскада разрешаются в пользу значения более близкого уровня; компилятор не выдаёт предупреждений о несовпадении формы.

null для всего значения и null для подключа

Каскад предоставляет два механизма отказа с разной гранулярностью:

# Whole-value null — opts out wholesale at this scope
components:
api:
annotations:
feature.myco/db-pool: null

Вся привязка аннотации подавляется на этом компоненте; синтетическое присоединение Feature из этого ключа аннотации в этой области не синтезируется. Соседние компоненты сохраняют унаследованную привязку.

# Per-subkey null — opts out just one subkey
components:
api:
annotations:
feature.myco/db-pool:
db_name: "api-db"
read_replicas: null

Аннотация продолжает вносить вклад в этой области, но подключ read_replicas подавляется. Остальные подключи (объявленные в этой области или унаследованные от родительских уровней каскада) сохраняются.

Рекомендация для авторов: используйте null для всего значения, чтобы отключить присоединение Feature, порождаемое аннотацией, в некоторой области. Используйте null для подключа, когда вы хотите сохранить большую часть вклада аннотации, но подавить одно или несколько конкретных полей.

Разделение по стороне и опоре для каждого подключа

Инвариант «Aggregate как поверхность авторинга» применяется к каждому подключу, когда значение аннотации структурировано. Опора каждого подключа (согласно объявлению maps привязки) должна быть совместима со стороной авторинга:

  • Аннотация на стороне Aggregate может содержать только подключи, маршрутизируемые в maps.values.
  • Аннотация на стороне Release может содержать только подключи, маршрутизируемые в maps.infra.

Подключ, маршрутизируемый в несовместимую опору, останавливает сборку с понятной ошибкой, указывающей конкретный подключ и опору. Цепочка ошибок собирает все несовместимые подключи аннотации до остановки — операторы видят все проблемы за один цикл сборки, а не исправляют и пересобирают раз за разом.

Проверка типов для каждого подключа

Значение каждого подключа во время выполнения проверяется на соответствие типу, объявленному в spec.schema целевой Feature в маршрутизируемой опоре. Поддерживаемые объявленные типы: string, integer, number, boolean, object, array, null. Подзначение, тип YAML которого не совпадает с объявленным в схеме типом, останавливает сборку с понятной ошибкой, называющей подключ, фактический тип и объявленный тип.

Сопоставление типов строгое — без приведения. Строка "20" для поля схемы с целочисленным типом останавливает сборку; авторы правильно объявляют типы в схеме Feature или используют скалярные аннотации, которые передаются как строки.

Рычаг авторинга для строгой проверки. Свойства без объявленного type в spec.schema сущности Feature принимают значение любой формы во время выполнения, включая вложенные отображения. Когда схема не объявляет ограничение, сборка его не придумывает. Авторы, которым нужна строгая проверка типов для каждого подключа, объявляют type у каждого свойства в spec.schema. Последующий слой рендеринга FeatureRecipe обрабатывает любую форму, которую несёт вклад аннотации.

Межсторонняя композиция

Когда аннотация на стороне Aggregate (подключи values) и аннотация на стороне Release (подключи infra) нацелены на одно и то же присоединение Feature в одной и той же сущности Component, сборка сливает вклады в одно присоединение Feature с заполненными обеими опорами. Происхождение на уровне листьев фиксирует источник каждого подключа — синтезированное присоединение содержит values.db_name с атрибуцией месту авторинга в Aggregate и infra.pool_size с атрибуцией месту авторинга в Release.

Шаблон межсторонней композиции — каноническая форма авторинга для Features со смешанными полями намерений разработчика и размеров от оператора: Aggregate объявляет смысловые решения (какая база данных, сколько реплик на уровне приложения); Release объявляет физические размеры (насколько велик пул, сколько соединений на уровне инфраструктуры). Одна привязка в Manifest связывает их единым набором объявлений maps.

  • Архитектура Provider — архитектура плагинов-провайдеров и роль Plugin, отвечающего за рендеринг провайдера.
  • ../entities/release.md — поверхность авторинга сущности Release, где находятся аннотации границ и компонентов.
  • ../entities/aggregate.md — поверхность авторинга сущности Aggregate, где находятся аннотации подсистем и уровня компонентов.
  • ../entities/manifest.md — карта mappings.features.annotations сущности Manifest, в которой привязки аннотаций объявляют свою маршрутизацию maps:.
  • ../../architecture/11-governance-and-compliance.md — проставление сведений о происхождении во время компиляции, дополняющее аннотации, которыми управляет автор.