Перейти до вмісту
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:.