Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

BerkasPeran
aggregate.yamlIntent Developer: satu komponen broker (core/messaging/kafka).
manifest.yamlMemetakan tipe komponen ke Recipe sintesis Kafka (kafka).
release.yamlCatatan 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 StatefulSet dengan volume data dan dua objek Service — sebuah ClusterIP yang 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:

Terminal window
aggrega scaffold --example kafka-broker

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd kafka-broker

Build

Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan:

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

Artefak 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/data dan seluruh konfigurasi KRaft yang disediakan melalui variabel lingkungan,
  • sebuah ClusterIP Service — yang mengekspos port bootstrap klien pada 9092,
  • sebuah Service headless — 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.