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

Загальновідомі анотації

Providers зчитують певні анотації, щоб налаштувати контекст, специфічний для платформи, — задані на межі сутності Release чи в записі компонента сутності Release або оголошені в сутності Aggregate на підсистемі чи екземплярі компонента. Сам компілятор агностичний щодо значень цих анотацій — він передає їх далі як непрозорі рядки. Кожен провайдер оголошує, які анотації він зчитує, на якому рівні та яке значення за замовчуванням застосовується, коли анотація відсутня. Це оголошення розміщується в spec.provider.wellKnownAnnotations сутності Plugin, що рендерить провайдер, і воно навмисно вузьке: провайдер указує ключ лише там, де його зчитує. Провайдер, який не зчитує жодної з них, натомість оголошує 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/, те, чим вона керує, і те, що робить provider за її відсутності. Чи застосовує певний provider певний ключ — тонше питання, бо provider рендерить більше ніж один вид вхідних даних: вендорований артефакт (sourced), Workload, який provider синтезує сам (synthesized), або artifacts: сутності Recipe як увесь вихід вузла (artifacts-only), — і ключ може читатися на одному з цих шляхів, будучи недосяжним на іншому. Який provider рендерить який вид вхідних даних, описано в ../../architecture/16-recipe-input-composition.md; що застосовує кожен із них, описано в розділі Підтримка за provider і видом вхідних даних нижче, який є авторитетним твердженням цієї сторінки.

Кожна клітинка цієї сітки має один із трьох рівнів:

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

Є дві області дії, і лише для однієї з них вид вхідних даних є змістовною віссю:

  • На рівні вузла — 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, з якою зібрано provider

aggrega.ai/namespace навмисно має подвійне призначення. Вона виражає той самий намір логічної ізоляції — «ресурси цієї межі живуть у власній адресованій області» — у рідній формі кожної цілі: metadata.namespace Kubernetes для helm, ім’я мережі Docker для compose. Автори Recipe задають одну анотацію; кожен provider матеріалізує її відповідно до цілі. У випадку compose ім’я мережі розв’язується для кожного вузла з анотації на цьому вузлі, а якщо вузол не має анотації, використовується шлях файлу compose — тож межі без анотації, що спільно використовують один файл compose, спільно використовують одну мережу, а розділяє їх саме aggrega.ai/namespace. Хоч би що з цих двох дало ідентичність, далі її записують символами, які допускає ім’я мережі compose: кожен інший символ записується як екранована послідовність, а не замінюється, тож дві ідентичності, що хоч чимось відрізняються, залишаються у двох мережах, а регістр ідентичності зберігається таким, як його задано. Довідник provider compose повністю описує це виведення, зокрема як читати закодоване ім’я і чого коштує перейменування.

aggrega.ai/kubernetes-version задає властивість кластера, у який розгортається компонент, а не місце в ньому, куди компонент потрапляє: шаблони чартів обирають версію API, поле чи цілий механізм за версією, для якої їх рендерять, а збирання не має кластера, щоб запитати. Provider helm читає значення так само, як helm template --kube-version читає свій прапорець, і зупиняє збирання на значенні, яке не є версією; якщо версію не вказано, чарт рендериться для версії, для якої рендерить helm template того самого релізу helm. Довідник provider 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 і шлях збирання umbrella-чарта, об’єднані разом, — див. Розв’язання назви чарта
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 і вимикається прапорцем цього класу; подробиці — у розділі Попередження. Два обмеження, які варто знати: перевіряються лише голі ключі aggrega.ai/, бо ключ із підпрефіксом — ваш власний словник, а провайдер, що взагалі не оголошує підтримки, не дає попереджень, бо немає з чим порівняти написане вами. Провайдер, який оголошує, що не читає жодного з цих ключів, не мовчить у такий спосіб: readsNoWellKnownAnnotations: true у його сутності Plugin — це твердження, що не охоплює жодного ключа, тож кожен голий ключ, який доходить до одного з його рендерів, спричиняє попередження. Провайдер terraform це оголошує.

Чому вендорований артефакт застосовує менше ключів. Анотація з областю дії вузла застосовується там, де провайдер має для неї слот рендерингу. Коли провайдер сам синтезує одиницю розгортання, він володіє кожним полем результату, тож префікс реєстру, секрет для завантаження й обліковий запис служби мають куди потрапити. Вендорований артефакт — чарт Helm, файл compose, модуль Terraform — натомість має власний інтерфейс конфігурації, а компілятор цей інтерфейс не зчитує, тож не може знати, яким власним ключам артефакту відповідали б префікс реєстру чи обліковий запис служби. Розміщення, яке контролює зовнішній виклик рендерингу, усе одно застосовується, тому aggrega.ai/namespace застосовується до чарта, відрендереного з джерела. Розміщення, що вимагало б вирішувати, де всередині чужого артефакту має бути значення, — ні, і автор задає його через власні значення цього артефакту. Саме тому рядки 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. Режим із джерелом (вставлення міток після злиття в об’єднаний документ base + valuesMapping) і синтезований режим (синтез робочого навантаження, що безпосередньо задає блок labels сервісу) дають однаковий набір. Специфічна для 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.

Анотації хвиль синхронізації

Ключ aggrega.ai/sync-wave, описаний вище, супроводжується анотацією хвилі синхронізації, яку подальші інструменти зчитують, щоб упорядкувати те, що вони застосовують. У compose цей ключ є міткою, яка відкриває значення хвилі для запитів за селекторами; у helm і helm-chart це анотація, а парна анотація подає значення там, де кожен інструмент за домовленістю його читає.

АнотаціяДодаванняХто використовує
argocd.argoproj.io/sync-wavehelm — на кожному ресурсі Kubernetes, який він рендерить, і helm-chart — на кожному артефакті, завантаженому через $import:, — де syncWave має ненульове значення на відповідній межіВпорядкування за хвилями синхронізації в ArgoCD
helm.sh/hook-weightлише helm, на маніфестах, згенерованих шаблонами чарта, які вже мають анотацію helm.sh/hook, коли syncWave має ненульове значенняВпорядкування 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.

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

Шаблон сутності 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-as-Authoring-Surface застосовується до кожного підключа, коли значення анотації структуроване. Стовп кожного підключа (згідно з оголошенням 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 — опис проставлення походження під час компіляції, що доповнює анотації, які контролює автор.