Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Kafka — broker di event streaming a nodo singolo per Kubernetes

Questo esempio compila uno stack piccolo e reale — un broker di event streaming Apache Kafka nella sua struttura KRaft a nodo singolo — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes, sintetizzato direttamente dall’immagine ufficiale di Apache Kafka senza alcun chart upstream.

Kafka è un broker di event streaming: i produttori aggiungono record ai topic e i consumatori li rileggono in ordine. Nella struttura KRaft a nodo singolo i ruoli di broker e di controller vengono eseguiti all’interno di un unico processo — nessun ZooKeeper e nessun secondo servizio incluso — quindi l’intero server è un unico carico di lavoro con stato. Il commit log viene reso persistente su un volume di dati locale. Un produttore o un consumatore si connette all’endpoint di bootstrap dei client e lì scambia i record.

File

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente broker (core/messaging/kafka).
manifest.yamlMappa il tipo di componente sulla Recipe di sintesi di Kafka (kafka).
release.yamlDocumento dell’operatore per la destinazione Kubernetes: le risorse di calcolo del server e la dimensione del volume del commit log.

Che cosa dimostra

  • Un’unica superficie di authoring. Un unico Aggregate è la fonte di verità su che cosa è Kafka; il Manifest dice come realizzarlo.
  • Un broker KRaft a nodo singolo. La Recipe di sintesi renderizza Kafka come un unico StatefulSet con un volume di dati e due oggetti Service — un ClusterIP che espone la porta di bootstrap dei client, e un Service headless di governo per lo StatefulSet.
  • KRaft, senza ZooKeeper. Il nodo esegue sia il ruolo di broker sia quello di controller in un unico processo, configurato interamente tramite variabili d’ambiente.
  • Un’identità di cluster fissata. L’identità del cluster è un valore fisso dello sviluppatore passato così com’è all’immagine, che la legge senza modifiche e senza alcuna generazione casuale, così il manifest renderizzato è identico byte per byte tra un build e l’altro.
  • Un indirizzo pubblicizzato stabile. Il broker pubblicizza il nome del Service interno al cluster, così i client si riconnettono attraverso l’indirizzo stabile anziché tramite l’hostname del pod stesso.
  • Log persistente. Il commit log scrive sul volume persistente in /var/lib/kafka/data, così i dati dei record sopravvivono ai riavvii.
  • Un contratto di bootstrap esportato. Il componente esporta il suo host di bootstrap e la porta dei client tramite la topologia uses, così un produttore o un consumatore si collega a esso e vi stabilisce la connessione.
  • Immagini riproducibili. La Recipe fissa l’immagine del server Kafka a un tag risolvibile, così il carico di lavoro renderizzato fa riferimento a una versione fissata.

Generare l’esempio

Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.

Scrivi l’esempio in una nuova cartella che porta il suo nome:

Terminal window
aggrega scaffold --example kafka-broker

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd kafka-broker

Build

Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard si risolvono dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Gli artefatti renderizzati finiscono sotto dist/. Il target Kubernetes renderizza manifest semplici offline — non è richiesto alcun pull di chart.

Con un assistente AI

Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.

Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `kafka-broker`, chiama una volta lo strumento `scaffold` con `example` impostato su `kafka-broker` e senza `dir`: scrive l’esempio in una nuova cartella `kafka-broker`. Poi chiama lo strumento `build` con `workspace_root` impostato su `kafka-broker`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `kafka-broker/dist/`.

Che cosa viene renderizzato

Il build emette il server Kafka come tre oggetti Kubernetes:

  • uno StatefulSet — il processo Kafka a nodo singolo, con il suo commit log su un volume persistente montato in /var/lib/kafka/data e l’intera configurazione KRaft fornita tramite variabili d’ambiente,
  • un Service ClusterIP — che espone la porta di bootstrap dei client sulla 9092,
  • un Service headless — il Service di governo che lo StatefulSet richiede per un’identità stabile di ciascuna replica.

L’immagine di Kafka è fissata al suo tag di release, così il carico di lavoro fa riferimento a un tag di immagine fissato.