Перейти к содержимому
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 для базы данных, — которая также является папкой каталога, в которой находится сущность. Селектор, написанный для одной метки, никогда не срабатывает по другой.