RabbitMQ — un Aggregate, dos destinos, autenticación opcional
Este ejemplo compila un único broker de mensajes RabbitMQ (AMQP) a partir de un único Aggregate escrito por el desarrollador a dos destinos:
- Docker Compose para el desarrollo local, y
- Kubernetes, mediante la Recipe helm sintetizada que ejecuta directamente la imagen upstream oficial
rabbitmq(un StatefulSet con un volumen persistente, sin chart externo).
El mismo aggregate.yaml impulsa ambos. Solo cambia por destino la capa de Recipe que selecciona el Manifest. Un segundo Aggregate, aggregate-helm-synth-auth.yaml, muestra el mismo broker en Kubernetes con una credencial de contraseña referenciable vinculada.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un componente broker de tipo core/messaging/rabbitmq, sin credencial — la Recipe proporciona una contraseña de desarrollo determinista escrita en línea. |
aggregate-auth.yaml | El mismo broker con una credencial de contraseña inject-value vinculada a la ranura opcional password del componente (la usa el destino Compose). |
aggregate-helm-synth-auth.yaml | El mismo broker con una credencial de contraseña referenciable vinculada, materializada como un Secret de Kubernetes y referenciada por el StatefulSet (la usa el destino Kubernetes). |
manifest-compose.yaml | Asigna el tipo RabbitMQ a la Recipe de Compose (compose/rabbitmq) y la credencial a dotenv-secret. |
manifest-helm-synth.yaml | Asigna el tipo RabbitMQ a la Recipe helm sintetizada (helm/rabbitmq) y la credencial a k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documentos del operador para los dos destinos, contraseña de desarrollo escrita en línea. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Documentos del operador que proporcionan la contraseña a través de la ranura de credenciales. |
Las referencias a Recipe en los Manifests tienen ámbito de proveedor (compose/rabbitmq, helm/rabbitmq) porque existe una Recipe con el mismo nombre para cada proveedor.
Lo que demuestra
- Una única superficie de autoría, muchos destinos. Un único Aggregate es la fuente de verdad sobre qué es el stack. Cada Manifest dice cómo realizarlo.
- Un broker duradero. RabbitMQ persiste colas y mensajes, así que el componente se tipa como
stateful-server. En Kubernetes la Recipe sintetizada renderiza un StatefulSet con un volumen persistente por réplica montado en el directorio de datos de RabbitMQ y un Service headless para una identidad de red estable; el servicio de Compose expone el broker para el desarrollo local. - Síntesis sin chart (Kubernetes). El destino Kubernetes ejecuta directamente la imagen oficial
rabbitmq. El compilador sintetiza el StatefulSet, el Service ClusterIP y el Service headless a partir del dimensionamientoinfradel componente — sin chart externo que obtener ni seguir. El tag de la imagen se fija medianteinfra.engine_version, así que el renderizado no lleva ningún tag flotante. - Ambos puertos del broker. La imagen tiene la gestión habilitada, así que el broker expone el puerto AMQP (5672) y el panel de gestión (15672) en el contenedor y en el Service ClusterIP.
- Credenciales deterministas. RabbitMQ siempre autentica. Cuando no hay ninguna credencial vinculada, cada Recipe proporciona una contraseña de desarrollo fija escrita en línea, así que el renderizado es idéntico byte a byte entre ejecuciones. Cuando hay una credencial vinculada, el valor inyectado establece la contraseña del broker: en Compose se convierte en la variable de entorno del servicio
RABBITMQ_DEFAULT_PASS; en Kubernetes se materializa como un Secret y se referencia mediante unsecretKeyRefde entorno, así que el texto plano nunca acaba en el manifiesto renderizado.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example rabbitmq-brokerDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd rabbitmq-brokerCompilación
Este workspace no lleva ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no se necesita ningún flag de catálogo; --auto-pull escribe durante la compilación el lockfile que le falta a un clon recién creado:
# 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-pullLos artefactos renderizados quedan en dist/.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta Workspace aún no contiene una carpeta `rabbitmq-broker`, llama una vez a la herramienta `scaffold` con `example` establecido en `rabbitmq-broker` y sin `dir`: escribe el ejemplo en una nueva carpeta `rabbitmq-broker`. Luego llama a la herramienta `build` una vez por cada Release, en este orden — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` y `release-helm-synth-auth.yaml` — cada vez con `workspace_root` establecido en `rabbitmq-broker`, `release` establecido en ese archivo, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió cada compilación; están en `rabbitmq-broker/dist/`.Nota sobre la entrega de credenciales
En Compose la credencial es un secreto inject-value: su valor se entrega por la tubería de entorno del componente y se convierte en la variable de entorno del servicio RABBITMQ_DEFAULT_PASS. En Kubernetes la credencial es referenciable: se materializa como un Secret de Kubernetes, y el StatefulSet hace referencia a él mediante un secretKeyRef de entorno, así que la contraseña en texto plano nunca aparece en el manifiesto de la carga de trabajo. El valor origin de los Aggregates de autenticación es un marcador de posición de desarrollo; proporciona un valor real a través de tu fuente de credenciales para cualquier despliegue real. La contraseña de desarrollo escrita en línea que se usa cuando no hay ninguna credencial vinculada es igualmente solo para uso local.