MySQL — один Aggregate, две целевые платформы
Этот компактный пример компилирует одну базу данных MySQL из написанных разработчиком Aggregates для двух целевых платформ:
- Kubernetes — через синтез Workload в провайдере helm (StatefulSet,
отрендеренный непосредственно на официальном образе
mysql, без внешнего чарта), и - Docker Compose — для локальной разработки.
Одно и то же намерение разработчика управляет каждой целевой платформой. Для каждой платформы меняется только слой Recipe, выбранный в Manifest.
Файлы
| Файл | Роль |
|---|---|
aggregate-helm-synth.yaml | Намерение разработчика для базового варианта Kubernetes: один компонент db типа core/datastore/mysql, его значения и только обязательные учётные данные root_password. |
aggregate-helm-synth-auth.yaml | Намерение разработчика для полного варианта Kubernetes: оба слота учётных данных — root_password и user_password. |
manifest-helm-synth.yaml | Сопоставляет тип MySQL с синтезированной helm-сущностью Recipe (helm/mysql), а каждые учётные данные — с их FeatureRecipe (env-secret, k8s-secret-from-parameter). |
release-helm-synth.yaml | Запись оператора для базового варианта Kubernetes с эксплуатационными размерами (engine_version, storage). |
release-helm-synth-auth.yaml | Запись оператора для полного варианта Kubernetes. |
aggregate.yaml | Намерение разработчика для локальной платформы Compose: тот же компонент db, оба слота учётных данных которого передаются как учётные данные inject-value. |
manifest-compose.yaml | Сопоставляет тип MySQL с сущностью Recipe для Compose (mysql), а учётные данные — с dotenv-secret. |
release-compose.yaml | Запись оператора для локальной платформы Compose, включающая специфичную для провайдера запись infra.overrides, которая закрепляет точный образ контейнера. |
Что демонстрирует пример
- Одна поверхность описания, много целевых платформ. Aggregate — источник истины о том, что представляет собой стек. Каждый Manifest описывает, как его реализовать.
- Синтез Workload в Kubernetes (предпочтительный). Сущность Recipe
helm/mysqlобъявляет независимый от возможностейWorkloadсform: stateful; провайдер helm синтезирует StatefulSet, ClusterIP Service, Headless Service (стабильную сетевую идентичность StatefulSet) и volumeClaimTemplate для каталога данных. Окружение контейнера содержитMYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORDиMYSQL_PASSWORD. Кодировка и правило сортировки передаются как аргументы командной строки сервераmysqld(--character-set-server,--collation-server), поскольку официальный образmysqlпринимает их как флаги сервера, а не как переменные окружения. - Синтез Workload в Compose. Сущность Recipe для Compose объявляет
независимый от возможностей
Workload; провайдер compose синтезирует сервисdocker-compose.yamlс образом MySQL, его окружением, именованным томом данных и проверкой работоспособности. - Запасной выход для оператора. Релиз Compose задаёт
infra.overrides.image— открытую опору для специфичных для провайдера фактов, которые собственная схема Component не называет, и отрендеренный сервис запускает именно эту ссылку на образ. См. Переопределения, специфичные для Provider. - Модель учётных данных с двумя слотами. Пароли — это вложения в опоре
features:компонента, каждое из которых является сущностью Feature с меткойfeature.aggrega.ai/kind: secretи хранится отдельно от прикладныхvalues.featuresSchemaсущности Component объявляет слот Black-Boxroot_passwordи прозрачный слотuser_password.
Передача учётных данных в Kubernetes
root_password — слот Black-Box (inject: []): передачей управляет Recipe.
Прикреплённые учётные данные inject-value помещают значение в канал inject
компонента, а Recipe считывает его как
.context.inject.env.MYSQL_ROOT_PASSWORD, выдавая обычную переменную окружения контейнера. Secret
Kubernetes для него не создаётся.
user_password — прозрачный слот (inject: [env, file]). Полный
вариант прикрепляет ссылаемые учётные данные, которые материализуют Secret Kubernetes
и публикуют его идентичность; Recipe ссылается на слот через
containers.attachments, что синтезатор рендерит как env secretKeyRef.
Сгенерированный Secret и ссылка контейнера указывают на один и тот же ресурс, поскольку
оба считывают .features.user_password.provides.name. Оставить user_password
неприкреплённым (базовый вариант) тоже допустимо: Recipe возвращается к встроенному
значению по умолчанию для разработки (MYSQL_PASSWORD: apppass), и Secret не создаётся, поэтому
минимальное развёртывание по-прежнему рендерится и работает.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example mysql-standaloneЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd mysql-standaloneСборка
В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен; --auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне:
# Kubernetes — synthesized helm StatefulSet (base: root credential only)aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pullОтрендеренные артефакты помещаются в dist/.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочего пространства ещё нет папки `mysql-standalone`, вызовите инструмент `scaffold` один раз, задав для `example` значение `mysql-standalone`, без `dir`: он запишет пример в новую папку `mysql-standalone`. Затем вызовите инструмент `build` один раз для каждого файла Release в таком порядке — `release-helm-synth.yaml`, `release-helm-synth-auth.yaml` и `release-compose.yaml` — каждый раз задавая для `workspace_root` значение `mysql-standalone`, для `release` — этот файл, для `auto_pull` — true и для `write` — true. Сообщите, какие файлы записала каждая сборка; они находятся в `mysql-standalone/dist/`.Размеры, задаваемые оператором
Релизы Kubernetes заполняют опору эксплуатационных размеров для каждого окружения:
тег образа контейнера берётся из infra.engine_version (mysql:8.4), а
запрос и класс хранилища volumeClaimTemplate — из infra.storage.
Aggregate разработчика никогда не содержит этих полей.
Переопределения, специфичные для Provider
Опоры размеров — это именованные поля: Component объявляет engine_version и
storage, поэтому оператор, задающий любое из них, заполняет поле, предусмотренное
сущностью Component. infra.overrides — опора для того, что Component не может
предусмотреть: она объявлена как объект, принимающий любую вложенную структуру, и
каждая сущность Recipe документирует, какие ключи она считывает.
release-compose.yaml использует её. Recipe для Compose считывает один ключ, image, и,
если он задан, контейнер запускает именно эту ссылку вместо той, которую
Recipe составляет из engine_version:
infra: engine_version: "8.4" overrides: image: "registry.internal.example/library/mysql:8.4"Отрендеренный сервис содержит переопределение дословно:
services: db: image: registry.internal.example/library/mysql:8.4 [… omitted: the service's environment, labels, volume, network and health check]Это путь к сборке той же версии сервера из зеркала реестра или закреплённой по дайджесту —
факт развёртывания, который относится к целевому окружению, а не
к контракту Component. Поскольку набор ключей определяется для каждой Recipe, а не
для каждого Component, ключи, которые применяются, следует искать в Recipe: Recipe
для Compose здесь считывает image, а Recipe, не считывающая ни одного ключа, сообщает об этом.