Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Модель даних

Ця сторінка пояснює одну ідею, а саме хто пише які дані про компонент, і не є робочим простором, який можна запустити. Один контракт, три реалізації показує її в робочому просторі, який ви збираєте; запишіть його у власну теку командою:

Terminal window
aggrega scaffold --example postgres-three-realizations

Потім вона виводить команди, які слід виконати далі:

Terminal window
cd postgres-three-realizations
aggrega build --release release-selfhosted.yaml --auto-pull
aggrega build --release release-managed.yaml --auto-pull
aggrega build --release release-managed-dns.yaml --auto-pull
aggrega build --release release-external.yaml --auto-pull

values і infra: два простори імен, два автори

Сутність Component оголошує два окремі набори налаштувань. Її values належать розробникові й записуються в сутності Aggregate: те, що потрібно застосунку, однакове в кожному середовищі. Її infra належать операторові й записуються в сутності Release: розмір і розміщення, які відрізняються від одного середовища до іншого. Схеми тримають їх окремо — схема Aggregate не має infra на компоненті, а схема Release не має values, — тож жоден автор не може задати поля іншого. Сутність Recipe отримує обидва набори як два окремі об’єкти, .values і .infra.

У прикладі розробник називає базу даних і її роль для входу, з aggregate.yaml:

spec:
components:
db:
type: core/datastore/postgres
values:
database: appdb
user: appuser

а сутність Release, яка збирає керований екземпляр, задає його розмір, з release-managed.yaml без коментарів:

spec:
boundaries:
stack:
directory: stack
components:
db:
infra:
engine_version: "16"
storage:
size: 100Gi
type: gp3
ha:
enabled: true
read_replicas: 0

Дві інші сутності Releases у прикладі збирають ту саму сутність Aggregate у кластері та для сервера, що вже існує, кожна з власними infra; сутність Aggregate не змінюється.

Значення, яке все ж має змінюватися залежно від середовища, піднімається: сутність Aggregate оголошує параметр, записує його у значення, і кожна сутність Release заповнює цей параметр (див. Файли збирання).

Сутність Release, побудована на іншій

Сутність Release може назвати іншу сутність Release своєю базою за допомогою extends: і змінити лише те, що відрізняється. Дочірня сутність успадковує межі бази, її розміщення та параметри, а оголошення aggregate: поряд із extends: схема Release відхиляє, бо дочірня сутність мусить збирати ту саму сутність Aggregate, що і її база. Вона може назвати власну сутність Manifest або пропустити manifest: і успадкувати Manifest бази.

# release-prod.yaml: the base gives every other setting
spec:
extends: ./release-base.yaml
boundaries:
stack:
components:
db:
infra:
storage:
size: 500Gi

directory: межі успадковується, як і будь-яке інше налаштування, тож дочірня сутність, що успадковує буквальний каталог, рендериться в те саме місце, що й її база. Саме запис каталогу через параметр спрямовує вивід кожної сутності Release у власне місце; див. Складена сутність Release і успадкування через extends.

Сутність Manifest, побудована на іншій

Сутність Manifest може так само розширювати іншу, і її записи замінюють запис бази для того самого ключа. Сутність Manifest для розробки може зберегти всі прив’язки сутності для продакшну й змінити спосіб реалізації облікових даних: тут вкладення core/referenced-secret у продакшні отримується зі сховища секретів, а в розробці записується в Secret зі значення, яке надає автор.

manifest-prod.yaml
spec:
mappings:
components:
type:
core/datastore/postgres:1.0.0: helm/postgres:1.0.0
features:
type:
core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0
---
# manifest-dev.yaml
spec:
extends: ./manifest-prod.yaml
mappings:
features:
type:
core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0

Обидві реалізації публікують ім’я Secret однаково, тож компонент, що читає облікові дані, рендерить те саме посилання з будь-якою з двох сутностей Manifest; Один намір розробника, дві форми доставлення облікових даних збирає обидві й порівнює їх.

Дві мітки: тип і категорія

Кожна сутність Component має одне значення із закритої множини в зарезервованій мітці component.aggrega.ai/type: server, довготривала кінцева точка; worker, фоновий споживач; stateful-server, щось, що зберігає власні стійкі дані; task, що виконується до завершення; function, подієво-керована функція; і resource, керований хмарний ресурс, що не виконує власних обчислень. Значення розміщується в сутності каталогу, ніколи не в екземплярі в сутності Aggregate.

Тип визначає, як інфраструктура має поводитися з компонентом, а не для чого цей компонент. Брокер повідомлень, що тримає власний диск, є stateful-server точно так само, як і база даних: core/messaging/kafka і core/datastore/postgres мають той самий тип. Читач переглядає за іншою міткою, component.aggrega.ai/category — messaging для брокера, datastore для бази даних, — яка також є текою каталогу, у якій розміщено сутність. Селектор, написаний для однієї мітки, ніколи не збігається з іншою.