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

Ausgabekomposition

Ein einzelner Aggrega-Build erzeugt Ausgabedateien in Boundary-bezogenen Verzeichnissen unter dist/ über sechs verschiedene Mechanismen — quellbasiertes Rendering, Arbeitslast-Synthese, Ressourcenerzeugung des FeatureRecipe, Plugin-Pipeline-Patches des FeatureRecipe, Komposition auf Release-Ebene und direkte Artefaktausgabe. Die Mechanismen laufen in einer festgelegten Reihenfolge; Ausgaben kollidieren deterministisch, wenn zwei Mechanismen eine Datei mit demselben Namen im selben Boundary-Verzeichnis erzeugen; der Build hält vor der Ausgabe an und nennt jeden Beitragenden, wenn eine Kollision erkannt wird, unter der Kategorie, die die Kollisionsregel nennt.

Diese Seite dokumentiert die sechs Mechanismen an einem Ort und nennt die Rendering-Reihenfolge über sie hinweg. Die kapitel- und entitätsbezogenen Referenzen decken ihre eigenen Oberflächen ab; die Regeln zur Kollisionserkennung über alle sechs stehen hier.

Die sechs ausgabeerzeugenden Mechanismen

Jeder Mechanismus ist an einer bestimmten Authoring-Oberfläche von Recipe / FeatureRecipe angesiedelt und erzeugt Dateien nach bestimmten Benennungskonventionen. Die Mechanismen akkumulieren sich pro Knoten — eine einzelne Komponenteninstanz kann mehrere Mechanismen gleichzeitig ansteuern (ein quellbasiertes Basis-Recipe + eine von der Workload synthetisierte Begleitdatei + ein von einem FeatureRecipe ausgegebenes ExternalSecret-CRD + ein Plugin-Pipeline-Patch, der auf das synthetisierte Deployment angewendet wird).

1 — Quellbasiertes Rendering des Recipe (source: + valuesMapping:)

Authoring-Oberfläche. Das Recipe deklariert source: <path> sowie valuesMapping: (das Feld akzeptiert ein Inline-Go-Template, einen $import: einer Datei oder einen $import: einer Bibliothek auf einen Eintrag einer MappingLibrary — siehe entities/recipe.md „The valuesMapping field — three authoring modes (Das Feld valuesMapping — drei Authoring-Modi)“). Die Quelle verweist auf ein Helm-Chart auf der Festplatte, eine docker-compose-YAML-Datei oder ein anderes Provider-natives Artefakt.

Position in der Pipeline. Basis-Rendering, nachdem die locals und provides des Recipe aufgelöst sind.

Ausgabeform. Provider-spezifisch:

  • helm-Provider — flache Kubernetes-YAML-Dateien, benannt nach der Komponentenidentität und dann nach der Ressource selbst: <component-id>-<kind>[-<namespace>]-<name>.yaml, wobei ein Dokument ohne kind oder ohne Namen stattdessen nach seinem Template-Pfad benannt wird. Der Name stammt aus der Ressource statt aus dem Template, sodass zwei Templates in verschiedenen Unterverzeichnissen mit gleichem Dateinamen zwei Dateien bleiben. Das Helm-SDK rendert das Chart mit den zusammengeführten Werten; Aggrega fügt Provenienz-Labels und -Annotationen nach dem Rendern ein.
  • helm-chart-Provider — Sub-Chart-Dateien, kopiert unter charts/<instance_id>/, unverändert bis auf den eigenen name des Charts, den das Umbrella auf die codierte Identität der Instanz setzt, damit zwei Komponenten, die Charts mit demselben deklarierten Namen einbinden, unterscheidbar bleiben (siehe providers/helm-chart.md); ein Umbrella-Chart.yaml + values.yaml pro Boundary wird daneben ausgegeben.
  • compose-Provider — <nodeID>.compose-fragment.yaml-Zwischendateien, die in die Komposition auf Release-Ebene einfließen (Mechanismus 5).

2 — Workload-Synthese des Recipe (workload:)

Authoring-Oberfläche. Das Recipe deklariert workload: mit einem Workload-Dokument. Das Feld akzeptiert Inline-Inhalt (Block-Scalar) oder $import: (Dateipfad).

Position in der Pipeline. Basis-Rendering, nachdem das valuesMapping des Recipe aufgelöst ist (der Body der Workload ist selbst ein Go-Template-String, der mit dem vollständigen Template-Kontext ausgewertet wird).

Ausgabeform. Provider-spezifisch:

  • helm-Provider — ein Controller-Objekt, gewählt durch das form der Workload (Deployment für stateless, StatefulSet für stateful, DaemonSet für daemon, Job für task, CronJob für scheduled) + ein Service pro Dienst + ein PVC pro persistent-Volume. Zwei Benennungsformen, und sie sind nicht dieselbe: Das Controller-Objekt wird nach dem Releasenamen des Knotens und seinem kind benannt — <release name>-deployment.yaml, <release name>-statefulset.yaml, <release name>-daemonset.yaml, <release name>-job.yaml, <release name>-cronjob.yaml —, während eine Datei pro Ressource nach der Ressource, die sie trägt, benannt wird, mit dem kind am Ende: <release name>-<svcName>-service.yaml und <release name>-<volName>-pvc.yaml, weil jede aus dem eigenen metadata.name dieser Ressource benannt wird. Der Releasename ist die Identität des Knotens, geschrieben in dem Alphabet, das ein Kubernetes-Name zulässt, sodass er überall dort der Knoten-ID entspricht, wo diese keinen Unterstrich und keinen Großbuchstaben enthält: Der Knoten my_api schreibt my-zuapi-deployment.yaml (siehe entities/workload.md „Synthesized-name convention (Konvention für synthetisierte Namen)“). Eine Workload, deren einzige Exposition ein externer Name ist, gibt stattdessen <release name>-service.yaml aus, da kein Service-Schlüssel zu tragen ist.
  • compose-Provider — <nodeID>.compose-fragment.yaml-Zwischendateien, die in die Komposition auf Release-Ebene einfließen.
  • helm-chart-Provider — nicht unterstützt; die Rolle von helm-chart ist ausschließlich die Chart-Komposition im quellbasierten Modus. Ein Recipe, das helm-chart mit workload: anvisiert, wird zur Render-Zeit abgelehnt (der helm-chart-Provider meldet keine Synthese-Fähigkeit).

3 — Ressourcenerzeugung des FeatureRecipe (quellbasierter Modus für FeatureRecipes)

Authoring-Oberfläche. Das FeatureRecipe deklariert source: sowie valuesMapping: (oder Gleichwertiges), dasselbe Muster wie das quellbasierte Rendering des Recipe, aber für Feature-Anbindungen statt für primäre Components.

Position in der Pipeline. Basis-Rendering, neben dem Rendering des Basis-Recipe für die übergeordnete Component. Jede Feature-Anbindung führt ihren eigenen Rendering-Durchlauf des FeatureRecipe aus.

Ausgabeform. Bestimmt durch den Provider der übergeordneten Component, weil die Ausgabe der Anbindung der Assemblierungsgruppe dieser Component beitritt statt einer eigenen — und sie ergibt sich daraus, wie dieser Provider die Gruppe kombiniert, da genau das bestimmt, ob es überhaupt einen Platz für eine Anbindung gibt. Drei Formen, eine pro Art der Kombination:

  • Ein Provider, der jedem Beitragenden eine eigene Position gibt — ein Chart, das ein Chart pro Beitragendem enthält, eine Wurzelkonfiguration, die ein Modul pro Beitragendem enthält —, gibt auch einer Anbindung eine eigene Position, neben der Komponente, an die sie angebunden ist, statt in ihr. Die beiden Koordinaten bilden das einzige Verzeichnissegment dieser Position, <component-id>--<feature-instance-id>, sodass eine Komponente api mit einer Anbindung aux unter api--aux neben api liegt, unter welchem Verzeichnis auch immer dieser Provider für seine Beitragenden vorsieht. Daneben statt darin, weil bei einem solchen Provider das Ziel seine Beitragenden an den Positionen entdeckt, die er ihnen gegeben hat: Ein Verzeichnis eine Ebene unterhalb einer dieser Positionen ist Inhalt, der zu diesem Beitragenden gehört, statt ein eigener Beitragender, daher wird es von nichts adressiert und von nichts gelesen. Eine an der Boundary deklarierte Anbindung hat keine Host-Komponente zu benennen, daher ist ihr Segment allein ihr Instanzname. Jede Koordinate wird codiert, bevor die beiden verbunden werden, sodass eine Koordinate, die selbst die Verbindungssequenz enthält, nicht mit der Verbindung verwechselt werden kann.
  • Ein Provider, der jedes Dokument direkt in das Boundary-Verzeichnis schreibt, hat keinen solchen Platz, denn genau das deklariert er über sein Ziel: Nur die Dateien, die direkt in einem Verzeichnis liegen, werden gelesen. Daher wandern dieselben beiden Koordinaten aus den Verzeichnissegmenten in den Dateinamen, und die Dateien der Anbindung landen neben denen der Komponente als <component-id>--<feature-instance-id>--<file>. Die beiden Koordinaten werden codiert, weil ein Dateiname kein Trennzeichen hat, auf das er zurückgreifen kann, und sie werden mit dem eigenen Namen der Datei an einer Grenze aus zwei Zeichen verbunden, die keine codierte Koordinate enthalten kann — und genau das sorgt dafür, dass zwei Anbindungen, die denselben Dateinamen ausgeben, zwei verschiedene Dateien ergeben.
  • Ein Provider, der die Beitragenden seiner Gruppe in ein einziges Dokument zusammenführt, führt auch die Ausgabe der Anbindung in dieses Dokument zusammen, wobei jede Ressource die eigene Identität der Anbindung trägt, damit lesbar bleibt, was woher stammt. Wo ein solcher Provider eine Anbindung trägt, die für ein anderes Ziel gerendert hat, kann dieser Inhalt nicht in ein Dokument eingefügt werden, zu dem er nicht gehört, daher wird er neben das assemblierte geschrieben — in der oben beschriebenen Form mit Dateinamenpräfix, aus demselben Grund.

Gängige Formen:

  • Ein ExternalSecret- / VaultSecret-CRD, erzeugt vom Fetcher eines Credential-FeatureRecipe.
  • Ein ServiceMonitor- / PrometheusRule-CRD, erzeugt von einem Observability-Feature.
  • Ein HTTPRoute- / Gateway-CRD, erzeugt von einem Routing-Feature.

4 — Plugin-Pipeline des FeatureRecipe (RFC-6902-Patches + Ressourcenausgabe)

Authoring-Oberfläche. Das FeatureRecipe deklariert pipeline: — ein Array von Wasm-Plugin-Schritten (Prinzip des zweiteiligen Plugins: Fetcher + Injector für Credential-Features; beliebige Plugin-Pipelines für Nicht-Credential-Features).

Position in der Pipeline. Die Plugin-Pipeline, nachdem das Basis-Rendering und das quellbasierte Rendering des FeatureRecipe abgeschlossen sind.

Ausgabeform. Plugin-spezifisch. Ein Schritt gibt zwei Ausgabeklassen zurück:

  • RFC-6902-Patches, die die Apply-Engine auf die adressierten Dokumente in der gerenderten Menge anwendet (z. B. Anhängen eines Sidecar-Containers, Einhängen eines Secret-Volumes, Umschreiben einer Umgebungsvariable im synthetisierten Deployment).
  • Nebeneffekte — vollständige neue Ressourcen, die neben dem Patch über das side_effects eines Schritts ausgegeben werden (typischerweise das vault-fetch-CRD des Fetchers, auf das der Injector dann verweist).

Status heute: verfügbar laut Status der Sprache → Phasen der Kompilierungs-Pipeline. Jeder deklarierte Schritt läuft während aggrega build: Der Host ruft das Wasm-Plugin des Schritts für die gerenderte Menge auf, wendet die zurückgegebenen Patches an und gibt die Nebeneffekte des Schritts aus. Siehe plugins/plugin-contract.md für die Oberfläche des Plugin-Vertrags.

5 — Komposition auf Release-Ebene (Boundary-Assemblierung pro Provider)

Authoring-Oberfläche. Gesteuert durch die Form des Release — kein Authoring pro Recipe. Eine Fähigkeit, die eine Boundary assembliert, tut dies einmal, nachdem jeder Knoten dieser Boundary gerendert hat: Die compose-Fähigkeit sammelt alle Fragmente pro Knoten in einer docker-compose.yaml pro Boundary, und die helm-chart-Fähigkeit sammelt die Sub-Chart-Kopien pro Knoten in einem Umbrella-Chart pro Boundary.

Position in der Pipeline. Nach dem Basis-Rendering, sobald sich die Ausgabe pro Recipe jedes Knotens für die Boundary angesammelt hat.

Ausgabeform. Pro Provider:

  • compose-Provider — eine docker-compose.yaml in der Wurzel der Boundary, die die Dienste, Volumes und Netzwerke jedes beitragenden Knotens zusammenfasst. Die <nodeID>.compose-fragment.yaml-Zwischendateien (Mechanismen 1 + 2) werden in die einzige Ausgabe zusammengeführt; die Fragmente erscheinen nicht im endgültigen Boundary-Verzeichnis.
  • helm-chart-Provider — ein Umbrella-Chart.yaml + values.yaml in der Wurzel der Boundary, plus Sub-Chart-Verzeichnisse pro Knoten unter charts/<instance_id>/.

6 — Direkte Artefaktausgabe des Recipe (artifacts:)

Authoring-Oberfläche. Das Recipe deklariert artifacts: als Map benannter Einträge; jeder Eintrag ist entweder Inline-Inhalt (ein Template-String, der den Dateiinhalt trägt) oder eine $import:-Referenz auf einen Template-Dateipfad — direkte Dateiausgabe, ohne über einen Provider zu gehen.

Position in der Pipeline. Artefaktauswertung, innerhalb des Basis-Renderings.

Ausgabeform. Eine Datei pro Artefakteintrag, benannt nach dem Schlüssel des Eintrags in der artifacts:-Map. Der Autor des Recipe bestimmt Dateiname und Inhalt direkt.

Status heute: verfügbar laut Status der Sprache → Recipe-Eingabearten. Jeder Eintrag wird nach der Arbeitslast-Synthese und der Quellauflösung mit dem vollständigen Template-Kontext ausgewertet, und die resultierende Datei wird unter dem Schlüssel des Eintrags ausgegeben. Was ein Ziel mit einem ausgegebenen Artefakt tut, hängt von der Fähigkeit ab: Ein Provider, der ein eigenständiges Artefakt akzeptiert, gibt es als eigene Datei aus, während einer, der Artefakte nur zusammen mit einer anderen Eingabeart akzeptiert, den Eintrag in das einfügt, was er assembliert — daher führt ein Inhalt, der nicht die Form hat, die dieser Assembler erwartet, zum Abbruch unter der Kategorie TRANSLATION_ERROR, statt unverändert ausgegeben zu werden. Prüfen Sie das Raster pro Fähigkeit in architecture/16-recipe-input-composition.md, bevor Sie ein Artefakt für eine Fähigkeit schreiben.

Rendering-Reihenfolge

Die sechs Mechanismen laufen in einer definierten Reihenfolge, damit nachgelagerte Mechanismen die Ausgaben vorgelagerter lesen können. Die Reihenfolge:

  1. Auswertung der provides — pro Knoten wird zuerst der locals:-Block des Recipe aufgelöst, in der Reihenfolge des Autors, wobei jeder Eintrag die Einträge über ihm liest; danach werden die provides:-Templates des Knotens ausgewertet, in beliebiger Reihenfolge untereinander (in sich geschlossen: .context.instance_id, .context.rendered_name, wo der Provider des Knotens einen meldet, .values, .infra, die aufgelösten .locals, statischer Text). Die Reihenfolge locals-vor-provides ist das, was es einem provides:-Eintrag ermöglicht, ein local zu lesen und einen aufgelösten Wert zu erhalten.
  2. Veröffentlichung der locals und Quellauflösung — diese locals werden auf .locals veröffentlicht, und das URI-Template source: des Recipe wird gegen sie ausgewertet (wobei der Quellzeiger aufgelöst wird, falls er ein Template ist). Die Quelloberfläche teilt den locals-Kontext, daher liest sie .locals und nicht .provides.
  3. Inject-Mapping — die injectMapping:-Blöcke des FeatureRecipe werden ausgewertet (die Inject-Pipe wird vor dem Rendering des Recipe abgefangen).
  4. Values-Mapping — das valuesMapping: des Recipe wird ausgewertet (quellbasierter Modus + quellloser Modus erzeugen Werte-Dictionaries).
  5. Workload-Synthese — Workload-Synthese des Recipe (Mechanismus 2 gibt Manifeste für den synthetisierten Modus aus).
  6. Artefaktauswertung — Auswertung von artifacts: des Recipe (Mechanismus 6).
  7. Provider-Rendering — der Provider rendert (Mechanismus 1 — der quellbasierte Modus erzeugt flache Manifeste; der quelllose Modus erzeugt generative Manifeste).
  8. Feature-Rendering — Rendering des FeatureRecipe für jede Feature-Anbindung am Knoten (Mechanismen 3 + 4 — die Ressourcenerzeugung läuft hier; die Plugin-Pipeline läuft später, im neunten Schritt).
  9. Die Plugin-Pipeline — Mutation nach dem Rendern: Die pipeline:-Plugin-Schritte des FeatureRecipe wenden RFC-6902-Patches an und geben zusätzliche Ressourcen aus (Mechanismus 4).
  10. Komposition auf Release-Ebene — die Boundary-Assemblierung der Fähigkeit sammelt die Fragmente pro Knoten in Ausgaben pro Boundary (Mechanismus 5).

Die Reihenfolge ist wichtig, weil nachgelagerte Mechanismen die Ausgaben vorgelagerter lesen können — zum Beispiel kann ein Schritt der Plugin-Pipeline ein vom Provider gerendertes Deployment patchen, und ein Composer auf Release-Ebene kann Fragmente zusammenführen, die vom Provider-Rendering, vom Funktions-Rendering und von der Plugin-Pipeline ausgegeben wurden.

Regelsatz zur Kollisionserkennung

Wenn zwei Mechanismen eine Datei mit demselben Namen im selben Boundary-Verzeichnis erzeugen, bricht der Build ab, nennt jeden Beitragenden und meldet dies unter der Kategorie, die jede der folgenden Regeln nennt. Der Regelsatz:

Formregel des Recipe: Kollision der Eintragsschlüssel in artifacts:

Ein Recipe deklariert zwei Einträge unter artifacts: mit demselben Schlüssel (der Schlüssel bestimmt den ausgegebenen Dateinamen, unabhängig davon, ob der Inhalt des Eintrags inline geschrieben oder über $import: geladen wird). Erkannt beim Laden des Recipe laut errors/fatal-halts.md „artifacts: entry keys must be unique (Die Schlüssel der Artefakt-Einträge müssen eindeutig sein)“.

Formregel des Recipe: Kollision zur Ausgabezeit zwischen Eingabearten

Die drei Eingabearten eines Recipe — quellbasiert, synthetisiert und Artefakte — geben jeweils Dateien in dasselbe Boundary-Verzeichnis aus. Wenn quellgerenderte, per Arbeitslast synthetisierte oder als Artefakt ausgegebene Ausgabe eine Datei erzeugt, deren Namen auch eine andere Eingabeart erzeugt hat, bricht der Build bei der Ausgabe ab. Erkannt zur Ausgabezeit laut errors/fatal-halts.md „Emission-time filename collision across input kinds (Dateinamenskollision zur Ausgabezeit zwischen Eingabetypen)“.

Kollision von Compose-Dienstnamen (Release-Ebene)

Wenn zwei verschiedene Knoten (in beliebiger Kombination von Boundaries) Dienste mit demselben Namen zur zusammengeführten compose-Ausgabe beitragen, bricht der compose-Provider beim Komponieren der Boundary unter der Kategorie TRANSLATION_ERROR ab und nennt jedes beitragende Tupel (boundary, node, serviceName). Erkannt bei der Komposition auf Release-Ebene laut dem Abschnitt zur Ausgabe auf Release-Ebene in providers/compose.md.

Ein Dienst wird allein aufgrund des Namens abgelehnt, ohne zu vergleichen, was die beiden Knoten deklariert haben. Ein compose-Dienst ist ein einzelner laufender Container, daher bekommen zwei Knoten, die jeweils einen wollten, gemeinsam nur einen, und die Absicht eines Beitragenden geht verloren, wie identisch die beiden Definitionen auch sein mögen.

Konflikt von Compose-Volume- und -Config-Namen (Release-Ebene)

Wenn zwei verschiedene Knoten einen volumes:- oder configs:-Eintrag der obersten Ebene mit demselben Namen zur zusammengeführten compose-Ausgabe beitragen und die beiden Deklarationen sich unterscheiden, bricht der compose-Provider unter der Kategorie TRANSLATION_ERROR ab und nennt den Eintrag und jedes beitragende Tupel (boundary, node). Erkannt bei der Komposition auf Release-Ebene laut dem Abschnitt zur Ausgabe auf Release-Ebene in providers/compose.md.

Anders als die obige Dienstregel vergleicht diese die Deklarationen, und ein gemeinsamer Name ist legitim, wo die Beitragenden übereinstimmen. Ein benanntes Volume oder eine benannte Config ist ein einziges Objekt, daher haben zwei Knoten, die es identisch deklarieren, beide genau den Eintrag angefordert, mit dem das zusammengeführte Dokument endet, und nichts geht verloren. Zwei Knoten, die es unterschiedlich deklarieren, sind sich über dieses eine Objekt uneinig, und das Beibehalten einer der beiden Deklarationen würde die andere aus einem Build verwerfen, der sonst erfolgreich wäre. Zwei Deklarationen gelten als übereinstimmend, wenn sie denselben Eintrag in der assemblierten Datei beschreiben, daher stimmen ein als leeres Mapping geschriebener Inhalt und ein ganz weggelassener überein.

Alias und Verzeichnis von helm-chart-Sub-Charts

Ein helm-chart-Sub-Chart liegt unter charts/<instance_id>/, und seine Werte sind unter seinem Alias eingeordnet, der die für die Alias-Position codierte Instanz-ID ist. Zwei Instanzen können nur dann beim selben Alias ankommen, wenn ihre Instanz-IDs dieselbe Zeichenkette sind, weil die Codierung die Zeichen, die ein Alias nicht akzeptiert, ausschreibt, statt sie zu ersetzen — daher identifiziert ein Alias genau ein Sub-Chart, und die darunter geschriebenen Werte erreichen nur dieses Sub-Chart. Instanz-IDs sind ihrerseits pro Boundary eindeutig gemäß den Regeln zur Abflachung des Aggregate, daher kann auch das Verzeichnis nicht kollidieren. Beide Hälften sind strukturell: Keine beruht auf einer Prüfung.

Namenskollision von Helm-gerenderten Ressourcen

Innerhalb einer Boundary erzeugen zwei Knoten, die auf denselben Kubernetes-Ressourcennamen rendern, zwei YAML-Dateien mit überlappenden metadata.name-Feldern. Die Dateinamen unterscheiden sich, weil jeder mit seiner eigenen Benennungsbasis als Präfix versehen ist, während sich das metadata.name darin dennoch treffen kann — daher prüft der Build die Namen, die die gerenderten Ressourcen tragen, und zwei Beitragende, die einen Namen für einen kind in einem Namespace ableiten, lassen ihn unter der Kategorie TRANSLATION_ERROR abbrechen, bevor irgendetwas geschrieben wird, wobei der Name und jede Komponente und jede Anbindung genannt werden, die ihn abgeleitet haben (siehe errors/fatal-halts.md).

Der größte Fall ist konstruktionsbedingt geschlossen statt geprüft. Ein quellbasiertes Chart, das seine Ressourcen nach dem Releasenamen benennt, kann dies zwischen zwei Komponenten nicht mehr erzeugen, weil zwei Benennungsbasen, die sich überhaupt unterscheiden, zu zwei Releasenamen führen — siehe providers/helm.md „How the release name is derived (Wie der Release-Name abgeleitet wird)“. Zwei Fälle bleiben, und die obige Prüfung ist das, was sie meldet. Einer ist ein Chart, das einen Ressourcennamen wörtlich in seine Templates schreibt, und keine Ableitung kann einen solchen Namen von irgendeinem anderen Literal unterscheiden. Der andere sind zwei Feature-Anbindungen an einer Komponente, die jeweils ein Chart liefern, das ihr Autor geschrieben hat: Beide rendern gegen den Releasenamen dieser Komponente, absichtlich, daher treffen sich dort zwei Charts, die eine Ressource nach .Release.Name benennen — geben Sie den Ressourcen der beiden Charts unterschiedliche Namen oder binden Sie sie an verschiedene Komponenten an.

Jeder synthetisierte Name beginnt mit der eigenen Identität des Knotens — der des Controller-Objekts und jeder Name pro Ressource über die synthetisierte Service-Namenskonvention <release name>-<svcName> (laut entities/workload.md „Synthesized-name convention (Konvention für synthetisierte Namen)“) —, was Kollisionen zwischen Knoten konstruktionsbedingt strukturell unmöglich macht. Autoren, deren Build bei einem Deployment- / Service-Namen abbricht, sollten zuerst prüfen, ob zwei verschiedene Recipes über unterschiedliche Rendering-Pfade gleichnamige Ressourcen ausgeben (z. B. das templates/deployment.yaml eines quellbasierten Charts, das mit dem metadata.name eines per Arbeitslast synthetisierten Deployment kollidiert).

Muster der Interaktion zwischen Mechanismen

Workload-synthetisiert + Plugin-Pipeline-Patch

Das kanonische Muster: Mechanismus 2 (Arbeitslast-Synthese) gibt ein Basis-Deployment aus; Mechanismus 4 (das Injector-Plugin) wendet einen RFC-6902-Patch an, der ein Secret-Volume in das Deployment einhängt. Die beiden Mechanismen setzen sich zusammen — das Deployment ist dieselbe K8s-Ressource, wobei der Patch ConfigMap- / Secret-Referenzen über die synthetisierte Basis legt.

Dies ist das vorherrschende Muster für die Injektion von Zugangsdaten in synthetisierte Arbeitslasten. Der Fetcher (Mechanismus 3, Ressourcenerzeugung) gibt ein ExternalSecret-CRD aus, das der Cluster zur Laufzeit abruft; der Injector (Mechanismus 4, ein Plugin-Pipeline-Patch) ändert das Deployment, um das resultierende K8s-Secret einzuhängen.

Quellbasiert + Workload-Synthese auf verschiedenen Boundaries

Ein einzelnes Aggregate kann eine Komponente haben, die an ein quellbasiertes helm-Recipe (Mechanismus 1) auf Boundary A gebunden ist, und eine Geschwisterkomponente, die an ein Workload-synthetisierendes helm-Recipe (Mechanismus 2) auf Boundary B gebunden ist. Das Verzeichnis jeder Boundary trägt die passende Ausgabeform; die Dateibenennung über Boundaries hinweg kollidiert nicht, weil die dist/-Verzeichnisse pro Boundary nebeneinander voneinander isoliert sind.

Compose-Zusammenführung auf Release-Ebene pro Ausgabeverzeichnis

Die Assemblierung der compose-Fähigkeit sammelt die Fragmente pro Knoten jeder Boundary, deren Verzeichnis zu ein und demselben Pfad ausgewertet wird, in einer einzigen docker-compose.yaml unter diesem Pfad; zwei auf compose ausgerichtete Boundaries in einem Release schreiben zwei Dateien, wenn sich ihre Verzeichnisse unterscheiden, und eine zusammengeführte Datei, wenn sie sich ein Verzeichnis teilen.

Kollisionen von Dienstnamen werden daher pro Datei erkannt, bei deren Zusammenführung auf Release-Ebene, gemäß der obigen Regel. Zwei auf compose ausgerichtete Boundaries in verschiedenen Verzeichnissen, die jeweils einen Dienst namens api deklarieren, kollidieren nicht: Die Datei jeder Boundary trägt ihren eigenen. Zwei, die sich ein Verzeichnis teilen, schreiben eine Datei, und der Build bricht ab und nennt beide Beitragenden.

Querverweise