Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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

ArquivoPapel
aggregate.yamlIntençã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.yamlO mesmo broker com uma credencial de senha inject-value vinculada ao slot opcional password do componente (usada pelo destino Compose).
aggregate-helm-synth-auth.yamlO 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.yamlMapeia o tipo RabbitMQ para a Recipe do Compose (compose/rabbitmq) e a credencial para dotenv-secret.
manifest-helm-synth.yamlMapeia o tipo RabbitMQ para a Recipe helm sintetizada (helm/rabbitmq) e a credencial para k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocumentos do operador para os dois destinos, senha de desenvolvimento escrita inline.
release-compose-auth.yaml / release-helm-synth-auth.yamlDocumentos 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 dimensionamento infra do componente — nenhum chart externo a obter ou acompanhar. A tag da imagem é fixada por meio de infra.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 um secretKeyRef de 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:

Terminal window
aggrega scaffold --example rabbitmq-broker

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd rabbitmq-broker

Build

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:

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

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