RabbitMQ — un Aggregate, due target, autenticazione facoltativa
Questo esempio compila un singolo broker di messaggi RabbitMQ (AMQP) a partire da un unico Aggregate scritto dallo sviluppatore in due target:
- Docker Compose per lo sviluppo locale, e
- Kubernetes, tramite la Recipe helm sintetizzata che esegue direttamente l’immagine upstream ufficiale
rabbitmq(uno StatefulSet con un volume persistente, nessun chart esterno).
Lo stesso aggregate.yaml guida entrambi. Per ogni target cambia solo il livello di Recipe selezionato dal Manifest. Un secondo Aggregate, aggregate-helm-synth-auth.yaml, mostra lo stesso broker su Kubernetes con una credenziale per la password referenziabile associata.
File
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un componente broker di tipo core/messaging/rabbitmq, nessuna credenziale — la Recipe fornisce una password di sviluppo inline deterministica. |
aggregate-auth.yaml | Lo stesso broker con una credenziale inject-value per la password associata allo slot facoltativo password del componente (usata dal target Compose). |
aggregate-helm-synth-auth.yaml | Lo stesso broker con una credenziale per la password referenziabile associata, materializzata come Secret Kubernetes e referenziata dallo StatefulSet (usata dal target Kubernetes). |
manifest-compose.yaml | Mappa il tipo RabbitMQ sulla Recipe Compose (compose/rabbitmq) e la credenziale su dotenv-secret. |
manifest-helm-synth.yaml | Mappa il tipo RabbitMQ sulla Recipe helm sintetizzata (helm/rabbitmq) e la credenziale su k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documenti dell’operatore per i due target, password di sviluppo inline. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Documenti dell’operatore che forniscono la password tramite lo slot di credenziali. |
I riferimenti alle Recipe nei Manifests hanno ambito di provider (compose/rabbitmq, helm/rabbitmq) perché per ciascun provider esiste una Recipe con lo stesso nome.
Che cosa dimostra
- Un’unica superficie di authoring, molti target. Un unico Aggregate è la fonte di verità su che cosa è lo stack. Ogni Manifest dice come realizzarlo.
- Un broker durevole. RabbitMQ rende persistenti code e messaggi, quindi il componente è tipizzato come
stateful-server. Su Kubernetes la Recipe sintetizzata renderizza uno StatefulSet con un volume persistente per replica montato sulla directory dei dati di RabbitMQ e un Service headless per un’identità di rete stabile; il servizio Compose espone il broker per lo sviluppo locale. - Sintesi senza chart (Kubernetes). Il target Kubernetes esegue direttamente l’immagine ufficiale
rabbitmq. Il compilatore sintetizza lo StatefulSet, il Service ClusterIP e il Service headless a partire dal dimensionamentoinfradel componente — nessun chart esterno da reperire o da seguire. Il tag dell’immagine è fissato tramiteinfra.engine_version, quindi il rendering non contiene alcun tag flottante. - Entrambe le porte del broker. L’immagine ha la gestione abilitata, quindi il broker espone la porta AMQP (5672) e la dashboard di gestione (15672) sul container e sul Service ClusterIP.
- Credenziali deterministiche. RabbitMQ richiede sempre l’autenticazione. Quando non è associata alcuna credenziale, ciascuna Recipe fornisce una password di sviluppo inline fissa, così il rendering è identico byte per byte tra un’esecuzione e l’altra. Quando è associata una credenziale, il valore iniettato imposta la password del broker: su Compose diventa la variabile d’ambiente del servizio
RABBITMQ_DEFAULT_PASS; su Kubernetes viene materializzato come Secret e referenziato da unsecretKeyRefenv, così il testo in chiaro non finisce mai nel manifest renderizzato.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example rabbitmq-brokerPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd rabbitmq-brokerBuild
Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard vengono risolte dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo; --auto-pull scrive durante il build il lockfile che manca a un clone appena creato:
# 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-pullGli artefatti renderizzati finiscono sotto dist/.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella Workspace non contiene ancora una cartella `rabbitmq-broker`, chiama una volta lo strumento `scaffold` con `example` impostato a `rabbitmq-broker` e senza `dir`: scrive l’esempio in una nuova cartella `rabbitmq-broker`. Poi chiama lo strumento `build` una volta per ogni Release, in quest’ordine — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` e `release-helm-synth-auth.yaml` — ogni volta con `workspace_root` impostato a `rabbitmq-broker`, `release` impostato a quel file, `auto_pull` impostato a true e `write` impostato a true. Dimmi quali file ha scritto ogni build; si trovano in `rabbitmq-broker/dist/`.Nota sulla consegna delle credenziali
Su Compose la credenziale è un segreto inject-value: il suo valore viene consegnato sulla pipe d’ambiente del componente e diventa la variabile d’ambiente del servizio RABBITMQ_DEFAULT_PASS. Su Kubernetes la credenziale è referenziabile: viene materializzata come Secret Kubernetes, e lo StatefulSet vi fa riferimento tramite un secretKeyRef env, così la password in chiaro non compare mai nel manifest del carico di lavoro. Il valore origin negli Aggregates di autenticazione è un segnaposto di sviluppo; fornisci un valore reale tramite la tua sorgente di credenziali per qualsiasi distribuzione reale. Anche la password di sviluppo inline usata quando non è associata alcuna credenziale è destinata esclusivamente all’uso locale.