Персоны
Авторская поверхность Aggrega разделена между четырьмя взаимодействующими ролями. У каждой роли своя область ответственности, свой темп изменений и свой набор видов сущностей, которые она обычно создаёт. Понимая, какую роль вы сейчас исполняете, вы знаете, какой файл открыть и какие опоры заполнить.
Это разделение — рекомендация, а не правило, которое обеспечивает компилятор. Ядро компилятора математически без собственного мнения: оно принимает любой шаблон авторства, проходящий валидацию по схеме. Вы можете объединять роли — автор-одиночка обычно исполняет все четыре — или пересекать границу, когда того требует ситуация. Роли существуют, чтобы снижать когнитивную нагрузку и чётко разделять ответственность, а не чтобы строить тюрьму. Архитектурное описание этого разделения см. в разделе Командные топологии и четыре домена.
Четыре роли
Разработчик
намерение приложения
Aggregate
Архитектор платформы
контракт каталога
Components
Features
Эксплуатация платформы
рецепты инфраструктуры
Recipes
FeatureRecipes
Plugins
для рендеринга под провайдеры
Оператор платформы
связывание для каждого окружения
Manifests
Releases
Кто обычно пишет какие файлы. Это разделение — рекомендация, а не правило, которое применяет компилятор: в небольшой команде или в проекте одного человека все файлы пишет один человек.
Разработчик — намерение приложения
Разработчик создаёт Aggregate: что представляет собой приложение и что ему нужно, выраженное как намерение. Разработчик говорит «мне нужна база данных такого размера и сервис, который её использует», а не «разверните экземпляр AWS RDS в этой подсети». Физическая инфраструктура намеренно оставлена каталогу и эксплуатации, поэтому сущность Aggregate остаётся агностичной по отношению к возможностям — одно и то же намерение компилируется для ноутбука, облака или корпоративного кластера без изменения файла разработчика.
Чем владеет разработчик: компонентами, которые объявляет сущность Aggregate, значениями values, которые она передаёт, сущностями Features, чьё поведение является намерением приложения (вместе с их values), параметрами parameters, которые она открывает для вариаций по окружениям, и рёбрами uses, связывающими компоненты.
Архитектор платформы — контракт каталога
Архитектор создаёт Components и Features: повторно используемые версионируемые контракты, которые потребляют разработчики. Сущность Component объявляет значения, которые может передать разработчик (в виде JSON Schema), выходные данные, которые она предоставляет потребителям, и сокеты, которые она открывает для связывания. Сущность Feature объявляет подключаемую возможность. Архитектор строит «мощёную дорогу» — торговый автомат, из которого заказывают разработчики, — и гарантирует, что выдаваемое им имеет правильную форму.
Чем владеет архитектор: схемой schema:, которая валидирует значения разработчика, выходами provides, сокетами usesSchema и метками, несущими семантическую идентичность. Архитекторы не пишут физическую инфраструктуру; они определяют интерфейс к ней.
Эксплуатация платформы — инфраструктурные рецепты
Эксплуатация создаёт Recipes, FeatureRecipes и рендерящие для провайдеров Plugins: специфичные для провайдера трансляции, превращающие контракт каталога в отрендеренную инфраструктуру. Сущность Recipe отображает объявленные значения сущности Component на конкретного провайдера — Helm, Docker Compose, Terraform — не меняя обращённых к разработчику значений, которые объявляет Component. Сущность FeatureRecipe делает то же для сущности Feature во время привязки.
Чем владеет эксплуатация: шаблонами, которые рендерят нативный для провайдера вывод из values разработчика и размеров infra, заданных оператором, и значениями provides, которые сущность Recipe передаёт потребителям. Инженеры эксплуатации повторно используют существующий инфраструктурный код, упаковывая его в Recipes; от них никогда не требуется изучать специфичный для каталога язык политик.
Оператор платформы — связывание развёртывания
Оператор создаёт Manifests и Releases: слой маршрутизации и входные данные компиляции для каждого окружения. Сущность Manifest сообщает компилятору, какая сущность Recipe реализует каждую сущность Component для заданной цели, так что одна и та же сущность Aggregate может попадать на разные реализации в разных окружениях. Сущность Release — единственные входные данные компиляции: она указывает на Aggregate и Manifest, заполняет параметры, открытые разработчиком, подключает сущности Features, чьи входные данные являются эксплуатационными, задаёт через infra размеры тех, что подключил разработчик, и связывает собственные рёбра в пределах сокетов, объявленных архитектором.
Чем владеет оператор: картой маршрутизации сущности Manifest, заполнением параметров в сущности Release, размерами infra, которые получает каждый компонент, подключениями сущностей Features, чьи входные данные являются эксплуатационными, и infra для каждого ребра, которое сущность Release записывает на соединении. Оператор заполняет открытые разработчиком точки вариации; сущность Release не может вводить новые значения приложения или новые вычислительные ресурсы — они приходят только из сущности Aggregate.
Роли — это шляпы, а не штатные единицы
В крупном предприятии эти четыре роли — отдельные подразделения с разной экспертизой и разной частотой изменений: каталог развивается, когда команда платформы выпускает новую возможность, Recipes — когда меняется инфраструктура, Releases меняются с каждым развёртыванием. В небольшой команде или проекте одиночки один человек носит все шляпы. Поскольку Components и Recipes — это разделяемые версионируемые артефакты, автор часто может оставаться исключительно в роли разработчика и использовать готовый каталог для всего остального.
Далее прочитайте Сущности по ролям, где приведено полное соответствие видов и ролей, включая виды библиотек и плагинов, поддерживающие все четыре роли.