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:
aggrega scaffold --example per-instance-recipe-overrideDanach gibt er die als Nächstes auszuführenden Befehle aus:
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlEine 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.0Der spezifischste Eintrag gewinnt:
- der
name-Eintrag für den Namen der Instanz; - der
type-Eintrag, der den Typ in der Version der Instanz nennt, etwaexample/compute/greeter:1.0.0; - der
type-Eintrag, der den Typ ohne Version nennt; - 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: trueDas 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.