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

Композиция

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

Terminal window
aggrega scaffold --example module-boundary-routing

Затем она выводит команды, которые нужно выполнить дальше:

Terminal window
cd module-boundary-routing
aggrega 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:.