Kafka — broker de streaming de eventos de nó único para Kubernetes
Este exemplo compila um stack pequeno e real — um broker de streaming de eventos Apache Kafka na sua estrutura KRaft de nó único — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes, sintetizado diretamente a partir da imagem oficial do Apache Kafka, sem nenhum chart upstream.
O Kafka é um broker de streaming de eventos: os produtores acrescentam registros a tópicos e os consumidores os leem de volta em ordem. Na estrutura KRaft de nó único, os papéis de broker e de controlador são executados dentro de um único processo — sem ZooKeeper e sem um segundo serviço incluído — então o servidor inteiro é uma única carga de trabalho com estado. O commit log é persistido em um volume de dados local. Um produtor ou consumidor se conecta ao endpoint de bootstrap de clientes e troca registros ali.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente broker (core/messaging/kafka). |
manifest.yaml | Mapeia o tipo de componente para a Recipe de síntese do Kafka (kafka). |
release.yaml | Documento do operador para o destino Kubernetes: a computação do servidor e o tamanho do volume do commit log. |
O que ele demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte da verdade sobre o que o Kafka é; o Manifest diz como realizá-lo.
- Um broker KRaft de nó único. A Recipe de síntese renderiza o Kafka como um único
StatefulSetcom um volume de dados e dois objetosService— umClusterIPque expõe a porta de bootstrap de clientes, e um Service headless de governo para o StatefulSet. - KRaft, sem ZooKeeper. O nó executa tanto o papel de broker quanto o de controlador em um único processo, configurado inteiramente por variáveis de ambiente.
- Uma identidade de cluster fixada. A identidade do cluster é um valor fixo do desenvolvedor passado literalmente para a imagem, que o lê tal como está, sem nenhuma geração aleatória, então o manifesto renderizado é idêntico byte a byte entre builds.
- Um endereço anunciado estável. O broker anuncia o nome do Service interno ao cluster, então os clientes se reconectam pelo endereço estável em vez do hostname próprio do pod.
- Log persistente. O commit log grava no volume persistente em
/var/lib/kafka/data, então os dados dos registros sobrevivem a reinicializações. - Um contrato de bootstrap exportado. O componente exporta o seu host de bootstrap e a porta de clientes por meio da topologia
uses, então um produtor ou consumidor se liga a ele e se conecta ali. - Imagens reproduzíveis. A Recipe fixa a imagem do servidor Kafka em uma tag resolvível, para que a carga de trabalho renderizada referencie uma versão fixada.
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 kafka-brokerEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd kafka-brokerBuild
Este espaço de trabalho 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:
aggrega pull --release release.yamlaggrega build --release release.yamlOs 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 `kafka-broker`, chame a ferramenta `scaffold` uma vez com `example` definido como `kafka-broker` e sem `dir`: ela grava o exemplo em uma nova pasta `kafka-broker`. Depois chame a ferramenta `build` com `workspace_root` definido como `kafka-broker`, `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 `kafka-broker/dist/`.O que é renderizado
O build emite o servidor Kafka como três objetos do Kubernetes:
- um
StatefulSet— o processo do Kafka de nó único, com o seu commit log em um volume persistente montado em/var/lib/kafka/datae a configuração completa do KRaft fornecida por variáveis de ambiente, - um
ServiceClusterIP— que expõe a porta de bootstrap de clientes na 9092, - um
Serviceheadless — o Service de governo que o StatefulSet exige para uma identidade estável por réplica.
A imagem do Kafka é fixada na sua tag de release, para que a carga de trabalho referencie uma tag de imagem fixada.