Nur Katalog — MariaDB + Adminer, ohne eine einzige Plattformentität zu verfassen
Dieses Beispiel stellt einen kleinen, realen Stack bereit — eine MariaDB-Datenbank mit einer vorgeschalteten Adminer-Weboberfläche — und referenziert dabei ausschließlich Entitäten des Standardbibliothekskatalogs. Hier wird keine Component, kein Feature und kein Recipe verfasst: Drei kurze YAML-Dateien leiten alles an Entitäten weiter, die der Katalog bereits mitliefert.
Es ist die kleinste Authoring-Oberfläche, die Aggrega bietet, und der natürliche erste Kontakt mit der Sprache. Das Geschwisterbeispiel der Authoring-Stufe stellt denselben Stack bereit und baut dabei seine eigene Katalogschicht auf — lesen Sie zuerst dieses Beispiel, um zu sehen, was Ihnen ein fertiger Katalog bringt, und dann jenes, um zu lernen, wie die darunterliegende Schicht gemacht ist.
Die drei Dateien
aggregate.yaml— die Absicht des Entwicklers: was der Stack ist. Zwei Komponenten, aus dem Katalog übertype:ausgewählt, erforderliche Zugangsdaten als slotfüllende Anbindung und eineuses-Kante, die die Datenbank mit dem Socketdatabasesvon Adminer verdrahtet.release.yaml— die umgebungsspezifische Erfüllung durch den Operator: wie groß und wo. Die Blöckeinfra:(Engine-Version, Speichergröße, veröffentlichter Port) gehören dem Operator; das Aggregate trägt sie nie.manifest.yaml— das Routing des Operators: welches Recipe jeden Typ auf diesem Ziel realisiert. Weiter unten steht, warum die Referenzen Provider-qualifiziert sind.
Was es zeigt
- Components als Katalogreferenzen.
type: core/datastore/mariadbundtype: core/devtool/adminersind die gesamte Compute-Deklaration. Der Entwickler verfasst nur die Werte, die die Component-Schemas offenlegen — jedes weggelassene Feld erhält den Standardwert seines Schemas (vergleichen Sie die Umgebungsvariablen für Zeichensatz und Kollation in der gerenderten Ausgabe mit dem einzeiligen Blockvalues:, der sie erzeugt hat). - Die String Pipe. Die Katalog-Component von Adminer deklariert einen uses-Socket
databases, der jede Komponente mit dem Labelcomponent.aggrega.ai/type=stateful-serverakzeptiert. Die Kante des Aggregate injiziertprovides.hostdes Datenbank-Recipe inADMINER_DEFAULT_SERVER. Der Compiler leitet den String weiter, ohne ihn zu interpretieren — auf diesem Ziel ist er ein Compose-Dienstname; dieselbe Kante auf einem Kubernetes-Ziel würde einen Service-DNS-Namen tragen. - Die Säule der Anbindungen. Das
featuresSchemader Datenbank-Component verlangt einen Slotroot_password, gefüllt mit dem Featurecore/secret-valuedes Katalogs. Der Slot ist eine Black Box: Das vom Manifest ausgewählte FeatureRecipe steuert die Zustellung, und der Entwickler kann sie nicht vorschreiben. - Provider-qualifiziertes Recipe-Routing. Das Manifest bildet
core/datastore/mariadb:1.0.0aufcompose/mariadb:1.0.0ab — nach Provider qualifiziert —, weil die Standardbibliothek ein mariadb-Recipe unter mehr als einem Provider mitliefert (darunter compose und helm). Die Zuordnung des Operators ist es, die das Ziel eindeutig macht: Eine bloße, unqualifizierte Referenz, die auf das Recipe mehr als eines Providers passt, lässt den Build deutlich abbrechen, statt stillschweigend eines auszuwählen. Richten Sie den Stack neu aus, indem Sie diese Zuordnungen umleiten; das Aggregate ändert sich nicht.
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 catalog-onlyDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd catalog-onlyBuild
Aus diesem Verzeichnis, wobei die Katalogentitäten aus hub.aggrega.ai aufgelöst werden, der Standard-Registry, die .aggrega-config.yaml nennt:
aggrega pull --release release.yamlaggrega build --release release.yamlDer Pull-Befehl löst jede referenzierte Entität auf und fixiert sie in release.lock (Identität + Inhalts-Digest; führen Sie ihn erneut aus, um ein veraltetes Lockfile neu zu erzeugen). Mit einem Checkout des Standardbibliothekskatalogs (woher Sie einen bekommen) nennen Sie dessen Verzeichnis aggrega-catalog mit --catalog bei beiden Befehlen, um die Entitäten von dort zu lesen. Der Build liest dieses Lockfile — ohne es bricht der Build ab und nennt die beiden möglichen Wege, den Pull-Befehl oder --auto-pull — und rendert dist/compose/docker-compose.yaml. Das Release verfasst seine Komponenten direkt (kein Block boundaries:), daher faltet der Compiler sie in den synthetisierten Standard-Geltungsbereich und gibt flach unter dist/ aus — eine Boundary, kein Boundary-Namenssegment im Pfad.
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 nur die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `catalog-only` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `catalog-only` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `catalog-only`. Rufen Sie dann das Tool `build` auf, mit `workspace_root` auf `catalog-only`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `catalog-only/dist/`.Die Ausgabe lesen
In der gerenderten Compose-Datei wird die Verdrahtung sichtbar:
- der Dienst
webträgtADMINER_DEFAULT_SERVER: db—provides.hostdes Datenbank-Recipe (den Compose-Dienstnamen), über die uses-Kante zugestellt; - dieselbe Kante hat
depends_on: [db]erzeugt — Topologie, nicht nur Strings; MARIADB_CHARACTER_SET_SERVERundMARIADB_COLLATION_SERVERdes Dienstesdbstammen aus Schema-Standardwerten, die das Aggregate nie erwähnt;image: mariadb:11.4und die Portbindung8080:8080stammen aus den Blöckeninfra:des Release — der Säule des Operators, neben der des Entwicklers gerendert.
Ausführen
cd dist/composedocker compose up -dÖffnen Sie http://localhost:8080: Das Serverfeld ist mit db vorausgefüllt. Melden Sie sich als root mit dem Entwicklungspasswort aus der Anbindung des Aggregate an (dev-root-pw-change-me — ein Platzhalter, der in allem über die lokale Entwicklung hinaus zu ersetzen ist), Datenbank appdb.
Wie es weitergeht
Die Authoring-Stufe lässt Sie genau diese Plattformschicht selbst bauen — die Components, Recipes und Zugangsdaten-FeatureRecipes, die dieses Beispiel fertig konsumiert hat — und kompiliert ein Aggregate für vier Ziele.