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

Roteamento de módulos para fronteiras — colocar submódulos inteiros em fronteiras

Este exemplo compila duas capacidades — uma camada de leitura de métricas do Thanos sobre armazenamento de objetos e um banco de dados de documentos que fala o protocolo de rede do MongoDB — a partir de um único Aggregate escrito pelo desenvolvedor, e coloca cada uma em uma fronteira própria a partir da Release.

As duas capacidades são módulos: subagregados reutilizáveis que compõem, cada um, vários componentes de carga de trabalho única e ligam as suas próprias arestas internas. O Aggregate nomeia os dois módulos e nada sobre onde eles rodam. A Release coloca cada módulo inteiro com uma entrada aggregates: por fronteira — o operador decide onde uma capacidade roda sem rastrear, nem repetir, o que há dentro dela.

Arquivos

ArquivoPapel
aggregate.yamlIntenção do desenvolvedor: importa o módulo de métricas (core/thanos) e o módulo de banco de dados de documentos (core/ferretdb).
manifest.yamlMapeia cada tipo de componente que os dois módulos contribuem para a sua Recipe helm synth, a Feature de credencial que o módulo de métricas vincula, para a realização que emite um Secret a partir de cada um dos dois parâmetros de chave do módulo, e a Feature de scrape para a sua FeatureRecipe.
release.yamlDocumento do operador: roteia cada módulo para a sua própria fronteira, dimensiona um componente de um módulo e vincula a ele a Feature de scrape.

O que ele demonstra

  • Rotear um módulo inteiro para uma fronteira. A entrada aggregates: de uma fronteira tem como chave o nome do módulo no Aggregate. Ela coloca todos os componentes que o módulo contém, então os artefatos emitidos para os três componentes de métricas ficam sob a fronteira observability e os dois componentes do banco de dados de documentos sob data.
  • Não nomear nenhum componente é a forma principal. A fronteira data roteia o módulo de banco de dados de documentos com um simples documents: {}. Cada componente dentro dele é colocado e assume os seus próprios valores padrão de esquema; a Release precisa do nome do módulo e de nada mais sobre ele.
  • Configurar um componente roteado pelo seu nome local. Uma entrada de roteamento também pode configurar componentes individuais do módulo que ela roteia, endereçados pelo nome local que cada um traz dentro desse módulo — query, não metrics.query, porque dentro do módulo esse é o único nome que ele tem. Nomear um componente não diz nada sobre os outros: aqui query é dimensionado e recebe um destino de scrape, enquanto o armazenamento de objetos e o store gateway são roteados com os seus valores padrão.
  • Um componente roteado é um componente dessa fronteira. Ele herda a cascata de anotações da fronteira como qualquer outro, e é isso que dá a cada recurso de um módulo roteado o valor aggrega.ai/namespace da fronteira — incluindo os componentes que a entrada de roteamento nunca menciona.
  • Roteamento é posicionamento, não um tipo diferente de pertencimento. Um componente roteado sem que nada seja dito sobre ele é renderizado da mesma forma que o mesmo componente nomeado diretamente nessa fronteira com um corpo vazio. As duas grafias são duas maneiras de dizer onde um componente fica, não dois comportamentos.

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 module-boundary-routing

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

Terminal window
cd module-boundary-routing

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
aggrega build --release release.yaml --auto-pull

Os artefatos renderizados ficam em dist/. O destino Kubernetes renderiza manifestos simples offline — nenhum pull de chart é necessário.

Com um assistente de IA

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

Use somente as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `module-boundary-routing`, chame a ferramenta `scaffold` uma vez com `example` definido como `module-boundary-routing` e sem `dir`: ela grava o exemplo em uma nova pasta `module-boundary-routing`. Depois chame a ferramenta `build` com `workspace_root` definido como `module-boundary-routing`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `module-boundary-routing/dist/`.

Como ficam os stacks colocados

O directory de cada fronteira é a raiz dos artefatos de tudo o que é colocado nela, então os componentes dos dois módulos se separam no disco pela fronteira que os roteou:

dist/observability/helm/ metrics-zdobjstore, metrics-zdstore, metrics-zdquery
dist/data/helm/ documents-zdproxy, documents-zdbackend

Os nomes de arquivo trazem a identidade de cada componente com o separador de módulo escrito por extenso, porque um ponto não é um caractere que todo nome de recurso pode conter — metrics.store no Aggregate é metrics-zdstore no cluster. Compor um módulo é a única coisa que coloca um separador em uma identidade, então um componente que você nomeia diretamente é escrito da mesma forma nos dois lugares.

Cada recurso traz o namespace da fronteira que o roteia e registra qual fronteira o colocou. O store gateway nunca é nomeado na entrada de roteamento e ainda assim herda os dois:

metadata:
name: metrics-zdstore
namespace: observability
[… omitted: the labels every rendered document carries]
annotations:
aggrega.ai/boundary-path: observability
[… omitted: the annotation naming the Recipe that rendered it]

O mesmo vale para os quatro Secrets que a Feature de credencial do módulo de métricas emite para o par de chaves do armazenamento de objetos e para aquele que o store gateway apresenta a ele: cada um fica sob observability com esse namespace, ao lado da carga de trabalho que o lê.

A Feature de scrape vinculada ao componente roteado query renderiza o seu próprio artefato sob essa mesma fronteira, trazendo as configurações de scrape do operador:

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
name: metrics-zdquery-scrape
[… omitted: the namespace, labels and annotations every rendered document carries]
spec:
selector:
matchLabels:
app.kubernetes.io/name: metrics-zdquery
endpoints:
- port: http
interval: 30s
path: /metrics