Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

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

FichierRôle
aggregate.yamlIntention 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.yamlLe 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.yamlLe 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.yamlAssocie le type RabbitMQ à la Recipe Compose (compose/rabbitmq) et l’information d’identification à dotenv-secret.
manifest-helm-synth.yamlAssocie 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.yamlDocuments 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.yamlDocuments 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 dimensionnement infra du composant — aucun chart externe à récupérer ou à suivre. Le tag d’image est épinglé via infra.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 un secretKeyRef d’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 :

Terminal window
aggrega scaffold --example rabbitmq-broker

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd rabbitmq-broker

Build

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 :

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

Les 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.