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

MariaDB auf Kubernetes — synthetisiertes helm (StatefulSet), Zugangsdaten mit zwei Slots

Eine einzelne MariaDB-Datenbank, auf Kubernetes durch die Workload-Synthese des helm-Providers gerendert — kein externes Chart. Die Component core/datastore/mariadb bindet sich an das Recipe helm/mariadb, das eine Workload mit form: stateful deklariert; der helm-Provider übersetzt sie in ein StatefulSet, einen ClusterIP-Service, einen Headless-Service (die stabile Netzwerkidentität des StatefulSet) und ein volumeClaimTemplate für das Datenverzeichnis.

Der Zweck des Beispiels ist das Zugangsdatenmodell mit zwei Slots von MariaDB auf dem synthetisierten helm-Ziel. Die beiden Passwort-Slots werden über unterschiedliche Mechanismen zugestellt, weil die Component sie unterschiedlich deklariert, und das Recipe verdrahtet jeden so, wie sein Slot es verlangt.

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-helm-synth

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

Terminal window
cd mariadb-helm-synth

Build

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

Der Katalog wird aus der in .aggrega-config.yaml benannten Hub-Registry aufgelöst, daher ist kein Flag --catalog nötig, und --auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt. Vier Manifeste landen unter dist/helm/helm/.

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-helm-synth` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `mariadb-helm-synth` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `mariadb-helm-synth`. Rufen Sie anschließend das Tool `build` mit `workspace_root` auf `mariadb-helm-synth`, `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-helm-synth/dist/`.

root_password — Black-Box, zugestellt über den Inject-Kanal

root_password ist ein Black-Box-Slot: Das featuresSchema der Component deklariert inject: [], daher steuert das Recipe die Zustellung, und der Entwickler kann sie nicht vorgeben. Das Aggregate bindet core/secret-value an, das das Manifest env-secret zuordnet. Dieses FeatureRecipe legt den Wert unter dem gewählten Schlüssel in den Inject-Kanal der Komponente, und das Recipe liest ihn als .context.inject.env.MARIADB_ROOT_PASSWORD und gibt eine einfache Umgebungsvariable des Containers aus:

# db-statefulset.yaml (container env)
- name: MARIADB_ROOT_PASSWORD
value: dev-root-pw-change-me

Ein Black-Box-Slot wird nie aus dem Block attachments: eines Arbeitslast-Containers referenziert, und für ihn wird keine Secret-Ressource von Kubernetes erzeugt — der Wert erreicht den Container direkt über den Inject-Kanal.

user_password — transparent, zugestellt als Secret + secretKeyRef

user_password ist ein transparenter Slot (inject: [env, file]). Das Aggregate bindet core/referenced-secret an, das das Manifest k8s-secret-from-parameter zuordnet. Dieses FeatureRecipe materialisiert ein Kubernetes-Secret und veröffentlicht die Identität des Secret als provides {name, key}. Das Recipe referenziert den Slot über containers.attachments, das der Synthesizer als secretKeyRef in env rendert. Das erzeugte Secret und die Referenz des Containers benennen dieselbe Ressource, weil beide .features.user_password.provides.name lesen — es gibt keine erneute Ableitung und keine Konvention, auf die sich beide Seiten einigen müssten. Der veröffentlichte Name normalisiert Unterstriche im Slot-Namen zu Bindestrichen, sodass user_password zum gültigen Kubernetes-Ressourcennamen db-user-password wird. Der Dateiname, der ihn trägt, ist eine separate Ableitung und liest sich anders: Er stellt die Komponente und den Slot-Namen als eigene Koordinaten der Anbindung voran, kodiert für ein Dateinamen-Alphabet, das nur Kleinbuchstaben und Ziffern zulässt, sodass der Unterstrich dort als Escape-Sequenz statt als Bindestrich erscheint.

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 nicht anzubinden ist ebenfalls gültig: Das Recipe greift auf einen inline angegebenen Entwicklungs-Standardwert (MARIADB_PASSWORD: apppass) zurück, und es wird kein Secret erzeugt, sodass eine minimale Bereitstellung trotzdem gerendert wird und läuft.

Dimensionierung durch den Betreiber

release.yaml erfüllt die Säule der Dimensionierung durch den Betreiber pro Umgebung: Der Image-Tag des Containers stammt aus infra.engine_version (mariadb:11.4), und die Anforderung und die Storage-Klasse des volumeClaimTemplate stammen aus infra.storage (5Gi, standard). Das Aggregate des Entwicklers trägt diese Felder nie.