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

RabbitMQ — ein Aggregate, zwei Ziele, optionale Authentifizierung

Dieses Beispiel kompiliert einen einzelnen RabbitMQ-Message-Broker (AMQP) aus einem einzigen vom Entwickler verfassten Aggregate zu zwei Zielen:

  • Docker Compose für die lokale Entwicklung und
  • Kubernetes, über das synthetisierte helm-Recipe, das das offizielle Upstream-Image rabbitmq direkt ausführt (ein StatefulSet mit einem persistenten Volume, kein externes Chart).

Dasselbe aggregate.yaml steuert beide. Pro Ziel ändert sich nur die vom Manifest ausgewählte Recipe-Schicht. Ein zweites Aggregate, aggregate-helm-synth-auth.yaml, zeigt denselben Broker auf Kubernetes mit angebundenen referenzierbaren Zugangsdaten für das Passwort.

Dateien

DateiRolle
aggregate.yamlEntwicklerabsicht: eine Komponente broker vom Typ core/messaging/rabbitmq, keine Zugangsdaten — das Recipe liefert ein deterministisches, inline angegebenes Entwicklungspasswort.
aggregate-auth.yamlDerselbe Broker mit Zugangsdaten vom Typ inject-value für das Passwort, angebunden an den optionalen Slot password der Komponente (vom Compose-Ziel verwendet).
aggregate-helm-synth-auth.yamlDerselbe Broker mit angebundenen referenzierbaren Zugangsdaten für das Passwort, als Kubernetes-Secret materialisiert und vom StatefulSet referenziert (vom Kubernetes-Ziel verwendet).
manifest-compose.yamlBildet den RabbitMQ-Typ auf das Compose-Recipe (compose/rabbitmq) und die Zugangsdaten auf dotenv-secret ab.
manifest-helm-synth.yamlBildet den RabbitMQ-Typ auf das synthetisierte helm-Recipe (helm/rabbitmq) und die Zugangsdaten auf k8s-secret-from-parameter ab.
release-compose.yaml / release-helm-synth.yamlDokumente des Operators für die beiden Ziele, inline angegebenes Entwicklungspasswort.
release-compose-auth.yaml / release-helm-synth-auth.yamlDokumente des Operators, die das Passwort über den Slot für Zugangsdaten liefern.

Die Recipe-Referenzen in den Manifests sind auf den Provider bezogen (compose/rabbitmq, helm/rabbitmq), weil für jeden Provider ein Recipe desselben Namens existiert.

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 dauerhafter Broker. RabbitMQ persistiert Warteschlangen und Nachrichten, daher ist die Komponente als stateful-server typisiert. Auf Kubernetes rendert das synthetisierte Recipe ein StatefulSet mit einem persistenten Volume pro Replica, das im Datenverzeichnis von RabbitMQ eingehängt ist, und einen Headless-Service für eine stabile Netzwerkidentität; der Compose-Service stellt den Broker für die lokale Entwicklung bereit.
  • Synthese ohne Chart (Kubernetes). Das Kubernetes-Ziel führt das offizielle Image rabbitmq direkt aus. Der Compiler synthetisiert das StatefulSet, den ClusterIP-Service und den Headless-Service aus der Dimensionierung infra der Komponente — kein externes Chart, das beschafft oder verfolgt werden muss. Der Image-Tag wird über infra.engine_version fixiert, sodass das Rendering keinen gleitenden Tag enthält.
  • Beide Broker-Ports. Das Image hat die Verwaltung aktiviert, daher stellt der Broker den AMQP-Port (5672) und das Verwaltungs-Dashboard (15672) am Container und am ClusterIP-Service bereit.
  • Deterministische Zugangsdaten. RabbitMQ authentifiziert immer. Sind keine Zugangsdaten angebunden, liefert jedes Recipe ein festes, inline angegebenes Entwicklungspasswort, sodass das Rendering über Läufe hinweg byteidentisch ist. Sind Zugangsdaten angebunden, setzt der injizierte Wert das Broker-Passwort: Auf Compose wird er zur Service-Umgebungsvariable RABBITMQ_DEFAULT_PASS; auf Kubernetes wird er als Secret materialisiert und über einen secretKeyRef in der Umgebung referenziert, sodass der Klartext nie im gerenderten Manifest landet.

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 rabbitmq-broker

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

Terminal window
cd rabbitmq-broker

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), inline development password
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline password
aggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attached
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 `rabbitmq-broker` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `rabbitmq-broker` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `rabbitmq-broker`. Rufen Sie dann 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 `rabbitmq-broker`, `release` auf die jeweilige Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die jeder Build geschrieben hat; sie liegen unter `rabbitmq-broker/dist/`.

Hinweis zur Zustellung der Zugangsdaten

Auf Compose sind die Zugangsdaten ein Secret vom Typ inject-value: Sein Wert wird über die Umgebungs-Pipe der Komponente zugestellt und wird zur Service-Umgebungsvariable RABBITMQ_DEFAULT_PASS. Auf Kubernetes sind die Zugangsdaten referenzierbar: Sie werden als Kubernetes-Secret materialisiert, und das StatefulSet referenziert es über einen secretKeyRef in der Umgebung, sodass das Klartext-Passwort nie im Manifest der Arbeitslast erscheint. Der Wert origin in den Authentifizierungs-Aggregates ist ein Platzhalter für die Entwicklung; liefern Sie für jede reale Bereitstellung einen echten Wert über Ihre Zugangsdatenquelle. Das inline angegebene Entwicklungspasswort, das verwendet wird, wenn keine Zugangsdaten angebunden sind, ist ebenso nur für die lokale Nutzung gedacht.