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

NATS — ein Aggregate, zwei Ziele, optionale Authentifizierung

Dieses Beispiel kompiliert einen einzelnen NATS-Messaging-Server (Pub-Sub, Request-Reply, Queueing) aus einem einzigen vom Entwickler verfassten Aggregate zu zwei Realisierungen:

  • Docker Compose für die lokale Entwicklung und
  • das synthetisierte helm-Recipe, das das offizielle Upstream-Image nats direkt auf Kubernetes ausführt (kein externes Chart).

Das synthetisierte helm-Recipe ist der bevorzugte Kubernetes-Pfad: Es hängt nur von einem offiziellen Image-Tag statt von einem Chart eines Drittanbieters ab, und seine gerenderte Ressourcenmenge ist genau das, was die Arbeitslast deklariert.

Dasselbe aggregate.yaml steuert beide. Pro Realisierung ändert sich nur die vom Manifest ausgewählte Recipe-Schicht. Ein zweites Aggregate, aggregate-auth.yaml, zeigt denselben Server mit angebundenen Zugangsdaten vom Typ inject-value für das Passwort für den Compose-Pfad; aggregate-helm-synth-auth.yaml bindet referenzierbare Zugangsdaten für den synthetisierten helm-Pfad an.

Dateien

DateiRolle
aggregate.yamlEntwicklerabsicht: eine Komponente bus vom Typ core/messaging/nats, keine Zugangsdaten — der Server läuft ohne Authentifizierung.
aggregate-auth.yamlDerselbe Server mit Zugangsdaten vom Typ inject-value für das Passwort, angebunden an den optionalen Slot password der Komponente (Compose-Pfad).
aggregate-helm-synth-auth.yamlDerselbe Server mit referenzierbaren Zugangsdaten, angebunden für den synthetisierten helm-Pfad — der Wert wird als Kubernetes-Secret materialisiert, das das Deployment referenziert.
manifest-compose.yamlBildet den NATS-Typ auf das Compose-Recipe (compose/nats) und die Zugangsdaten auf dotenv-secret ab.
manifest-helm-synth.yamlBildet den NATS-Typ auf das synthetisierte helm-Recipe (helm/nats) und die Zugangsdaten auf k8s-secret-from-parameter ab.
release-compose.yaml / release-helm-synth.yamlDokumente des Operators für die beiden Realisierungen, ohne Authentifizierung.
release-compose-auth.yaml / release-helm-synth-auth.yamlBetreiber-Datensätze, die die Authentifizierung aktivieren.

Was es zeigt

  • Eine Authoring-Oberfläche, viele Ziele. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was der Stack ist. Jedes Manifest sagt, wie er zu realisieren ist.
  • Ein zustandsloser Messaging-Server. In dieser schlanken Form leitet NATS Subjects im Speicher weiter, mit deaktiviertem JetStream-Dateispeicher, daher ist die Komponente als server typisiert. Auf Kubernetes rendert das synthetisierte Recipe ein Deployment mit einer einzigen Replica und ohne persistentes Volume; der Compose-Service stellt den Server für die lokale Entwicklung bereit.
  • Workload-Synthese (Kubernetes). Das synthetisierte helm-Recipe deklariert eine Workload — ein Deployment plus einen ClusterIP-Service, der das offizielle Image nats ausführt —, die der helm-Provider ohne externes Chart in Kubernetes-Manifeste übersetzt. Die gerenderte Ressourcenmenge ist genau das, was die Workload deklariert. Da der Name nats sowohl von einem Compose- als auch von einem synthetisierten helm-Recipe getragen wird, referenzieren die Manifests sie auf den Provider bezogen als compose/nats und helm/nats.
  • Optionale Authentifizierung, in jedem Fall deterministisch. Die NATS-Authentifizierung ist standardmäßig ausgeschaltet. Sind keine Zugangsdaten angebunden, aktiviert keine der beiden Realisierungen die Authentifizierung, und das Rendering ist über Läufe hinweg byteidentisch. Sind Zugangsdaten angebunden, aktiviert der injizierte Wert die Benutzer/Passwort-Authentifizierung auf beiden Realisierungen.

Das Beispiel generieren

Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.

Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:

Terminal window
aggrega scaffold --example nats-messaging

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd nats-messaging

Build

Dieser Workspace enthält kein .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig; --auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt:

Terminal window
# Local development (Docker Compose), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.yaml --auto-pull

Gerenderte Artefakte landen unter dist/.

Mit einem KI-Assistenten

Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.

Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `nats-messaging` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `nats-messaging` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `nats-messaging`. Rufen Sie anschließend das Tool `build` einmal für jedes Release auf, in dieser Reihenfolge — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` und `release-helm-synth-auth.yaml` —, jedes Mal mit `workspace_root` auf `nats-messaging`, `release` auf diese Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir, welche Dateien jeder Build geschrieben hat; sie liegen unter `nats-messaging/dist/`.

Hinweis zur Zustellung der Zugangsdaten

Auf dem Compose-Pfad sind die Zugangsdaten ein Secret vom Typ inject-value (aggregate-auth.yaml): Sein Wert wird über die Umgebungs-Pipe der Komponente zugestellt, und der Server wird mit Flags für die Benutzer/Passwort-Authentifizierung gestartet.

Der synthetisierte helm-Pfad verwendet referenzierbare Zugangsdaten (aggregate-helm-synth-auth.yaml): Der Wert wird als Kubernetes-Secret materialisiert, das Deployment referenziert es über einen secretKeyRef in der Umgebung, und der Server wird mit den Flags --user/--pass gestartet, die diese Umgebungsvariable lesen. Das Klartext-Passwort erscheint daher nie im Deployment-Manifest — nur im Secret.

Der Wert origin in den authentifizierten Aggregates ist ein Platzhalter für die Entwicklung; liefern Sie für jede reale Bereitstellung einen echten Wert über Ihre Zugangsdatenquelle.