Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

MariaDB (Bitnami-Chart) — ein einziges Zugangsdaten-Secret mit mehreren Schlüsseln

Eine einzelne MariaDB-Datenbank, realisiert durch das Bitnami-Helm-Chart, deren Passwörter von einem einzigen referenzierbaren Secret mit mehreren Schlüsseln (core/referenced-secret-set) geliefert werden.

Das Bitnami-Chart authentifiziert sich über ein einziges Kubernetes-Secret, das durch auth.existingSecret benannt wird, und erwartet, dass dieses Secret feste Datenschlüssel enthält — mariadb-root-password und, wenn ein eigener Benutzer festgelegt ist, mariadb-password (eine Bereitstellung mit Replikation ergänzt mariadb-replication-password). Es gibt keine Stellschraube, um diese Schlüssel umzubenennen; sie sind durch das Chart festgelegt.

Statt das Datenbank-Recipe den Namen des Secret erraten zu lassen, bindet der Entwickler Zugangsdaten mit mehreren Schlüsseln an, die genau diese festen Schlüssel enthalten, und das Recipe liest den Namen des erzeugten Secret aus .features.root_password.provides.name. Der Referenzname und das metadata.name des erzeugten Secret sind ein einziger Wert — es gibt keine erneute Ableitung und keine Konvention, auf die sich beide Seiten einigen müssten.

Das Beispiel generieren

Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.

Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:

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

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd mariadb-bitnami-credential-set

Build

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

--auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt.

Das Recipe mariadb-bitnami wird aus der eigenen lokalen Kopie von catalog/ dieses Beispiels aufgelöst — ein lokales, vom Unternehmen verfasstes Recipe mit Quelle —, während die Component core/datastore/mariadb und die Zugangsdaten-Funktionen aus hub.aggrega.ai aufgelöst werden, der Standard-Registry, die .aggrega-config.yaml benennt; das lokale catalog/ ist dort unter catalog_dirs aufgeführt. Das Bitnami-Chart wird aus seiner OCI-Quelle gezogen.

Mit einem KI-Assistenten

Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.

Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `mariadb-bitnami-credential-set` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `mariadb-bitnami-credential-set` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `mariadb-bitnami-credential-set`. Rufen Sie anschließend das Tool `build` mit `workspace_root` auf `mariadb-bitnami-credential-set`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Nennen Sie mir, welche Dateien der Build geschrieben hat; sie liegen unter `mariadb-bitnami-credential-set/dist/`.

Was die Zugangsdaten erzeugen

Die Komponente db bindet core/referenced-secret-set an ihren erforderlichen Slot root_password an und liefert die festen Schlüsselnamen des Charts als Daten. Das Manifest ordnet diese Zugangsdaten k8s-secret-set zu, das ein einziges Kubernetes-Secret materialisiert und dessen Namen als provides.name veröffentlicht:

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"

Was das Chart referenziert

Das Recipe mariadb-bitnami verdrahtet auth.existingSecret aus dem veröffentlichten Namen des Slots, sodass das gerenderte StatefulSet dasselbe Secret einhängt, das die Zugangsdaten erzeugt haben — beide Seiten lesen .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

Da auth.existingSecret gesetzt ist, erzeugt das Chart kein eigenes Secret — das einzige Secret im Build ist das von den Zugangsdaten erzeugte.

Das Gegenstück mit einem Schlüssel

core/referenced-secret (siehe das Beispiel credential-secretkeyref) ist das Mitglied derselben Familie mit einem einzigen Schlüssel: Es kapselt einen vom Aufrufer benannten Datenschlüssel und veröffentlicht sowohl den Ressourcennamen als auch diesen Schlüssel, für einen Konsumenten, der einen Schlüssel über secretKeyRef referenziert. Verwenden Sie stattdessen core/referenced-secret-set, wenn das konsumierende Ziel eine feste Menge von Schlüsseln aus einem Secret liest, das es als Ganzes benennt, wie es das Bitnami-Chart tut.