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

NATS — um Aggregate, dois destinos, autenticação opcional

Este exemplo compila um único servidor de mensagens NATS (pub-sub, request-reply, filas) a partir de um único Aggregate escrito pelo programador em duas realizações:

  • Docker Compose para o desenvolvimento local, e
  • a Recipe helm sintetizada que executa a imagem upstream oficial nats diretamente no Kubernetes (sem chart externo).

A Recipe helm sintetizada é o caminho preferido do Kubernetes: depende apenas de uma tag de imagem oficial em vez de um chart de terceiros, e o seu conjunto de recursos renderizado é exatamente o que a carga de trabalho declara.

O mesmo aggregate.yaml conduz ambas. Só muda, de realização para realização, a camada de Recipe selecionada pelo Manifest. Um segundo Aggregate, aggregate-auth.yaml, mostra o mesmo servidor com uma credencial de palavra-passe inject-value anexada para o caminho do Compose; aggregate-helm-synth-auth.yaml anexa uma credencial referenciável para o caminho helm sintetizado.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um componente bus do tipo core/messaging/nats, sem credencial — o servidor funciona sem autenticação.
aggregate-auth.yamlO mesmo servidor com uma credencial de palavra-passe inject-value anexada ao slot opcional password do componente (caminho do Compose).
aggregate-helm-synth-auth.yamlO mesmo servidor com uma credencial referenciável anexada para o caminho helm sintetizado — o valor é materializado como um Secret do Kubernetes que o Deployment referencia.
manifest-compose.yamlMapeia o tipo NATS para a Recipe do Compose (compose/nats) e a credencial para dotenv-secret.
manifest-helm-synth.yamlMapeia o tipo NATS para a Recipe helm sintetizada (helm/nats) e a credencial para k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocumentos do operador para as duas realizações, sem autenticação.
release-compose-auth.yaml / release-helm-synth-auth.yamlDocumentos do operador que ativam a autenticação.

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 servidor de mensagens sem estado. Nesta forma enxuta, o NATS encaminha subjects em memória com o armazenamento em ficheiro do JetStream desativado, pelo que o componente é tipado como server. No Kubernetes, a Recipe sintetizada renderiza um Deployment de réplica única sem volume persistente; o serviço do Compose expõe o servidor para o desenvolvimento local.
  • Síntese de Workload (Kubernetes). A Recipe helm sintetizada declara um Workload — um Deployment mais um Service ClusterIP que executa a imagem oficial nats — que o fornecedor helm traduz em manifestos do Kubernetes sem nenhum chart externo. O conjunto de recursos renderizado é exatamente o que o Workload declara. Como o nome nats é usado tanto por uma Recipe do Compose como por uma helm sintetizada, os Manifests referenciam-nas com âmbito de fornecedor como compose/nats e helm/nats.
  • Autenticação opcional, determinística em qualquer caso. A autenticação do NATS está desligada por predefinição. Quando nenhuma credencial está anexada, nenhuma das duas realizações ativa a autenticação e a renderização é idêntica byte a byte entre execuções. Quando uma credencial está anexada, o valor injetado ativa a autenticação por utilizador/palavra-passe nas duas realizações.

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 nats-messaging

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

Terminal window
cd nats-messaging

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), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
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.

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta da área de trabalho ainda não contiver uma pasta `nats-messaging`, chame uma vez a ferramenta `scaffold` com `example` definido como `nats-messaging` e sem `dir`: esta escreve o exemplo numa nova pasta `nats-messaging`. 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 `nats-messaging`, `release` definido como esse ficheiro, `auto_pull` definido como true e `write` definido como true. Indique quais os ficheiros que cada compilação escreveu; encontram-se em `nats-messaging/dist/`.

Nota sobre a entrega da credencial

No caminho do Compose, a credencial é um segredo inject-value (aggregate-auth.yaml): o seu valor é entregue no pipe de ambiente do componente e o servidor é iniciado com flags de autenticação por utilizador/palavra-passe.

O caminho helm sintetizado usa uma credencial referenciável (aggregate-helm-synth-auth.yaml): o valor é materializado como um Secret do Kubernetes, o Deployment referencia-o através de um secretKeyRef de ambiente, e o servidor é iniciado com as flags --user/--pass que leem essa variável de ambiente. Por isso, a palavra-passe em texto simples nunca aparece no manifesto do Deployment — apenas no Secret.

O valor origin nos Aggregates autenticados é um marcador de posição de desenvolvimento; forneça um valor real através da sua fonte de credenciais em qualquer implementação real.