Композиція
Ця сторінка пояснює одну ідею, побудову застосунку з частин, більших за один компонент, і не є робочим простором, який можна запустити. Маршрутизація модулів до меж — розміщення цілих підмодулів у межах показує її в робочому просторі, який ви збираєте; запишіть його у власну теку командою:
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:.