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