Модель данных
Эта страница объясняет одну идею — кто пишет какие данные о компоненте — и не является запускаемым рабочим пространством. Один контракт, три реализации показывает её в рабочем пространстве, которое вы собираете; запишите его в собственную папку командой:
aggrega scaffold --example postgres-three-realizationsЗатем она выводит команды, которые нужно выполнить дальше:
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues и 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 settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500Gidirectory: границы наследуется, как и любая другая настройка, поэтому дочерняя сущность, унаследовавшая буквальный каталог, выполняет рендеринг в то же место, что и её база. Именно запись каталога через параметр направляет вывод каждой сущности Release в собственное место; см. Составная сущность Release и наследование через extends.
Сущность Manifest на основе другой
Сущность Manifest может точно так же расширять другую, и её записи заменяют запись базы для того же ключа. Сущность Manifest для разработки может сохранить все привязки сущности для продакшена и изменить способ реализации учётных данных: здесь вложение core/referenced-secret в продакшене извлекается из хранилища секретов, а при разработке записывается в Secret из значения, которое предоставляет автор.
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.yamlspec: 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 для базы данных, — которая также является папкой каталога, в которой находится сущность. Селектор, написанный для одной метки, никогда не срабатывает по другой.