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

Sprachreferenz

Das „Was“ und „Wie man es verwendet“ von Aggrega. Syntax, CLI-Aufruf, Fehlerkatalog, ausgearbeitete Beispiele.

Lesen Sie die folgenden Kapitel für ein erstes Verständnis der Reihe nach. Referenz-Unterverzeichnisse sind unter ihrem Kapitel aufgeführt — springen Sie direkt dorthin, wenn Sie eine bestimmte Entität, ein Schlüsselwort, einen Provider, einen CLI-Befehl oder einen Fehler nachschlagen.

Bevor Sie die Kapitelfolge lesen, ziehen Sie Status der Sprache für den aktuellen Reifegrad heran — welche Sprachoberflächen heute verfügbar sind, welche akzeptiert, aber vom Compiler noch nicht verarbeitet werden, und welche für künftige Iterationen geplant sind. Kompatibilität legt fest, was ein Release für die Schemas, die Befehlszeile, die Assistenten-Werkzeuge, die Fehlercodes und die Plugin-Kits zusichert.

Stufenmodell der Entitäten

Die Authoring-Entitätsarten von Aggrega sind in drei Stufen gegliedert, die den Verlauf der Einführung widerspiegeln (siehe unten). Daneben steht die plattformeigene Workload, die keine eigene Authoring-Art ist — sie ist die Form, die die synthetisierte Eingabe einer Recipe annimmt, und drückt die Compute-Form über das Vokabular form: aus (stateless, stateful, daemon, scheduled, task, reference). Die Stufung ist ein Mechanismus der Dokumentation und des Onboardings, keine Laufzeitbeschränkung: Jede Entitätsart ist ein vollwertiger Bestandteil der Sprache; der Compiler behandelt sie einheitlich; das Open-Source-Aggrega unterstützt alle Stufen ohne Lizenzierung oder Feature-Beschränkung. Die Stufenmarkierungen signalisieren „fortgeschritten; überspringen, falls nicht benötigt“ für die Navigation, nicht für den Funktionsumfang.

StufeEntitätsartenWann einführen
Stufe 1 — die minimal nutzbare OberflächeAggregate, Component, Recipe, Manifest, ReleaseTag 1 — Einzelgründer und kleine Teams liefern funktionierende Software allein mit Stufe 1 aus. Das mentale Modell: „Ich habe eine App; ich will sie deployen; so geht das.“
Stufe 2 — RollentrennungFeature, FeatureRecipe, PluginTag 30 — kleine Teams, in denen sich die Rollen aufteilen (Entwicklung + Ops + manchmal Security). Stufe 2 kommt über Provider-rendernde Plugins (Ops wählt zwischen Helm, helm-chart, Compose, Terraform und CloudFormation), Features (Security verwaltet Zugangsdaten getrennt von der App-Konfiguration) und FeatureRecipes (Anpassung zum Bindungszeitpunkt je Provider) hinzu.
Stufe 3 — Component-übergreifende WiederverwendungSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibraryTag 365 — ausgereifte Kataloge, in denen gemeinsame Formen in vielen Entitäten wiederkehren. Die Schwelle ist informell: Wenn eine Form (z. B. PodResources) in 5+ Components vorkommt und das Abstimmen von Aktualisierungen Reibung verursacht, rechtfertigt sich ein SchemaLibrary-Eintrag von selbst.

Jeder Schritt ist optional. Ein Einzelgründer muss sich Stufe 3 nie ansehen; ein Unternehmenskatalog hat bei Bedarf vollen Zugriff auf Stufe 3. Stufe 1 ist für den Anwendungsfall des Einzelgründers vollständig — ein Entwickler kann funktionierende Anwendungen ausschließlich mit Entitäten der Stufe 1 ausliefern. Das ist eine starke Designeigenschaft: Stufe 1 ist keine „Teilmenge, die kompiliert“; sie ist eine „Teilmenge, die Software ausliefert“.

Die Stufe-1-Oberfläche mit fünf Entitäten hat Einstiegskosten — Aggregate + Component + Recipe + Manifest + Release ist mehr Zeremonie als „YAML-Datei ablegen, laufenden Dienst erhalten“. Die Kosten sind der Preis für die Trennung des Authorings in vier Domänen (Entwicklerabsicht / Plattformkatalog / Plattformbetrieb / Routing), die Aggrega von reinem Helm oder reinem Terraform unterscheidet. Die Tutorials der Stufe 1 führen explizit durch die Einrichtung mit fünf Entitäten.

Innerhalb von Stufe 3 ist die Mechanik spec.templates / $instantiate: (parametrische Helfer in der SchemaLibrary) als noch weiter fortgeschrittene Teilfunktion dokumentiert. Die meisten Anwender von Stufe 3 greifen anfangs nicht zu spec.templates; die Schwelle ist „wenn Ihre Bibliothek 6+ Schemas mit parametrisierter gemeinsamer Struktur hat“.

Lesereihenfolge

  1. So verwenden Sie diese Referenz
  2. Namenskonventionen
  3. Übersicht der Entitätsreferenz
  4. Übersicht des Vokabulars
  5. Übersicht der Templates
  6. Übersicht der Providers
  7. Übersicht der CLI
  8. Übersicht der Fehler
  9. Übersicht der Beispiele

Referenz für das Plugin-Authoring

Die Wasm-Plugin-Oberfläche steht neben der Kapitelfolge statt in ihr: Ein Plugin-Autor liest sie unabhängig vom Pfad des Entitäts-Authorings. Die Entitätsseite plugin behandelt die Authoring-Oberfläche des Katalogs; die folgenden Seiten behandeln die Sockets, die Payloads und den Arbeitsablauf des Autors.

  • plugin-contract — die Sockets, an die sich ein Plugin anhängt, ihre Position in der Pipeline sowie die Eingabe- und Ausgabeformen jedes Sockets.
  • plugin-developer-guide — der vollständige Arbeitsablauf des Autors: describe(), Fähigkeitsangaben, Laufzeitlimits, der Lebenszyklus publish/pull/build, Signierung, Versionierung.
  • policy-socket — der Governance-Socket im Detail: seine vier Rollen, die Schweregrade der Urteile, der Eingabekanal des Betreibers und das Schreiben einer Policy für eine der beiden Engines, die im Compiler enthalten sind.
  • governance-attachment-facts — die Fakten je Anbindung, die eine Governance-Policy aus dem Build-Graphen liest, einschließlich der drei Einheiten der Sensitivitätskennzeichnung und warum eine fehlende Kennzeichnung keine Erlaubnis ist.
  • when-to-use-a-pipeline-step — die Wahl zwischen einem Pipeline-Schritt und einem templatebasierten FeatureRecipe.
  • embedded-plugins — die Plugins, die im Compiler-Binary enthalten sind.
  • tagging-plugins — die beiden eingebauten Governance-Plugins, die Labels ohne Richtlinie schreiben, governance/label-injector und governance/selector-tagger: ihre Einstellungen und was jedes schreibt.
  • core-importers — die zehn Importer des Compilers, von Langflow, Flowise und n8n bis zu Compose, MCP und den Agenten-Frameworks: was jeder liest und entwirft, ihre Einstellungen und ihre Veröffentlichung mit jedem Compiler-Release.
  • authoring-a-provider-walkthrough — eine ausgearbeitete Schritt-für-Schritt-Anleitung zum Verfassen eines Provider-Guests, von einem leeren Verzeichnis bis zu einem Build, der die Dateien schreibt, die der Provider gerendert hat.
  • writing-a-governance-plugin — ein eigenes Governance-Plugin aus dem Adapter-Gerüst des Plugin-Kits schreiben: eine Regel, der Export jeder Rolle von Hand ausgeführt, eine Plugin-Entität im Katalog des Workspace und ein Build, den es ablehnt.
  • compatibility — wie die Plugin-Kits versioniert werden: was ein Patch- und ein Minor-Release eines Kits ändern darf und was dafür sorgt, dass ein gebautes Plugin weiterhin geladen wird.