Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Kafka — broker truyền phát sự kiện một nút trên Kubernetes

Ví dụ này biên dịch một stack nhỏ, thực tế — một broker truyền phát sự kiện Apache Kafka ở dạng KRaft một nút — từ một Aggregate do Developer viết sang Kubernetes, được tổng hợp trực tiếp từ image Apache Kafka chính thức mà không dùng chart thượng nguồn nào.

Kafka là một broker truyền phát sự kiện: producer ghi nối các bản ghi vào topic và consumer đọc lại chúng theo thứ tự. Ở dạng KRaft một nút, vai trò broker và controller chạy trong cùng một tiến trình — không có ZooKeeper và không có dịch vụ đi kèm thứ hai — nên toàn bộ máy chủ là một workload có trạng thái. Commit log được lưu vào một volume dữ liệu cục bộ. Producer hoặc consumer kết nối tới endpoint bootstrap của client và trao đổi bản ghi tại đó.

Các tệp

TệpVai trò
aggregate.yamlÝ định của Developer: một component broker duy nhất (core/messaging/kafka).
manifest.yamlÁnh xạ kiểu component sang Recipe tổng hợp Kafka (kafka).
release.yamlBản ghi của Operator cho đích Kubernetes: tài nguyên tính toán của máy chủ và kích thước volume commit log.

Ví dụ này minh họa điều gì

  • Một bề mặt soạn thảo duy nhất. Một Aggregate duy nhất là nguồn chân lý về Kafka là gì; Manifest cho biết cách hiện thực hóa nó.
  • Một broker KRaft một nút. Recipe tổng hợp kết xuất Kafka thành một StatefulSet với một volume dữ liệu và hai đối tượng Service — một ClusterIP mở cổng bootstrap của client, và một Service headless quản lý cho StatefulSet.
  • KRaft, không có ZooKeeper. Nút chạy cả vai trò broker và controller trong một tiến trình, được cấu hình hoàn toàn qua biến môi trường.
  • Định danh cụm được cố định. Định danh cụm là một giá trị cố định do developer đặt, được truyền nguyên văn tới image; image đọc nó đúng như vậy mà không sinh ngẫu nhiên, nên manifest được kết xuất giống hệt từng byte giữa các lần build.
  • Địa chỉ quảng bá ổn định. Broker quảng bá tên Service trong cụm, nên client kết nối lại qua địa chỉ ổn định thay vì hostname riêng của pod.
  • Log bền vững. Commit log ghi vào volume bền vững tại /var/lib/kafka/data, nên dữ liệu bản ghi được giữ lại qua các lần khởi động lại.
  • Hợp đồng bootstrap được xuất ra. Component xuất host bootstrap và cổng client của nó qua topology uses, nên producer hoặc consumer nối tới nó và kết nối tại đó.
  • Image có thể tái lập. Recipe cố định image máy chủ Kafka vào một tag có thể phân giải, để workload được kết xuất tham chiếu một phiên bản đã cố định.

Tạo ví dụ

Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example kafka-broker

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd kafka-broker

Build

Workspace này không có .aggrega-config.yaml, nên các thực thể thư viện chuẩn được phân giải từ registry hub, hub.aggrega.ai, và không cần cờ catalog:

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

Các artifact được kết xuất nằm trong dist/. Đích Kubernetes kết xuất manifest thuần ở chế độ ngoại tuyến — không cần kéo chart.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ sử dụng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa chứa thư mục `kafka-broker`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `kafka-broker` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `kafka-broker` mới. Sau đó gọi công cụ `build` với `workspace_root` được đặt thành `kafka-broker`, `release` được đặt thành `release.yaml`, `auto_pull` được đặt thành true và `write` được đặt thành true. Hãy cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `kafka-broker/dist/`.

Những gì được kết xuất

Quá trình build xuất máy chủ Kafka thành ba đối tượng Kubernetes:

  • một StatefulSet — tiến trình Kafka một nút, với commit log trên một volume bền vững được gắn tại /var/lib/kafka/data và toàn bộ cấu hình KRaft được cung cấp qua biến môi trường,
  • một ClusterIP Service — mở cổng bootstrap của client trên 9092,
  • một Service headless — Service quản lý mà StatefulSet yêu cầu để có danh tính ổn định cho từng bản sao.

Image Kafka được cố định vào tag phát hành của nó, nên workload tham chiếu một image tag đã cố định.