Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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

FileRuolo
aggregate.yamlIntento dello sviluppatore: un componente broker di tipo core/messaging/rabbitmq, nessuna credenziale — la Recipe fornisce una password di sviluppo inline deterministica.
aggregate-auth.yamlLo 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.yamlLo stesso broker con una credenziale per la password referenziabile associata, materializzata come Secret Kubernetes e referenziata dallo StatefulSet (usata dal target Kubernetes).
manifest-compose.yamlMappa il tipo RabbitMQ sulla Recipe Compose (compose/rabbitmq) e la credenziale su dotenv-secret.
manifest-helm-synth.yamlMappa il tipo RabbitMQ sulla Recipe helm sintetizzata (helm/rabbitmq) e la credenziale su k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocumenti dell’operatore per i due target, password di sviluppo inline.
release-compose-auth.yaml / release-helm-synth-auth.yamlDocumenti 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 dimensionamento infra del componente — nessun chart esterno da reperire o da seguire. Il tag dell’immagine è fissato tramite infra.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 un secretKeyRef env, 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:

Terminal window
aggrega scaffold --example rabbitmq-broker

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd rabbitmq-broker

Build

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:

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

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