Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente broker (core/messaging/kafka).
manifest.yamlBildet den Komponententyp auf das Kafka-Synthese-Recipe ab (kafka).
release.yamlDokument 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 StatefulSet mit einem Daten-Volume und zwei Objekte Service — einen ClusterIP, 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:

Terminal window
aggrega scaffold --example kafka-broker

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd kafka-broker

Build

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:

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

Gerenderte 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/data eingehängt ist, und der vollständigen KRaft-Konfiguration, die über Umgebungsvariablen geliefert wird,
  • ein Service vom Typ ClusterIP — 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.