Огляд словника
Невеликий набір ключових слів повторюється в сутностях Aggrega. Замість того щоб пояснювати їх заново на сторінці кожної сутності, розділи словника зосереджують пояснення в одному місці для кожної родини ключових слів. Кожна сутність, що приймає одне з цих ключових слів, робить це з тією самою семантикою, яку визначає цей набір розділів.
Словник поділяється на чотири родини: топологічна тріада (provides, inject, uses), яка з’єднує вузли явними топологічними ребрами й несе контракт ін’єкції, що його компілятор передає далі; стовпи даних (values, infra, parameters, locals), що розділяють чотири аспекти даних — намір розробника, фізичне розмірення, налаштування для окремих середовищ і приватний стан сутності Recipe; ключові слова успадкування та інтерфейсу (extends, implements), що компонують сутності каталогу та оголошують, яку сутність Component реалізує сутність Recipe; і система модифікаторів (appliesTo, appliesToAnyOf), яка визначає, до яких вузлів приєднується сутність Feature через селектори міток. Концептуальне пояснення того, як стовпи розділяють аспекти, наведено в ../architecture/06-data-taxonomy-and-composition.md; механіку розв’язання топології описано в ../architecture/07-dependency-resolution.md.
Довідка за темами
- Топологічна тріада:
provides,inject,uses— контракт ін’єкції та оголошення явних топологічних ребер. Охоплює компактний і розгорнутий синтаксис inject, форми каналів.context.inject/.context.uses, які читають шаблони, і двостанний контекст, що захищає Ops від паніки через nil-вказівник. - Стовпи даних:
values,infra,parameters,locals— чотири стовпи даних і їхні власники.valuesіparameters, якими володіють розробники,infra, яким володіє Ops, приватні для сутності Recipelocals, а також шаблон підняття параметрів для варіацій між середовищами. - Успадкування та інтерфейс:
extends,implements— успадкування сутностей каталогу черезextends(глибоке злиття YAML-обгортки, спільне для Components і Features, стовпи даних, які розширювальна сутність Component успадковує від базової повністю, і композиція JSON Schema 2020-12, якої зазнає схема сутності Feature) та оголошенняimplements, що пов’язує Recipe з Component (точна форма, форма з діапазоном версій і форма без версії), за яким перевіряється зіставлення в сутності Manifest;implementsніколи не вибирає сутність Recipe. - Система модифікаторів:
appliesToі селектори — селектори приєднання сутностей Feature, нативний рушій зіставлення міток на Go, граматика рядкової форми селекторів і варіантappliesToAnyOf, що компонує через OR. - Поза чотирма родинами: авторинг у компактній формі, міждокументні посилання, мітки та анотації, поверхня публікації, суспільні договори, поверхня валідації, композиція виводу, граматика URI і розв’язання версій.