Композиция
Эта страница объясняет одну идею, построение приложения из частей крупнее одного компонента, и не является запускаемым рабочим пространством. Маршрутизация модулей в границы — размещение целых подмодулей в границах показывает её в рабочем пространстве, которое вы собираете; запишите его в собственную папку командой:
aggrega scaffold --example module-boundary-routingЗатем она выводит команды, которые нужно выполнить дальше:
cd module-boundary-routingaggrega build --release release.yaml --auto-pullМодули: сущность Aggregate, импортированная другой
Сущность Aggregate может импортировать другую сущность Aggregate как модуль в aggregates:. Модуль сам компонует свои компоненты и соединяет свои рёбра, поэтому ничего из его внутреннего устройства не появляется в сущности Aggregate, которая его импортирует. Пример импортирует два модуля из каталога стандартной библиотеки, из aggregate.yaml:
spec: aggregates: metrics: type: core/thanos documents: type: core/ferretdbБлок exportedComponents модуля — это его публичный интерфейс: компоненты, к которым может подключиться что-то вне модуля, каждый под именем, под которым он экспортирован. core/ferretdb экспортирует свой компонент proxy как mongo, поэтому компонент импортирующей сущности Aggregate достигает его по пути с точкой documents.mongo:
uses: database: main: target: documents.mongoМодуль может объявлять собственные параметры, которые импортирующая сущность Aggregate заполняет в parameters: импорта.
Размещение модуля
Сущность Release размещает весь модуль в границе с помощью записи aggregates:, ключом которой служит имя модуля, и каждый компонент, который содержит модуль, перемещается вместе с ним. Она также может настраивать компоненты модуля, каждый по имени, которое он имеет внутри модуля. Из release.yaml, без комментариев:
spec: boundaries: observability: directory: observability annotations: aggrega.ai/namespace: observability aggregates: metrics: components: query: infra: compute: cpu: 500m memory: 1Gi data: directory: data annotations: aggrega.ai/namespace: data aggregates: documents: {}Собственные аннотации модуля достигают его собственных компонентов точно так же, как аннотации сущности Aggregate достигают её собственных, поэтому модуль может разместить свои компоненты в пространстве имён, которое он объявляет. Импортирующая сущность Aggregate не объявляет ничего, что проникает внутрь модуля; это делает сущность Release, и её значение побеждает для того же ключа.
Сервис, который сборка не развёртывает
Уже существующий сервер всё равно является узлом графа: он участвует в соединениях, в политике и в том, что получают его потребители, и для него ничего не развёртывается. Его сущность Manifest привязывает сущность Recipe, которая ничего не развёртывает, а сущность Release задаёт адрес. В примере Один контракт, три реализации сущность Manifest manifest-external.yaml привязывает core/datastore/postgres к helm/postgres-external, который выдаёт только ExternalName Service, а сущность Release предоставляет адрес, из release-external.yaml:
db: infra: overrides: host: postgres.data.example.netАдрес — это строка-указатель: сборка передаёт её дальше, не разрешая, и то, что отвечает по этому имени во время работы приложения, и есть то, к чему обращается приложение. Сущность Aggregate — один и тот же файл для всех трёх сущностей Releases примера.
Подсистемы: группировка внутри одной сущности Aggregate
Подсистема группирует компоненты внутри сущности Aggregate. Объявленные на ней аннотации достигают каждого компонента, который она содержит, а сущность Feature, присоединённая к ней, присоединяется к каждому из них:
spec: subsystems: billing: annotations: team.aggrega.ai/owner: billing-squad aggrega.ai/namespace: billing features: metrics: type: core/prometheus-exporter components: invoice-api: type: core/compute/server payment-worker: type: core/compute/workerСборка сглаживает дерево подсистем: invoice-api и payment-worker каждый несут присоединение metrics и обе аннотации, которые сущность Recipe читает как {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }}. aggrega.ai/namespace — это аннотация провайдера, поэтому она также размещает оба компонента в пространстве имён billing. Сущность Release настраивает infra присоединения в записи каждого компонента, по имени, которое дала ему подсистема, а пространство имён, заданное сущностью Release, переопределяет пространство имён подсистемы для охватываемых ею компонентов.
Присоединение, которое подключается к чему-то своему
Присоединение может нести собственный блок uses:, проводя ребро от присоединения, а не от компонента, на котором оно находится. В примере Хранилище данных с резервным копированием на каждой цели оператор присоединяет core/backup к базе данных и подключает присоединение к бакету, куда попадают резервные копии, из release-helm-velero.yaml:
spec: components: db: features: backup: type: core/backup infra: schedule: "30 2 * * *" retention_days: 14 uses: store: bucket: target: backupsСобственные соединения базы данных не меняются: ребро к backups принадлежит присоединению, записывается как проведённое им и проверяется политикой, как любое другое ребро. Операционная сущность Feature и сущность Feature учётных данных присоединяются так же, и любая из них может нести блок uses:.