Kafka — broker event-streaming simpul tunggal di Kubernetes
Contoh ini mengompilasi tumpukan kecil yang nyata — sebuah broker event-streaming Apache Kafka
dalam bentuk KRaft simpul tunggal — dari satu Aggregate yang ditulis oleh Developer
ke Kubernetes, yang disintesis langsung dari image resmi Apache Kafka
tanpa chart upstream.
Kafka adalah broker event-streaming: producer menambahkan record ke topik dan consumer membacanya kembali secara berurutan. Dalam bentuk KRaft simpul tunggal, peran broker dan controller berjalan di dalam satu proses — tanpa ZooKeeper dan tanpa layanan kedua yang dibundel — sehingga seluruh server merupakan satu workload stateful. Commit log disimpan secara persisten ke volume data lokal. Producer atau consumer terhubung ke endpoint bootstrap klien dan bertukar record di sana.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intent Developer: satu komponen broker (core/messaging/kafka). |
manifest.yaml | Memetakan tipe komponen ke Recipe sintesis Kafka (kafka). |
release.yaml | Catatan operator untuk target Kubernetes: komputasi server dan ukuran volume commit log. |
Apa yang didemonstrasikan
- Satu permukaan penulisan. Satu Aggregate menjadi sumber kebenaran untuk apa Kafka itu; Manifest menyatakan bagaimana mewujudkannya.
- Broker KRaft simpul tunggal. Recipe sintesis merender Kafka sebagai satu
StatefulSetdengan volume data dan dua objekService— sebuahClusterIPyang mengekspos port bootstrap klien, dan Service headless yang mengatur StatefulSet tersebut. - KRaft, tanpa ZooKeeper. Simpul menjalankan peran broker dan controller sekaligus dalam satu proses, yang dikonfigurasi sepenuhnya melalui variabel lingkungan.
- Identitas kluster yang dipatok. Identitas kluster adalah nilai developer yang tetap dan diteruskan apa adanya ke image, yang membacanya apa adanya tanpa pembangkitan acak, sehingga manifest yang dirender identik byte demi byte di setiap build.
- Alamat yang diiklankan dan stabil. Broker mengiklankan nama Service di dalam kluster, sehingga klien terhubung kembali melalui alamat yang stabil, bukan melalui hostname pod itu sendiri.
- Log persisten. Commit log ditulis ke volume persisten di
/var/lib/kafka/data, sehingga data record tetap ada setelah restart. - Kontrak bootstrap yang diekspor. Komponen mengekspor host bootstrap
dan port kliennya melalui topologi
uses, sehingga producer atau consumer terhubung dengannya dan tersambung di sana. - Image yang dapat direproduksi. Recipe mematok image server Kafka ke tag yang dapat di-resolve sehingga workload yang dirender merujuk ke versi yang dipatok.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example kafka-brokerKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd kafka-brokerBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan:
aggrega pull --release release.yamlaggrega build --release release.yamlArtefak yang dirender ditempatkan di bawah dist/. Target Kubernetes merender manifest
biasa secara offline — tidak diperlukan penarikan chart.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `kafka-broker`, panggil alat `scaffold` sekali dengan `example` diatur ke `kafka-broker` dan tanpa `dir`: alat ini menulis contoh ke folder `kafka-broker` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `kafka-broker`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `kafka-broker/dist/`.Apa yang dirender
Build menghasilkan server Kafka sebagai tiga objek Kubernetes:
- sebuah
StatefulSet— proses Kafka simpul tunggal, dengan commit log-nya pada volume persisten yang di-mount di/var/lib/kafka/datadan seluruh konfigurasi KRaft yang disediakan melalui variabel lingkungan, - sebuah
ClusterIPService— yang mengekspos port bootstrap klien pada 9092, - sebuah
Serviceheadless — Service governing yang diperlukan StatefulSet untuk identitas per replika yang stabil.
Image Kafka dipatok ke tag rilisnya, sehingga workload merujuk ke tag image yang dipatok.