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

Entitäten nach Rolle

Jede Entitätsart hat eine Rolle, die sie typischerweise verfasst. Diese Seite ist die vollständige Übersicht — greifen Sie zu ihr, wenn Sie Ihr Anliegen kennen, aber noch nicht wissen, in welche Datei es gehört. Die Rollenzuordnung ist eine Orientierung, keine Durchsetzung durch den Compiler (siehe Personas); sie nennt, wem eine Art in einem gut strukturierten Setup üblicherweise gehört.

Die Übersicht auf einen Blick

RolleEntitätsartenAnliegen
EntwicklerAggregateAnwendungsabsicht: was die App ist und was sie braucht
PlattformarchitektComponent, FeatureDer wiederverwendbare, versionierte Katalogvertrag
PlattformbetriebRecipe, FeatureRecipe, providerrenderndes PluginProvider-spezifische Übersetzung in gerenderte Infrastruktur
PlattformoperatorManifest, ReleaseRouting und Verdrahtung der Bereitstellung
Querschnittliche UnterstützungSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, WorkloadGemeinsame Formen, Erweiterungscode und die plattformeigene Compiler-Art

Entwickler

Aggregate — die einzige Authoring-Oberfläche des Entwicklers und die einzige Quelle der Wahrheit für die Anwendungstopologie. Es deklariert die Komponenten, aus denen die Anwendung aufgebaut ist, die values, die jede von ihnen annimmt, die Features, deren Verhalten Anwendungsabsicht ist (mit ihren values), die für umgebungsspezifische Variation bereitgestellten parameters und die uses-Kanten, die Komponenten miteinander verbinden. Es bleibt bewusst agnostisch gegenüber physischer Infrastruktur: Nichts im Aggregate nennt eine Cloud, einen Cluster oder einen Provider. Diese Agnostik gegenüber Fähigkeiten ist es, die ein Aggregate überall bereitstellbar macht.

Plattformarchitekt

Component — ein wiederverwendbarer, versionierter Vertrag für eine Art von Baustein. Sie deklariert über ein JSON Schema die values, die ein Entwickler angeben darf, die provides-Ausgaben, die sie an Konsumenten weiterleitet, und die usesSchema-Sockets, die sie für die Verdrahtung bereitstellt. Components tragen die semantischen Labels, die Richtlinien und Rendering steuern. Der Architekt hält den Vertrag der Component stabil, damit sich Entwickler auf ihn verlassen können.

Feature — eine anhängbare Fähigkeit, die ein Entwickler oder Operator einer Komponente hinzufügen kann: ein Metrik-Exporter, das Maskieren sensibler Texte an einem KI-Gateway, eine Credential-Bindung. Ein Feature deklariert, was es braucht und womit es inkompatibel ist; wie es realisiert wird — die Ressourcen, die es erzeugt, oder die Einstellungen, die es in das schreibt, was seine Komponente bereits rendert —, liegt in seinem FeatureRecipe.

Plattformbetrieb

Recipe — die providerspezifische Realisierung einer Component. Es bildet die deklarierten Werte der Component über Templates auf die Ausgabe eines konkreten Providers ab — ein Helm-Release, einen Compose-Service, ein Terraform-Modul — und leitet provides-Werte an Konsumenten weiter. Ein Recipe ändert nie die entwicklerseitigen Werte, die eine Component deklariert; es entscheidet nur, wie sie gerendert werden.

FeatureRecipe — die providerspezifische Realisierung eines Feature, angewendet zum Zeitpunkt der Bindung. Es erzeugt die Ressourcen, die das Anhängen eines Feature für einen bestimmten Provider impliziert, oder schreibt die implizierten Einstellungen in das, was die angehängte Komponente bereits rendert.

Provider-renderndes Plugin — ein Provider ist der Wasm-Gast, der die Eingabe eines Recipe in providernative Manifeste umwandelt. Er wird als Plugin mit pluginType: provider geliefert, das den oder die Provider-Namen, die es rendert, und seinen Provider-Socket-Vertrag deklariert. Der Betrieb (oder ein Plugin-Autor) stellt Provider bereit, damit Recipes einen Provider haben, gegen den sie gerendert werden. Siehe die Providers-Übersicht für die mitgelieferten Provider und ihre Verträge.

Anmeldedaten sicher in einem Recipe lesen

Anmeldedaten erreichen ein Recipe über die Inject-Pipe, .context.inject.env, als beliebiger Text, den ihr Autor gewählt hat, sodass sie Zeichen enthalten können, die eine Vorlage nicht unverändert in YAML schreiben kann. In einem Skalar in doppelten Anführungszeichen beendet ein doppeltes Anführungszeichen den Wert vorzeitig, und ein Backslash leitet eine Escape-Sequenz ein: Der Build bricht ab, oder der Backslash geht stillschweigend verloren. Maskieren Sie beides dort, wo der Wert geschrieben wird:

variables:
{{- $env := optional (default dict .context.inject) "env" dict }}
DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"

optional liest den Schlüssel mit einem leeren Fallback aus der Map der Pipe, sodass ein Passwort, das nichts geliefert hat, als leerer Text gerendert wird. Die beiden Aufrufe von replace maskieren zuerst den Backslash und dann das Anführungszeichen, in dieser Reihenfolge, damit die Maskierung des Anführungszeichens selbst nicht erneut maskiert wird, und lassen jedes andere Zeichen unverändert. Ein über index gelesener Wert, das bei fehlendem Schlüssel abbricht, erhält dieselben beiden Aufrufe von replace unverändert.

Ein Zeichen, das diese Form nicht transportiert, ist ein Zeilenumbruch. YAML faltet einen Zeilenumbruch in einem Skalar in doppelten Anführungszeichen zu einem Leerzeichen, sodass Anmeldedaten mit einem Zeilenumbruch mit einem Leerzeichen an dessen Stelle geliefert werden. Ein FeatureRecipe, das Anmeldedaten in sein injectMapping schreibt, schreibt sie stattdessen über toJson, das ein Anführungszeichen, einen Backslash und einen Zeilenumbruch gleichermaßen transportiert, wie die Referenz zum FeatureRecipe zeigt.

Dieses FeatureRecipe schreibt die Anmeldedaten unter den Mechanismus, aus dem das Recipe sie liest — env: für .context.inject.env, file:, arg: oder einen eigenen Mechanismus der Komponente unter dessen eigenem Namen. .context.inject.all wird aus diesen Mechanismen aufgebaut und nie aus der Ausgabe eines Mappings, sodass ein Mapping, das unter all: schreibt, nichts liefern würde; der Build bricht stattdessen daran ab und nennt die Anbindung, den Schlüssel und das FeatureRecipe.

Plattformoperator

Manifest — die Routing-Schicht. Es teilt dem Compiler mit, welches Recipe jede Component für ein gegebenes Ziel realisiert, sodass dasselbe Aggregate in verschiedenen Umgebungen auf unterschiedliche Implementierungen gerichtet werden kann — ein Cloud-Recipe für die Produktion, ein Compose-Recipe für lokale Tests —, ohne Änderung an der Datei des Entwicklers.

Release — die einzige Kompilierungseingabe, die festhält, was eine Umgebung baut. Es verweist auf das Aggregate und das Manifest, erfüllt die vom Entwickler bereitgestellten parameters, hängt die Features an, deren Eingaben betrieblicher Natur sind, dimensioniert mit infra diejenigen, die der Entwickler angehängt hat, und verdrahtet eigene Kanten innerhalb der vom Architekten deklarierten Sockets. Ein Release erfüllt bereitgestellte Variationspunkte; es kann keine neuen Anwendungs-values und keine neue Rechenleistung einführen — diese stammen ausschließlich aus dem Aggregate.

Querschnittliche Unterstützungsarten

Diese Arten dienen Autoren rollenübergreifend, statt zu einer einzigen Rolle zu gehören.

SchemaLibrary — eine gemeinsame Bibliothek von Schemaformen, die in vielen Components und Features wiederkehren. Wenn dieselbe Struktur (etwa ein Block für Pod-Ressourcen) in vielen Entitäten vorkommt, lagert ein Architekt sie in einen SchemaLibrary-Eintrag aus, damit sie einmal definiert und aktualisiert wird.

MappingLibrary — eine gemeinsame Bibliothek wiederverwendbarer Mapping-Logik, auf die Recipes und FeatureRecipes zurückgreifen, sodass gängige Übersetzungsmuster eine einzige Quelle haben, statt kopiert zu werden.

WorkloadLibrary — eine gemeinsame Bibliothek wiederverwendbarer Workload-Inhalte, sodass eine Bereitstellungsform, die in vielen Recipes wiederkehrt, einmal deklariert und in jeden workload:-Block importiert wird.

ArtifactLibrary — eine gemeinsame Bibliothek wiederverwendbarer Artefakt-Bundles: benannte Sätze zusammengehöriger Hilfsausgabedateien, etwa eine CRD mit ihrem RBAC. Ein Recipe oder FeatureRecipe importiert ein Bundle an einem artifacts:-Eintrag und gibt jede darin enthaltene Datei aus.

Plugin — die Erweiterungsart. Über das Provider-Rendering hinaus verpacken Plugins den WebAssembly-Code, der domänenspezifische Intelligenz liefert — Richtlinienvalidierung, Mutation, Linting und weitere Sockets. Das Verfassen eines Plugin ist eine Aufgabe des Plattformteams, die jede andere Rolle unterstützt.

Workload — eine plattformeigene Compiler-Art, keine Datei, die ein Entwickler oder Operator als Entität der obersten Ebene von Hand schreibt. Sie wird im workload:-Block eines Recipe verwendet, wo der Provider, mit dem das Recipe rendert, die normalisierte Workload-Form in seine native Form übersetzt. Recipe-Autoren interagieren über diesen Block mit ihr; die Workload-Referenz dokumentiert die Form.

Weiter