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

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 über type: ausgewählt, erforderliche Zugangsdaten als slotfüllende Anbindung und eine uses-Kante, die die Datenbank mit dem Socket databases von Adminer verdrahtet.
  • release.yaml — die umgebungsspezifische Erfüllung durch den Operator: wie groß und wo. Die Blöcke infra: (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/mariadb und type: core/devtool/adminer sind 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 Block values:, der sie erzeugt hat).
  • Die String Pipe. Die Katalog-Component von Adminer deklariert einen uses-Socket databases, der jede Komponente mit dem Label component.aggrega.ai/type=stateful-server akzeptiert. Die Kante des Aggregate injiziert provides.host des Datenbank-Recipe in ADMINER_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 featuresSchema der Datenbank-Component verlangt einen Slot root_password, gefüllt mit dem Feature core/secret-value des 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.0 auf compose/mariadb:1.0.0 ab — 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:

Terminal window
aggrega scaffold --example catalog-only

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

Terminal window
cd catalog-only

Build

Aus diesem Verzeichnis, wobei die Katalogentitäten aus hub.aggrega.ai aufgelöst werden, der Standard-Registry, die .aggrega-config.yaml nennt:

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

Der 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 web trägt ADMINER_DEFAULT_SERVER: db — provides.host des Datenbank-Recipe (den Compose-Dienstnamen), über die uses-Kante zugestellt;
  • dieselbe Kante hat depends_on: [db] erzeugt — Topologie, nicht nur Strings;
  • MARIADB_CHARACTER_SET_SERVER und MARIADB_COLLATION_SERVER des Dienstes db stammen aus Schema-Standardwerten, die das Aggregate nie erwähnt;
  • image: mariadb:11.4 und die Portbindung 8080:8080 stammen aus den Blöcken infra: des Release — der Säule des Operators, neben der des Entwicklers gerendert.

Ausführen

Terminal window
cd dist/compose
docker 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.