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
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente broker (core/messaging/kafka). |
manifest.yaml | Mappa il tipo di componente sulla Recipe di sintesi di Kafka (kafka). |
release.yaml | Documento 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
StatefulSetcon un volume di dati e due oggettiService— unClusterIPche 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:
aggrega scaffold --example kafka-brokerPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd kafka-brokerBuild
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:
aggrega pull --release release.yamlaggrega build --release release.yamlGli 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/datae l’intera configurazione KRaft fornita tramite variabili d’ambiente, - un
ServiceClusterIP— che espone la porta di bootstrap dei client sulla 9092, - un
Serviceheadless — 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.