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

MariaDB (чарт Bitnami) — один многоключевой Secret с учётными данными

Одна база данных MariaDB, реализованная Helm-чартом Bitnami, пароли которой предоставляются одним многоключевым ссылочным секретом (core/referenced-secret-set).

Чарт Bitnami выполняет аутентификацию по одному Kubernetes Secret, имя которого задаётся auth.existingSecret, и ожидает, что этот Secret содержит фиксированные ключи данных — mariadb-root-password и, если задан пользовательский пользователь, mariadb-password (развёртывание с репликацией добавляет mariadb-replication-password). Параметра для переименования этих ключей нет: они зафиксированы чартом.

Вместо того чтобы Recipe базы данных угадывал имя Secret, разработчик подключает многоключевые учётные данные, содержащие ровно эти фиксированные ключи, а Recipe считывает имя созданного Secret из .features.root_password.provides.name. Имя ссылки и metadata.name сгенерированного Secret — одно и то же значение: нет ни повторного вывода, ни соглашения, о котором двум сторонам нужно договариваться.

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

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

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

Terminal window
aggrega scaffold --example mariadb-bitnami-credential-set

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

Terminal window
cd mariadb-bitnami-credential-set

Сборка

Terminal window
aggrega build --release release.yaml --auto-pull

--auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне.

Recipe mariadb-bitnami разрешается из собственной локальной копии catalog/ этого примера — локального Recipe с исходниками, созданного предприятием, — тогда как Component core/datastore/mariadb и функции учётных данных разрешаются из hub.aggrega.ai — реестра по умолчанию, который указывает .aggrega-config.yaml; локальный catalog/ перечислен там в catalog_dirs. Чарт Bitnami загружается из своего источника OCI.

С ИИ-ассистентом

ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.

Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочего пространства ещё нет папки `mariadb-bitnami-credential-set`, вызовите инструмент `scaffold` один раз, задав для `example` значение `mariadb-bitnami-credential-set`, без `dir`: он запишет пример в новую папку `mariadb-bitnami-credential-set`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `mariadb-bitnami-credential-set`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите, какие файлы записала сборка; они находятся в `mariadb-bitnami-credential-set/dist/`.

Что создают учётные данные

Компонент db подключает core/referenced-secret-set к своему обязательному слоту root_password, передавая фиксированные имена ключей чарта в качестве данных. Manifest сопоставляет эти учётные данные с k8s-secret-set, который создаёт один Kubernetes Secret и публикует его имя как provides.name:

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-root-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
mariadb-root-password: "dev-root-pw-change-me"
mariadb-password: "dev-user-pw-change-me"

На что ссылается чарт

Recipe mariadb-bitnami задаёт auth.existingSecret из опубликованного имени слота, поэтому отрисованный StatefulSet монтирует тот же Secret, который создали учётные данные, — обе стороны читают .features.root_password.provides.name:

# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)
- name: mariadb-credentials
secret:
secretName: db-root-password # == the produced Secret's metadata.name
items:
- key: mariadb-root-password # a fixed key the chart reads
path: mariadb-root-password
- key: mariadb-password
path: mariadb-password

Поскольку auth.existingSecret задан, чарт не генерирует собственный Secret — единственный Secret в сборке — тот, который создали учётные данные.

Одноключевой аналог

core/referenced-secret (см. пример credential-secretkeyref) — это одноключевой член того же семейства: он оборачивает один ключ данных, названный вызывающей стороной, и публикует и имя ресурса, и этот ключ — для потребителя, который ссылается на один ключ через secretKeyRef. Используйте вместо него core/referenced-secret-set, когда потребляющая цель читает фиксированный набор ключей из одного Secret, указываемого ею целиком, как это делает чарт Bitnami.