Wie Sie diese Referenz verwenden
Die Sprachreferenz spezifiziert die Oberfläche zum Verfassen in Aggrega — die YAML-Schemas, das gemeinsame Schlüsselwortvokabular, das Go-Template-System, die Provider-Verträge, die CLI-Befehle, den Fehlerkatalog des Compilers und durchgängig ausgearbeitete Beispiele. Lesen Sie die folgenden Kapitel zur ersten Orientierung der Reihe nach, oder springen Sie direkt in ein Unterverzeichnis, wenn Sie eine bestimmte Entität, ein Schlüsselwort, einen Provider, einen CLI-Befehl oder einen Fehler nachschlagen.
Um zuerst die Binärdatei aggrega zu installieren, folgen Sie Die Binärdatei installieren; damit ein KI-Assistent sie für Sie installiert und einrichtet, fügen Sie den Prompt aus Aggrega mit Ihrem KI-Assistenten einrichten ein. Bevor Sie Skripte oder einen Katalog auf Aggrega aufbauen, lesen Sie Kompatibilität, um zu erfahren, was ein Upgrade ändern darf und was nicht.
Bevor Sie die Referenz lesen, machen Sie sich mit dem mentalen Modell vertraut, das die Architekturkapitel aufbauen. Das Kapitel Die vier Domänen und Team Topologies erklärt, wie Aggrega die Anliegen von Developer Intent, Platform Catalog, Platform Ops und Platform Operator in getrennte Oberflächen zum Verfassen aufteilt; das Kapitel Entitätstaxonomie benennt die Entitäten (Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary) und ihre Rollen in diesen Domänen. Jedes Referenzkapitel nach diesem setzt voraus, dass der Leser dieses Bild hat.
Verwenden Sie diese Referenz auf zwei Arten. Zur Einarbeitung lesen Sie sie der Reihe nach: Beginnen Sie mit Namenskonventionen für das Muster der Instanznamen und die Regeln zur Groß- und Kleinschreibung, und gehen Sie dann die Kapitel zu Entitäten und Vokabular durch, um den vollständigen Vertrag zum Verfassen aufzubauen. Zum Nachschlagen springen Sie direkt in das Unterverzeichnis, das zur Frage passt — entities/ für die Feldsemantik je Entität, vocabulary/ für entitätsübergreifende Schlüsselwörter, templates/ für die Go-Template-Oberfläche, die Recipe-Autoren zur Verfügung steht, providers/ für die Dispatch-Verträge je Provider, plugins/ für die Plugin-Sockets und das Verfassen von Plugins, schema/ für das JSON Schema jeder Art, cli/ für die Verwendung der Kommandozeile, errors/ für Diagnosen und examples/ für ausgearbeitete Muster.