Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler 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 programador em dois destinos:

  • Docker Compose para o desenvolvimento local, e
  • Kubernetes, através 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, de destino para 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 palavra-passe referenciável anexada.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um componente broker do tipo core/messaging/rabbitmq, sem credencial — a Recipe fornece uma palavra-passe de desenvolvimento determinística escrita inline.
aggregate-auth.yamlO mesmo broker com uma credencial de palavra-passe inject-value anexada à ranhura opcional password do componente (usada pelo destino Compose).
aggregate-helm-synth-auth.yamlO mesmo broker com uma credencial de palavra-passe referenciável anexada, 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, palavra-passe de desenvolvimento escrita inline.
release-compose-auth.yaml / release-helm-synth-auth.yamlDocumentos do operador que fornecem a palavra-passe através da ranhura de credencial.

As referências de Recipe nos Manifests têm âmbito de fornecedor (compose/rabbitmq, helm/rabbitmq) porque existe uma Recipe com o mesmo nome para cada fornecedor.

O que demonstra

  • Uma única superfície de autoria, muitos destinos. Um único Aggregate é a fonte de verdade sobre o que a stack é. Cada Manifest diz como realizá-la.
  • Um broker durável. O RabbitMQ torna persistentes as filas e as mensagens, pelo que 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 a acompanhar. A tag da imagem é fixada através de infra.engine_version, pelo que a renderização não contém nenhuma tag flutuante.
  • As duas portas do broker. A imagem tem a gestão ativada, pelo que o broker expõe a porta AMQP (5672) e o painel de gestão (15672) no contentor e no Service ClusterIP.
  • Credenciais determinísticas. O RabbitMQ autentica sempre. Quando nenhuma credencial está anexada, cada Recipe fornece uma palavra-passe de desenvolvimento fixa escrita inline, pelo que a renderização é idêntica byte a byte entre execuções. Quando uma credencial está anexada, o valor injetado define a palavra-passe do broker: no Compose torna-se a variável de ambiente do serviço RABBITMQ_DEFAULT_PASS; no Kubernetes é materializado como um Secret e referenciado por um secretKeyRef de ambiente, pelo que o texto simples nunca chega ao manifesto renderizado.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example rabbitmq-broker

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd rabbitmq-broker

Compilação

Este workspace não contém nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo; --auto-pull escreve durante a compilação o lockfile que falta a um clone acabado de criar:

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 artefactos renderizados ficam em dist/.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa 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`: esta escreve o exemplo numa nova pasta `rabbitmq-broker`. Em seguida, chame a ferramenta `build` uma vez para cada Release, por esta ordem — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` e `release-helm-synth-auth.yaml` — de cada vez com `workspace_root` definido como `rabbitmq-broker`, `release` definido como esse ficheiro, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros cada compilação escreveu; encontram-se 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 torna-se a variável de ambiente do serviço RABBITMQ_DEFAULT_PASS. No Kubernetes, a credencial é referenciável: é materializada como um Secret do Kubernetes, e o StatefulSet referencia-a através de um secretKeyRef de ambiente, pelo que a palavra-passe em texto simples nunca aparece no manifesto da carga de trabalho. O valor origin nos Aggregates de autenticação é um marcador de posição de desenvolvimento; forneça um valor real através da sua fonte de credenciais em qualquer implementação real. A palavra-passe de desenvolvimento escrita inline usada quando nenhuma credencial está anexada destina-se igualmente apenas a uso local.