Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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-Box root_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 не создаётся, поэтому минимальное развёртывание по-прежнему рендерится и работает.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example mysql-standalone

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd mysql-standalone

Сборка

В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен; --auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне:

Terminal window
# 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, не считывающая ни одного ключа, сообщает об этом.