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

Fortgeschrittene Muster

Diese Seite erklärt eine Idee, das Manifest und das FeatureRecipe als die Stellen, die entscheiden, was ein Build über das eigene Recipe einer Komponente hinaus schreibt, und ist kein ausführbarer Workspace. Rezept-Überschreibung pro Instanz zeigt die Manifest-Hälfte in einem Workspace, den Sie bauen; schreiben Sie ihn in einen eigenen Ordner mit:

Terminal window
aggrega scaffold --example per-instance-recipe-override

Danach gibt er die als Nächstes auszuführenden Befehle aus:

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Eine Instanz, ein eigenes Recipe

Die type-Ebene des Manifest bindet jede Instanz eines Komponententyps an ein einziges Recipe. Seine name-Ebene bindet eine einzelne Instanz, über ihren Namen im Aggregate, an ein anderes, und die dort benannte Instanz übernimmt es, während jede andere Instanz des Typs die type-Bindung behält. Aus der manifest.yaml des Beispiels:

spec:
mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0
name:
greeter-special: compose/greeter-green:1.0.0

Der spezifischste Eintrag gewinnt:

  1. der name-Eintrag für den Namen der Instanz;
  2. der type-Eintrag, der den Typ in der Version der Instanz nennt, etwa example/compute/greeter:1.0.0;
  3. der type-Eintrag, der den Typ ohne Version nennt;
  4. ohne jeden Eintrag bricht der Build ab und nennt die nicht zugeordnete Instanz.

Ein Manifest ist gewöhnliches YAML, daher kann ein Wert, den es wiederholt, einmal mit einem Anker geschrieben und mit einem Alias referenziert werden.

Ein Feature, das eigene Ressourcen mitbringt

Ein FeatureRecipe kann Ressourcen neben denen der Komponente rendern, aus einem eigenen Chart, das source: benennt und das sein valuesMapping speist, statt zu ändern, was das Recipe der Komponente rendert. core/public-ingress aus der Standardbibliothek wird auf diese Weise auf Kubernetes realisiert, durch helm/public-ingress, das ein Ingress für die Komponente rendert, an die es angebunden ist.

Der Anfragepfad, den eine Komponente bedient, gehört zu dem, was die Anwendung ist, daher nimmt das Feature ihn in values entgegen; der Hostname ist der Name, den die Umgebung der Komponente gibt, daher ist er infra, neben den Einstellungen, die den Cluster beschreiben. In Ein Agent, ein Router und zwei Upstream-Modelle bindet der Entwickler es im Aggregate an und schreibt den Pfad:

features:
published:
type: core/public-ingress
values:
path: /

und das Release gibt derselben Anbindung ihren Host und bestätigt, dass im Zielcluster ein Ingress-Controller läuft, eine Bestätigung, ohne die der Build abbricht; aus der release.yaml, ohne ihre Kommentare:

published:
infra:
host: assistant.example.internal
control_plane_present: true

Das FeatureRecipe benennt die Ressourcen, die es rendert, nach .context.rendered_name, dem Namen der Host-Komponente, wie ihr Provider ihn meldet, sodass das Ingress auf den Service zeigt, den das eigene Recipe der Komponente rendert. Ein host, der in den values des Aggregate steht, oder ein path in der infra des Release wird unter Nennung des Feldes abgewiesen: Jede Säule ist geschlossen, und das Feld gehört zur anderen. Ein Pfad, der sich zwischen Umgebungen unterscheidet, ist ein Parameter, den das Aggregate deklariert und jedes Release erfüllt.