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
rabbitmqdirekt 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
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine Komponente broker vom Typ core/messaging/rabbitmq, keine Zugangsdaten — das Recipe liefert ein deterministisches, inline angegebenes Entwicklungspasswort. |
aggregate-auth.yaml | Derselbe 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.yaml | Derselbe Broker mit angebundenen referenzierbaren Zugangsdaten für das Passwort, als Kubernetes-Secret materialisiert und vom StatefulSet referenziert (vom Kubernetes-Ziel verwendet). |
manifest-compose.yaml | Bildet den RabbitMQ-Typ auf das Compose-Recipe (compose/rabbitmq) und die Zugangsdaten auf dotenv-secret ab. |
manifest-helm-synth.yaml | Bildet 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.yaml | Dokumente des Operators für die beiden Ziele, inline angegebenes Entwicklungspasswort. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Dokumente 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-servertypisiert. 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
rabbitmqdirekt aus. Der Compiler synthetisiert das StatefulSet, den ClusterIP-Service und den Headless-Service aus der Dimensionierunginfrader Komponente — kein externes Chart, das beschafft oder verfolgt werden muss. Der Image-Tag wird überinfra.engine_versionfixiert, 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 einensecretKeyRefin 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:
aggrega scaffold --example rabbitmq-brokerDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd rabbitmq-brokerBuild
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:
# Local development (Docker Compose), inline development passwordaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline passwordaggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attachedaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullGerenderte 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.