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

MySQL — ein Aggregate, zwei Ziele

Dieses schlanke Beispiel kompiliert eine einzelne MySQL-Datenbank aus vom Entwickler verfassten Aggregates zu zwei Zielen:

  • Kubernetes über die Workload-Synthese des helm-Providers (ein StatefulSet, das direkt auf dem offiziellen Image mysql gerendert wird, kein externes Chart) und
  • Docker Compose für die lokale Entwicklung.

Dieselbe Entwicklerabsicht steuert jedes Ziel. Pro Ziel ändert sich nur die vom Manifest ausgewählte Recipe-Schicht.

Dateien

DateiRolle
aggregate-helm-synth.yamlEntwicklerabsicht für die Kubernetes-Basisvariante: eine Komponente db vom Typ core/datastore/mysql, ihre Werte und nur die erforderlichen Zugangsdaten root_password.
aggregate-helm-synth-auth.yamlEntwicklerabsicht für die vollständige Kubernetes-Variante: beide Zugangsdaten-Slots, root_password und user_password.
manifest-helm-synth.yamlBildet den MySQL-Typ auf das synthetisierte helm-Recipe (helm/mysql) und alle Zugangsdaten auf ihr jeweiliges FeatureRecipe (env-secret, k8s-secret-from-parameter) ab.
release-helm-synth.yamlDokument des Operators für die Kubernetes-Basisvariante, mit operativer Dimensionierung (engine_version, storage).
release-helm-synth-auth.yamlDokument des Operators für die vollständige Kubernetes-Variante.
aggregate.yamlEntwicklerabsicht für das lokale Compose-Ziel: dieselbe Komponente db mit beiden Zugangsdaten-Slots, zugestellt als Zugangsdaten vom Typ inject-value.
manifest-compose.yamlBildet den MySQL-Typ auf das Compose-Recipe (mysql) und die Zugangsdaten auf dotenv-secret ab.
release-compose.yamlDokument des Operators für das lokale Compose-Ziel, einschließlich eines Provider-spezifischen Eintrags infra.overrides, der das exakte Container-Image fixiert.

Was es zeigt

  • Eine Authoring-Oberfläche, viele Ziele. Ein Aggregate ist die maßgebliche Quelle dafür, was der Stack ist. Jedes Manifest sagt, wie er zu realisieren ist.
  • Workload-Synthese auf Kubernetes (bevorzugt). Das Recipe helm/mysql deklariert eine gegenüber Fähigkeiten agnostische Workload mit form: stateful; der helm-Provider synthetisiert ein StatefulSet, einen ClusterIP-Service, einen Headless-Service (die stabile Netzwerkidentität des StatefulSet) und ein volumeClaimTemplate für das Datenverzeichnis. Die Umgebung des Containers enthält MYSQL_DATABASE, MYSQL_USER, MYSQL_ROOT_PASSWORD und MYSQL_PASSWORD. Zeichensatz und Kollation werden als Kommandozeilenargumente des Servers mysqld umgesetzt (--character-set-server, --collation-server), weil das offizielle Image mysql sie als Server-Flags statt als Umgebungsvariablen entgegennimmt.
  • Workload-Synthese auf Compose. Das Compose-Recipe deklariert eine gegenüber Fähigkeiten agnostische Workload; der compose-Provider synthetisiert einen Service in docker-compose.yaml mit dem MySQL-Image, seiner Umgebung, einem benannten Daten-Volume und einem Health-Check.
  • Ein Ausweg für den Betreiber. Das Compose-Release setzt infra.overrides.image, die offene Säule für Provider-spezifische Fakten, die das eigene Schema der Component nicht benennt, und der gerenderte Service führt genau diese Image-Referenz aus. Siehe Provider-spezifische Überschreibungen.
  • Zugangsdatenmodell mit zwei Slots. Passwörter sind Anbindungen an der Säule features: der Komponente, jede ein Feature mit dem Label feature.aggrega.ai/kind: secret, getrennt von den values der Anwendung. Das featuresSchema der Component deklariert einen Black-Box-Slot root_password und einen transparenten Slot user_password.

Zustellung von Zugangsdaten auf Kubernetes

root_password ist ein Black-Box-Slot (inject: []): Das Recipe steuert die Zustellung. Die angebundenen Zugangsdaten vom Typ inject-value legen den Wert in den Inject-Kanal der Komponente, und das Recipe liest ihn als .context.inject.env.MYSQL_ROOT_PASSWORD und gibt eine einfache Umgebungsvariable des Containers aus. Dafür wird kein Kubernetes-Secret erzeugt.

user_password ist ein transparenter Slot (inject: [env, file]). Die vollständige Variante bindet referenzierbare Zugangsdaten an, die ein Kubernetes-Secret materialisieren und dessen Identität veröffentlichen; 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. user_password nicht anzubinden (die Basisvariante) ist ebenfalls gültig: Das Recipe greift auf einen inline angegebenen Entwicklungs-Standardwert (MYSQL_PASSWORD: apppass) zurück, und es wird kein Secret erzeugt, sodass eine minimale Bereitstellung trotzdem gerendert wird und läuft.

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 mysql-standalone

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

Terminal window
cd mysql-standalone

Build

Dieser Workspace enthält kein .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig; --auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt:

Terminal window
# Kubernetes — synthesized helm StatefulSet (base: root credential only)
aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)
aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull

Gerenderte Artefakte landen unter dist/.

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 `mysql-standalone` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `mysql-standalone` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `mysql-standalone`. Rufen Sie anschließend das Tool `build` einmal für jedes Release auf, in dieser Reihenfolge — `release-helm-synth.yaml`, `release-helm-synth-auth.yaml` und `release-compose.yaml` —, jedes Mal mit `workspace_root` auf `mysql-standalone`, `release` auf diese Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir, welche Dateien jeder Build geschrieben hat; sie liegen unter `mysql-standalone/dist/`.

Dimensionierung durch den Betreiber

Die Kubernetes-Releases erfüllen die Säule der Dimensionierung durch den Betreiber pro Umgebung: Der Image-Tag des Containers stammt aus infra.engine_version (mysql:8.4), und die Anforderung und die Storage-Klasse des volumeClaimTemplate stammen aus infra.storage. Das Aggregate des Entwicklers trägt diese Felder nie.

Provider-spezifische Überschreibungen

Dimensionierungssäulen sind benannte Felder: Die Component deklariert engine_version und storage, daher füllt ein Betreiber, der eines davon setzt, ein Feld aus, das die Component vorgesehen hat. infra.overrides ist die Säule für das, was eine Component nicht vorhersehen kann — sie ist als Objekt deklariert, das jede verschachtelte Struktur akzeptiert, und jedes Recipe dokumentiert, welche Schlüssel es liest.

release-compose.yaml verwendet sie. Das Compose-Recipe liest einen Schlüssel, image, und wenn er gesetzt ist, führt der Container genau diese Referenz aus statt derjenigen, die das Recipe aus engine_version zusammensetzt:

infra:
engine_version: "8.4"
overrides:
image: "registry.internal.example/library/mysql:8.4"

Der gerenderte Service trägt die Überschreibung wörtlich:

services:
db:
image: registry.internal.example/library/mysql:8.4
[… omitted: the service's environment, labels, volume, network and health check]

Dies ist der Weg zu einem in eine Registry gespiegelten oder per Digest fixierten Build derselben Serverversion — eine Tatsache der Bereitstellung, die zur Zielumgebung gehört, nicht zum Vertrag der Component. Da die Schlüsselmenge pro Recipe statt pro Component gilt, ist das Recipe der Ort, an dem nachzusehen ist, welche Schlüssel gelten: Das Compose-Recipe liest hier image, und ein Recipe, das keinen liest, sagt das.