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
mysqlgerendert 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
| Datei | Rolle |
|---|---|
aggregate-helm-synth.yaml | Entwicklerabsicht 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.yaml | Entwicklerabsicht für die vollständige Kubernetes-Variante: beide Zugangsdaten-Slots, root_password und user_password. |
manifest-helm-synth.yaml | Bildet 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.yaml | Dokument des Operators für die Kubernetes-Basisvariante, mit operativer Dimensionierung (engine_version, storage). |
release-helm-synth-auth.yaml | Dokument des Operators für die vollständige Kubernetes-Variante. |
aggregate.yaml | Entwicklerabsicht für das lokale Compose-Ziel: dieselbe Komponente db mit beiden Zugangsdaten-Slots, zugestellt als Zugangsdaten vom Typ inject-value. |
manifest-compose.yaml | Bildet den MySQL-Typ auf das Compose-Recipe (mysql) und die Zugangsdaten auf dotenv-secret ab. |
release-compose.yaml | Dokument 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/mysqldeklariert eine gegenüber Fähigkeiten agnostischeWorkloadmitform: 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ältMYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORDundMYSQL_PASSWORD. Zeichensatz und Kollation werden als Kommandozeilenargumente des Serversmysqldumgesetzt (--character-set-server,--collation-server), weil das offizielle Imagemysqlsie 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 indocker-compose.yamlmit 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 Labelfeature.aggrega.ai/kind: secret, getrennt von denvaluesder Anwendung. DasfeaturesSchemader Component deklariert einen Black-Box-Slotroot_passwordund einen transparenten Slotuser_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:
aggrega scaffold --example mysql-standaloneDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd mysql-standaloneBuild
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:
# 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-pullGerenderte 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.