MariaDB в Kubernetes — синтезированный helm (StatefulSet), учётные данные в двух слотах
Одна база данных MariaDB, отрисованная в Kubernetes с помощью синтеза сущности Workload провайдером helm, — без внешнего чарта. Сущность Component core/datastore/mariadb связывается с сущностью Recipe
helm/mariadb, которая объявляет Workload form: stateful; провайдер helm
преобразует его в StatefulSet, ClusterIP Service, Headless
Service (стабильная сетевая идентичность StatefulSet) и
volumeClaimTemplate для каталога данных.
Цель примера — показать модель учётных данных MariaDB с двумя слотами на синтезированной цели helm. Два слота паролей доставляются разными механизмами, потому что Component объявляет их по-разному, а Recipe подключает каждый так, как того требует его слот.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example mariadb-helm-synthЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd mariadb-helm-synthСборка
aggrega build --release release.yaml --auto-pullКаталог разрешается из реестра hub, указанного в .aggrega-config.yaml, поэтому флаг --catalog не нужен, а --auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне. Четыре манифеста помещаются в dist/helm/helm/.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочего пространства ещё нет папки `mariadb-helm-synth`, вызовите инструмент `scaffold` один раз, задав для `example` значение `mariadb-helm-synth`, без `dir`: он запишет пример в новую папку `mariadb-helm-synth`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `mariadb-helm-synth`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите, какие файлы записала сборка; они находятся в `mariadb-helm-synth/dist/`.root_password — Black-Box, доставляется через канал inject
root_password — это слот Black-Box: featuresSchema сущности Component объявляет
inject: [], поэтому доставкой управляет Recipe, и разработчик не может её диктовать.
Aggregate подключает core/secret-value, который Manifest сопоставляет с
env-secret. Эта FeatureRecipe помещает значение в канал inject компонента
под выбранным ключом, а Recipe читает его как
.context.inject.env.MARIADB_ROOT_PASSWORD, выдавая обычную переменную окружения контейнера:
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meНа слот Black-Box никогда не ссылаются из блока attachments: контейнера рабочей нагрузки, и для него
не создаётся ресурс Kubernetes Secret — значение попадает в контейнер
напрямую через канал inject.
user_password — прозрачный, доставляется как Secret + secretKeyRef
user_password — это прозрачный слот (inject: [env, file]). Aggregate
подключает core/referenced-secret, который Manifest сопоставляет с
k8s-secret-from-parameter. Эта FeatureRecipe создаёт Kubernetes Secret
и публикует идентичность Secret как provides {name, key}. Recipe
ссылается на слот через containers.attachments, который синтезатор отрисовывает как
secretKeyRef переменной окружения. Созданный Secret и ссылка контейнера указывают на
один и тот же ресурс, потому что обе стороны читают .features.user_password.provides.name, — здесь
нет повторного вычисления и нет соглашения, о котором двум сторонам нужно договариваться. Опубликованное
имя заменяет подчёркивания в имени слота на дефисы, поэтому user_password
становится допустимым именем ресурса Kubernetes db-user-password. Имя файла, в котором
оно хранится, вычисляется отдельно и выглядит иначе: в нём перед именем стоят
компонент и имя слота как собственные координаты вложения, закодированные для
алфавита имён файлов, допускающего только строчные буквы и цифры, поэтому
подчёркивание там представлено экранированием, а не дефисом.
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data keyОставить user_password неподключённым тоже допустимо: Recipe использует
встроенное значение по умолчанию для разработки (MARIADB_PASSWORD: apppass), и Secret не
создаётся, поэтому минимальное развёртывание по-прежнему отрисовывается и работает.
Размеры, задаваемые оператором
release.yaml реализует принцип задания размеров оператором для каждого окружения: тег образа
контейнера берётся из infra.engine_version (mariadb:11.4), а
запрос и класс хранилища volumeClaimTemplate — из infra.storage
(5Gi, standard). Aggregate разработчика никогда не содержит этих полей.