RabbitMQ — un Aggregate, deux cibles, authentification facultative
Cet exemple compile un seul broker de messages RabbitMQ (AMQP) à partir d’un seul Aggregate écrit par le développeur vers deux cibles :
- Docker Compose pour le développement local, et
- Kubernetes, via la Recipe helm synthétisée qui exécute directement l’image upstream officielle
rabbitmq(un StatefulSet avec un volume persistant, aucun chart externe).
Le même aggregate.yaml pilote les deux. Seule la couche de Recipe sélectionnée par le Manifest change d’une cible à l’autre. Un second Aggregate, aggregate-helm-synth-auth.yaml, montre le même broker sur Kubernetes avec une information d’identification de mot de passe référençable rattachée.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un composant broker de type core/messaging/rabbitmq, sans information d’identification — la Recipe fournit un mot de passe de développement déterministe écrit en ligne. |
aggregate-auth.yaml | Le même broker avec une information d’identification inject-value de mot de passe rattachée à l’emplacement facultatif password du composant (utilisé par la cible Compose). |
aggregate-helm-synth-auth.yaml | Le même broker avec une information d’identification de mot de passe référençable rattachée, matérialisée sous forme de Secret Kubernetes et référencée par le StatefulSet (utilisé par la cible Kubernetes). |
manifest-compose.yaml | Associe le type RabbitMQ à la Recipe Compose (compose/rabbitmq) et l’information d’identification à dotenv-secret. |
manifest-helm-synth.yaml | Associe le type RabbitMQ à la Recipe helm synthétisée (helm/rabbitmq) et l’information d’identification à k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documents de l’opérateur pour les deux cibles, mot de passe de développement écrit en ligne. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Documents de l’opérateur qui fournissent le mot de passe via l’emplacement d’identifiants. |
Les références de Recipe dans les Manifests ont une portée de fournisseur (compose/rabbitmq, helm/rabbitmq) parce qu’une Recipe du même nom existe pour chaque fournisseur.
Ce qu’il démontre
- Une seule surface de rédaction, plusieurs cibles. Un seul Aggregate est la source de vérité sur ce qu’est la stack. Chaque Manifest dit comment la réaliser.
- Un broker durable. RabbitMQ rend persistants les files d’attente et les messages, si bien que le composant est typé comme
stateful-server. Sur Kubernetes, la Recipe synthétisée rend un StatefulSet avec un volume persistant par réplique monté sur le répertoire de données de RabbitMQ et un Service headless pour une identité réseau stable ; le service Compose expose le broker pour le développement local. - Synthèse sans chart (Kubernetes). La cible Kubernetes exécute directement l’image officielle
rabbitmq. Le compilateur synthétise le StatefulSet, le Service ClusterIP et le Service headless à partir du dimensionnementinfradu composant — aucun chart externe à récupérer ou à suivre. Le tag d’image est épinglé viainfra.engine_version, si bien que le rendu ne comporte aucun tag flottant. - Les deux ports du broker. L’image a la gestion activée, si bien que le broker expose le port AMQP (5672) et le tableau de bord de gestion (15672) sur le conteneur et sur le Service ClusterIP.
- Des informations d’identification déterministes. RabbitMQ authentifie toujours. Lorsqu’aucune information d’identification n’est rattachée, chaque Recipe fournit un mot de passe de développement fixe écrit en ligne, si bien que le rendu est identique octet par octet d’une exécution à l’autre. Lorsqu’une information d’identification est rattachée, la valeur injectée définit le mot de passe du broker : sur Compose, elle devient la variable d’environnement de service
RABBITMQ_DEFAULT_PASS; sur Kubernetes, elle est matérialisée sous forme de Secret et référencée par unsecretKeyRefd’environnement, si bien que le texte en clair n’atterrit jamais dans le manifeste rendu.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example rabbitmq-brokerElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd rabbitmq-brokerBuild
Ce workspace ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard sont résolues depuis le registre du hub, hub.aggrega.ai, et aucune option de catalogue n’est nécessaire ; --auto-pull écrit pendant le build le lockfile qui manque à un clone récent :
# 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-pullLes artefacts rendus atterrissent sous dist/.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier Workspace ne contient pas encore de dossier `rabbitmq-broker`, appelez une fois l’outil `scaffold` avec `example` défini sur `rabbitmq-broker` et sans `dir` : il écrit l’exemple dans un nouveau dossier `rabbitmq-broker`. Appelez ensuite l’outil `build` une fois pour chaque Release, dans cet ordre — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` et `release-helm-synth-auth.yaml` — en définissant à chaque fois `workspace_root` sur `rabbitmq-broker`, `release` sur ce fichier, `auto_pull` sur true et `write` sur true. Indiquez-moi quels fichiers chaque build a écrits ; ils se trouvent sous `rabbitmq-broker/dist/`.Note sur la livraison des informations d’identification
Sur Compose, l’information d’identification est un secret inject-value : sa valeur est livrée sur le pipe d’environnement du composant et devient la variable d’environnement de service RABBITMQ_DEFAULT_PASS. Sur Kubernetes, l’information d’identification est référençable : elle est matérialisée sous forme de Secret Kubernetes, et le StatefulSet la référence via un secretKeyRef d’environnement, si bien que le mot de passe en clair n’apparaît jamais dans le manifeste de la charge de travail. La valeur origin dans les Aggregates d’authentification est un espace réservé de développement ; fournissez une valeur réelle via votre source d’informations d’identification pour tout déploiement réel. Le mot de passe de développement écrit en ligne, utilisé lorsqu’aucune information d’identification n’est rattachée, est de même réservé à un usage local.