Kafka — Single-Node-Event-Streaming-Broker für Kubernetes
Dieses Beispiel kompiliert einen kleinen, realen Stack — einen Apache Kafka-Event-Streaming-Broker in seiner KRaft-Single-Node-Struktur — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes, direkt aus dem offiziellen Apache-Kafka-Image synthetisiert, ohne Upstream-Chart.
Kafka ist ein Event-Streaming-Broker: Produzenten hängen Records an Topics an, und Konsumenten lesen sie in Reihenfolge wieder aus. In der KRaft-Single-Node-Struktur laufen die Broker- und die Controller-Rolle in einem Prozess — kein ZooKeeper und kein zweiter mitgelieferter Dienst —, sodass der gesamte Server eine einzige zustandsbehaftete Arbeitslast ist. Das Commit-Log wird auf einem lokalen Daten-Volume persistiert. Ein Produzent oder Konsument verbindet sich mit dem Bootstrap-Endpunkt für Clients und tauscht dort Records aus.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente broker (core/messaging/kafka). |
manifest.yaml | Bildet den Komponententyp auf das Kafka-Synthese-Recipe ab (kafka). |
release.yaml | Dokument des Operators für das Kubernetes-Ziel: die Rechenressourcen des Servers und die Größe des Commit-Log-Volumes. |
Was es zeigt
- Eine Authoring-Oberfläche. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was Kafka ist; das Manifest sagt, wie es zu realisieren ist.
- Ein KRaft-Single-Node-Broker. Das Synthese-Recipe rendert Kafka als ein
StatefulSetmit einem Daten-Volume und zwei ObjekteService— einenClusterIP, der den Bootstrap-Port für Clients freigibt, und einen steuernden Headless-Service für das StatefulSet. - KRaft, kein ZooKeeper. Der Knoten führt sowohl die Broker- als auch die Controller-Rolle in einem Prozess aus, vollständig über Umgebungsvariablen konfiguriert.
- Eine fixierte Cluster-Identität. Die Cluster-Identität ist ein fester Entwicklerwert, der unverändert an das Image übergeben wird, das ihn so liest, wie er ist, ohne Zufallsgenerierung, sodass das gerenderte Manifest über Builds hinweg byteidentisch ist.
- Eine stabile angekündigte Adresse. Der Broker kündigt den clusterinternen Service-Namen an, sodass sich Clients über die stabile Adresse statt über den eigenen Hostnamen des Pods neu verbinden.
- Persistentes Log. Das Commit-Log schreibt auf das persistente Volume unter
/var/lib/kafka/data, sodass Record-Daten Neustarts überstehen. - Ein exportierter Bootstrap-Vertrag. Die Komponente exportiert ihren Bootstrap-Host und den Client-Port über die Topologie
uses, sodass sich ein Produzent oder Konsument mit ihr verdrahtet und dort verbindet. - Reproduzierbare Images. Das Recipe fixiert das Kafka-Server-Image auf einen auflösbaren Tag, sodass die gerenderte Arbeitslast eine fixierte Version referenziert.
Das Beispiel generieren
Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example kafka-brokerDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd kafka-brokerBuild
Dieser Workspace enthält keine .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig:
aggrega pull --release release.yamlaggrega build --release release.yamlGerenderte Artefakte landen unter dist/. Das Kubernetes-Ziel rendert einfache Manifeste offline — es ist kein Chart-Pull erforderlich.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `kafka-broker` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `kafka-broker` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `kafka-broker`. Rufen Sie anschließend das Tool `build` mit `workspace_root` auf `kafka-broker`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Nennen Sie mir, welche Dateien der Build geschrieben hat; sie liegen unter `kafka-broker/dist/`.Was gerendert wird
Der Build gibt den Kafka-Server als drei Kubernetes-Objekte aus:
- ein
StatefulSet— der Single-Node-Kafka-Prozess, mit seinem Commit-Log auf einem persistenten Volume, das unter/var/lib/kafka/dataeingehängt ist, und der vollständigen KRaft-Konfiguration, die über Umgebungsvariablen geliefert wird, - ein
Servicevom TypClusterIP— der den Bootstrap-Port für Clients auf 9092 freigibt, - ein headless
Service— der steuernde Service, den das StatefulSet für eine stabile Identität pro Replica benötigt.
Das Kafka-Image ist auf seinen Release-Tag fixiert, sodass die Arbeitslast einen fixierten Image-Tag referenziert.