Обзор словаря
Небольшой набор ключевых слов повторяется во многих сущностях 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 от паник из-за нулевых указателей. - Опоры данных:
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 и разрешение версий.