Философия экосистемы
Философия экосистемы
Архитектура Aggrega опирается на ключевые принципы проектирования, которые уравновешивают гибкость и предсказуемость. Благодаря чётким границам и стандартизированным контрактам принципиально универсальный компилятор может бесшовно оркестрировать всё: от стандартной cloud-native инфраструктуры до узкоспециализированного искусственного интеллекта.
1. Базовая механика: физика архитектуры
- Разделение ответственности (закон Конвея): разработчики не пишут код физической инфраструктуры, а Ops не прописывают жёстко логику приложения. Руководящие принципы архитектуры делят написание на границы Domain-Driven — разделение, которое компилятор не навязывает (см. инвариант 7).
- Позднее связывание (инверсия зависимостей): разработчики запрашивают абстрактные интерфейсы (например,
type: enterprise-agent), а не конкретные реализации (например,helm-chart-v2). Сущность Manifest во время компиляции сопоставляет интерфейс с правильной реализацией, что делает возможными настоящие развёртывания на несколько целей из одного исходного файла. - Чистота AOT (без обращения к работающему облаку): Компилятор агностичен по отношению к работающему облаку. Во время компиляции он никогда не проходит аутентификацию в API инфраструктуры и не получает текущие IP-адреса. Он полностью работает на основе инверсии управления, сопоставляя детерминированные указатели и заранее передавая абстрактные контракты внедрения, чтобы среда выполнения могла безопасно разрешить итоговые физические соединения.
2. Опыт разработчика: намерение и абстракция
- Семантический опыт разработчика (стандарт карты из 5 ключевых слов): чтобы избежать когнитивного трения, разработчики используют ровно пять общепонятных ключевых слов в топологии YAML на основе карт:
parameters: глобальный контракт окружения (например, передача динамических размеров дисков).values: основная полезная нагрузка когнитивной/бизнес-логики (принадлежит разработчикам).uses: явно объявленные сетевые рёбра и зависимости (принадлежат разработчикам).infra: физический след и механическое определение размеров (принадлежат Ops, запрещены в сущности Aggregate).inject: строгий контракт доставки, сопоставляющий локальные переменные с целевыми ключами provides (env,file,arg). Этот механизм расширяем.
- Терминология, не зависящая от возможностей: чтобы реалии нижележащей инфраструктуры (например, термин Kubernetes
namespace) не просачивались в опыт разработчика, платформа использует универсальные понятия, такие какboundaries. - Явное намерение и «громкое ограждение» (никакой инфраструктуры-призрака): компилятор никогда не должен выдумывать вычислительные ресурсы или функции, которые разработчик явно не объявил. Использование движка политик для незаметного внедрения прокси безопасности создаёт «инфраструктуру-призрак»: когда она ломается, разработчик в итоге отлаживает прокси, которого нет в его YAML. Вместо незаметного изменения архитектуры плагины политик Wasm действуют строго как громкие ограждения. Если топология нарушает безопасность, компилятор останавливает сборку и возвращает очень конкретную ошибку (например, «Ошибка: данные PII передаются поставщику моделей через AI-шлюз
router. Вы должны явно подключить к нему функциюcore/data-masking»), вынуждая разработчика исправить собственный единый источник истины.
3. Компилятор без собственного мнения: обработка и оркестрация
- Программируемые политики (компилятор без собственного мнения): Основной компилятор на Go — это нейтральный к содержимому вычислительный механизм. Он разбирает YAML, обходит графы и вычисляет пересечения меток. Настоящий «интеллект» (например, требование, чтобы трафик моделей, несущий данные ограниченного доступа, проходил через AI-шлюз, маскирующий конфиденциальный текст) программируется предприятием динамически с помощью подключаемых сокетов WebAssembly (Wasm) для мутаций абстрактного синтаксического дерева (AST)—изменения разобранного представления конфигурации в памяти—и для проверки политик.
- Агностичность по отношению к схемам (словарь с открытым исходным кодом): Основной компилятор агностичен по отношению к физическим уровням выполнения. В нём нет жёстко заданных схем для Helm, Terraform или Docker Compose. Вместо этого блок
sourceсущности Recipe для Ops — это открытый словарь, ключи которого определяет провайдер и которые попадают в шаблоны сущности Recipe как.source.*. Ядро разрешает загружаемый источник по встроенной форме{ kind, url, version }(виды:helm-oci-chart,helm-https-chart,compose-https-fragment,git-repository), что уже отделяет компилятор от облачных языков, которыми он оперирует. Модель загрузки см. в справочнике поsourceсущности Recipe. - Явная оркестрация сущностей Plugin: основной компилятор Go действует строго как нейтральный построитель графов и никогда не угадывает, как обработать узел. Вместо этого весь доменный интеллект явно оркестрируется через выделенные сокеты WebAssembly (Wasm) на двух отдельных уровнях.
1. Глобальные сокеты: корпоративные политики и форматирование оцениваются явно зарегистрированными сокетами компилятора (например, ролью управления
label-transformдля автоматической разметки метаданных, ролью управления, выносящей вердикты по топологической безопасности, и сокетом рендерера для окончательной генерации артефактов). 2. Конвейеры реализации: логику мутаций, специфичную для сущности Component, оркестрируетManifest; когда он сопоставляет абстрактный интерфейс с конкретнымRecipe, эта реализация явно объявляет последовательный массивpipelineплагинов Wasm для выполнения. Компилятор лишь передаёт не зависящий от возможностей граф промежуточного представления (IR) в эти определённые сокеты, гарантируя, что вся предметно-специфичная логика остаётся строго версионируемой в экосистеме, а не жёстко зашитой в ядро компилятора. - Плоская компиляция и атомарность сущностей Feature: Aggrega не управляет состоянием, не опрашивает конечные точки и не ждёт завершения выкатки. Компилятор вычисляет вложенные модули и сводит их к плоскому одномерному графу промежуточного представления (IR), прежде чем передать данные плагинам рендеринга Wasm. Важно, что хотя граф уплощается, компилятор сохраняет атомарность сущностей Feature. Если функция прокси самостоятельно объявляет сетевое ребро к защищённому хранилищу, компилятор фиксирует семантическое происхождение этого ребра, гарантируя, что движки политик Wasm могут выполнять поиск за $O(1)$, не приписывая ошибочно соединение родительскому компоненту. Наконец, для поддержки временной последовательности каждая граница в сущности Release несёт значение
syncWave: <integer>; каждый плагин рендеринга переводит волну каждой границы в то средство, которым его собственная цель выражает порядок (аннотацию порядка выполнения, которую читает нижестоящий контроллер GitOps, или зависимость между сервисами файла, который он генерирует), тогда как цель, вообще не имеющая средства упорядочивания, записывает волну, не упорядочивая по ней.
4. Семантическая онтология: идентификация и таксономия
- Операционная cloud-native онтология: чтобы плагины Wasm с открытым исходным кодом и корпоративные политики могли универсально взаимодействовать, метка
component.aggrega.ai/typeсопоставляется исключительно с закрытым набором универсальных облачных примитивов (server,worker,task,function,stateful-server,resource). Это собственный ключ Aggrega: опубликованная схема сущности Component перечисляет принимаемые им значения, а документ с любым другим значением отклоняется при загрузке. Именно централизованная фиксация этого словаря гарантирует, что автономные движки политик и созданные сообществом плагины рендеринга Wasm читают одно и то же слово для одной и той же формы, когда встречают сущность Component, которую не писал ни один из их авторов. Компилятор при этом ничего не выводит из строки: он сопоставляет значение с селектором и ничего не выделяет по собственной инициативе; закрытый набор обеспечивает то, что селектор каждого сопоставляет один и тот же словарь. - Классификация по оси, которую Aggrega не определяет: закрытый набор охватывает только этот один зарезервированный ключ. Каталог, которому нужна собственная классификация (уровень, зона данных, класс сервиса, более мелкое деление примитивов), определяет собственный ключ метки рядом с зарезервированным, поскольку схема сущности Component принимает любой дополнительный ключ метки со строковым значением, а каждая поверхность селекторов читает его одинаково. Расширение происходит в вашем ключе, а не внутри ключа Aggrega, и именно это позволяет корпоративному словарю расти без дрейфа общего.
- Утиная типизация (семантические признаки через метки): если базовые типы чисто cloud-native, весь когнитивный, операционный и комплаенс-интеллект наслаивается полностью через семантическую утиную типизацию. Метки, созданные Platform Architect (например,
model.aggrega.ai/capability: generative,compliance.aggrega.ai/data-class: restricted), служат подлинной идентичностью узла. Сущности Features динамически привязываются к компонентам на основе этих селекторов меток.
5. Корпоративное управление: схемы и наследование
-
Строгое разделение API и корпоративная обнаруживаемость: в соответствии со стандартами Kubernetes все определения полезной нагрузки единообразно размещаются в блоке
spec:. Идентичность ресурса, характеризующие метки и явные инструкции для компилятора размещаются строго в блокеmetadata:. Чтобы гарантировать строгое разрешение, каждый общий артефакт YAML строго требует строки SemVerversion, проверяемой регулярным выражением. Кроме того, для поддержки обнаруживаемости в реестрах OCI и управления жизненным циклом блокmetadataподдерживает необязательный корпоративный набор метаданных. Этот набор включаетdescription, структурированный массив объектовmaintainers(name, email, url),license,repository,home(URL документации) иkeywords(для поискового индексирования). Окончание жизненного цикла управляется вне документа:aggrega deprecateприкрепляет к уже опубликованному артефакту подписанную отметку об устаревании — уровень серьёзности, причину и необязательную замену, — не изменяя его опубликованных байтов. -
Расширяемость схем (паттерн CRD в Kubernetes): чтобы не обновлять схему основного компилятора для каждой новой AI- или инфраструктурной функции, платформа использует JSON Schema 2020-12 для валидации конфигураций. Platform Architects пишут строгие типы, логику валидации и значения по умолчанию непосредственно в блоке
schema:компонентов каталога, обычно в компактной форме — сокращённой записи в виде YAML, умещающей ограничения каждого поля в одну строку (port: { type: integer, min: 1, max: 65535, default: 8080 }) и компилируемой в JSON Schema 2020-12 перед запуском валидации. Полный YAML в JSON Schema остаётся равноправным вариантом для схем, которым нужен его полный словарь. Каталоги, выросшие настолько, что выигрывают от повторного использования схем между сущностями Component, выносят общие формы (блоки проб, лимиты ресурсов, формы именованных портов) в выделенную сущность SchemaLibrary и ссылаются на них через ключевое слово JSON Schema$ref:. -
Наследование схем (базовые линии полезной нагрузки): чтобы базовую линию определяли только один раз, платформа делит наследование на два отдельных уровня. Стандартные метаданные YAML (включая семантические метки), сопоставления
Manifestи конфигурацииReleaseиспользуют традиционные стратегии слияния, чтобы допускать необходимые переопределения для окружений. Схемы полезной нагрузки (schema:) так не сливаются, и два вида каталога здесь расходятся:schema:сущности Feature компонуется со схемой её базы по семантике композиции JSON Schema 2020-12 и обходится при загрузке рабочего пространства механизмом слияния, который помечает происхождение по позиции в исходном файле, так что каждый лист слитой схемы несёт свой исходный файл; расширяющая сущность Component вообще не определяет содержимого полезной нагрузки: она записывает буквальный маркерschema: inheritedи получает блок своей базы точно таким, каким его определила база, на любой глубине цепочки. Поэтому базовая линия сущности Component гарантирована конструкцией, а не политикой: контракт потомка просто является контрактом базы, так что потомку нечего ослаблять. Вместо этого такая сущность Component компонует структуру (свои слоты присоединения, сокеты топологии, список разрешённого самовнедрения и именованныеassertions), а потомок, которому нужно более строгое правило, чем объявляет его база, выражает его как дополнительную записьassertions:, которую правила базы сохраняют рядом с собой, а не заменяются ею. Более широкая топологическая безопасность и управление метками по-прежнему надлежащим образом делегированы сокету управления Wasm. -
Паритет интерфейсов и автоматическая реализация: чтобы Ops не приходилось дублировать YAML сущностей Recipe, когда архитектор порождает слегка изменённый вариант базовой сущности Component, сущность Recipe, написанная для базы, обслуживает каждую сущность Component, которая её расширяет, на любой глубине цепочки. Расширяющая сущность Component пишет
schema: inherited, поэтому не добавляет вvalues/infra/providesни одного корневого ключа, который сущность Recipe базы не смогла бы обработать. Сущность Manifest по-прежнему сопоставляет расширяющий тип собственной записью, и проверка сопоставления принимает эту запись, еслиimplementsсопоставленной сущности Recipe называет этот тип или любую базу, которую он расширяет (см. Сущность Recipe, написанная для базы, обслуживает всё, что её расширяет). Трекер инфраструктуры-призрака (выдающий предупреждения, когда ни один шаблон, объявленный привязанной сущностью Recipe, не читает заданный ключ, чтобы предотвратить «инфраструктуру-призрак») — соответствующее ограждение на этапе рендеринга. -
Сопоставление версий в
implements: полеimplementsв сущностях Recipes и FeatureRecipes поддерживает три формы, чтобы сбалансировать строгость и гибкость экосистемы:- Точная версия:
implements: "core/api-server:1.0.0"— совпадает только с1.0.0. Для сущностей Recipes, тесно связанных с конкретной версией схемы. - Совместимая по мажорной версии (диапазон SemVer):
implements: "core/api-server:^1.0.0"— совпадает с>=1.0.0, <2.0.0. Предназначена для сущностей Recipes, которые полагаются на гарантии совместимости SemVer сущности Component: минорные и патч-обновления считаются обратно совместимыми согласно SemVer, а компилятор проверяет, что версия сущности Component удовлетворяет диапазону. - Без версии:
implements: "core/api-server"— совпадает с любой версией. Для сущностей Recipes, действительно не зависящих от версии (например, универсальной сущности Recipe для worker, которая использует только.context.inject.envи никаких специфичных для версии полейvalues).
implementsникогда не выбирает сущность Recipe: сущность Manifest называет Recipe для каждого типа компонента, а компилятор проверяет, чтоimplementsсопоставленной сущности Recipe принимает этот тип в одной из трёх форм, и останавливается при несовпадении. По этому же объявлению компилятор предлагает подходящие сущности Recipes, когда у типа компонента нет сопоставления.Паттерн из трёх форм позволяет сущностям Recipes объявлять контракт версии, соответствующий их фактической связи со схемой сущности Component. Сущности Recipes, тесно привязанные к конкретной версии схемы, закрепляют её точно; сущности Recipes, полагающиеся на гарантии совместимости SemVer сущности Component, используют диапазон, совместимый по мажорной версии; сущности Recipes, поведение которых совсем не зависит от версии сущности Component, остаются без версии. В результате минорные обновления версии сущности Component не вынуждают Ops ни закреплять версии сущностей Component, ни поддерживать параллельные сущности Recipes для каждой версии.
- Точная версия: