RabbitMQ — um Aggregate, dois destinos, autenticação opcional
Este exemplo compila um único broker de mensagens RabbitMQ (AMQP) a partir de um único Aggregate escrito pelo desenvolvedor para dois destinos:
- Docker Compose para o desenvolvimento local, e
- Kubernetes, por meio da Recipe helm sintetizada que executa diretamente a imagem upstream oficial
rabbitmq(um StatefulSet com um volume persistente, sem chart externo).
O mesmo aggregate.yaml conduz ambos. Só muda por destino a camada de Recipe selecionada pelo Manifest. Um segundo Aggregate, aggregate-helm-synth-auth.yaml, mostra o mesmo broker no Kubernetes com uma credencial de senha referenciável vinculada.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um componente broker do tipo core/messaging/rabbitmq, sem credencial — a Recipe fornece uma senha de desenvolvimento determinística escrita inline. |
aggregate-auth.yaml | O mesmo broker com uma credencial de senha inject-value vinculada ao slot opcional password do componente (usada pelo destino Compose). |
aggregate-helm-synth-auth.yaml | O mesmo broker com uma credencial de senha referenciável vinculada, materializada como um Secret do Kubernetes e referenciada pelo StatefulSet (usada pelo destino Kubernetes). |
manifest-compose.yaml | Mapeia o tipo RabbitMQ para a Recipe do Compose (compose/rabbitmq) e a credencial para dotenv-secret. |
manifest-helm-synth.yaml | Mapeia o tipo RabbitMQ para a Recipe helm sintetizada (helm/rabbitmq) e a credencial para k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documentos do operador para os dois destinos, senha de desenvolvimento escrita inline. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Documentos do operador que fornecem a senha pelo slot de credencial. |
As referências de Recipe nos Manifests têm escopo de provedor (compose/rabbitmq, helm/rabbitmq) porque existe uma Recipe com o mesmo nome para cada provedor.
O que ele demonstra
- Uma única superfície de autoria, muitos destinos. Um único Aggregate é a fonte da verdade sobre o que o stack é. Cada Manifest diz como realizá-lo.
- Um broker durável. O RabbitMQ persiste filas e mensagens, então o componente é tipado como
stateful-server. No Kubernetes, a Recipe sintetizada renderiza um StatefulSet com um volume persistente por réplica montado no diretório de dados do RabbitMQ e um Service headless para uma identidade de rede estável; o serviço do Compose expõe o broker para o desenvolvimento local. - Síntese sem chart (Kubernetes). O destino Kubernetes executa diretamente a imagem oficial
rabbitmq. O compilador sintetiza o StatefulSet, o Service ClusterIP e o Service headless a partir do dimensionamentoinfrado componente — nenhum chart externo a obter ou acompanhar. A tag da imagem é fixada por meio deinfra.engine_version, então a renderização não traz nenhuma tag flutuante. - As duas portas do broker. A imagem tem o gerenciamento habilitado, então o broker expõe a porta AMQP (5672) e o painel de gerenciamento (15672) no contêiner e no Service ClusterIP.
- Credenciais determinísticas. O RabbitMQ sempre autentica. Quando nenhuma credencial está vinculada, cada Recipe fornece uma senha de desenvolvimento fixa escrita inline, então a renderização é idêntica byte a byte entre execuções. Quando uma credencial está vinculada, o valor injetado define a senha do broker: no Compose ele se torna a variável de ambiente do serviço
RABBITMQ_DEFAULT_PASS; no Kubernetes ele é materializado como um Secret e referenciado por umsecretKeyRefde ambiente, então o texto puro nunca vai parar no manifesto renderizado.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example rabbitmq-brokerEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd rabbitmq-brokerBuild
Este workspace não traz nenhum .aggrega-config.yaml, então as entidades da biblioteca padrão são resolvidas a partir do registro do hub, hub.aggrega.ai, e nenhuma flag de catálogo é necessária; --auto-pull escreve durante o build o lockfile que falta a um clone novo:
# 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-pullOs artefatos renderizados ficam em dist/.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta Workspace ainda não contiver uma pasta `rabbitmq-broker`, chame uma vez a ferramenta `scaffold` com `example` definido como `rabbitmq-broker` e sem `dir`: ela grava o exemplo em uma nova pasta `rabbitmq-broker`. Em seguida, chame a ferramenta `build` uma vez para cada Release, nesta ordem — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` e `release-helm-synth-auth.yaml` — cada vez com `workspace_root` definido como `rabbitmq-broker`, `release` definido como esse arquivo, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos cada build gravou; eles ficam em `rabbitmq-broker/dist/`.Nota sobre a entrega da credencial
No Compose, a credencial é um segredo inject-value: o seu valor é entregue no pipe de ambiente do componente e se torna a variável de ambiente do serviço RABBITMQ_DEFAULT_PASS. No Kubernetes, a credencial é referenciável: ela é materializada como um Secret do Kubernetes, e o StatefulSet a referencia por meio de um secretKeyRef de ambiente, então a senha em texto puro nunca aparece no manifesto da carga de trabalho. O valor origin nos Aggregates de autenticação é um espaço reservado de desenvolvimento; forneça um valor real por meio da sua fonte de credenciais em qualquer implantação real. A senha de desenvolvimento escrita inline usada quando nenhuma credencial está vinculada também serve apenas para uso local.