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 — одно и то же значение:
нет ни повторного вывода, ни соглашения, о котором двум сторонам нужно договариваться.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example mariadb-bitnami-credential-setЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd mariadb-bitnami-credential-setСборка
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:
[… 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.