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

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 подключает каждый так, как того требует его слот.

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

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

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

Terminal window
aggrega scaffold --example mariadb-helm-synth

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

Terminal window
cd mariadb-helm-synth

Сборка

Terminal window
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. Имя файла, в котором оно хранится, вычисляется отдельно и выглядит иначе: в нём перед именем стоят компонент и имя слота как собственные координаты вложения, закодированные для алфавита имён файлов, допускающего только строчные буквы и цифры, поэтому подчёркивание там представлено экранированием, а не дефисом.

db--user-zupassword--db-secret-db-user-password.yaml
[… 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 разработчика никогда не содержит этих полей.