Kafka — одновузловий брокер потокової передачі подій для Kubernetes
Цей приклад компілює невеликий реальний стек — брокер потокової передачі подій Apache Kafka
в одновузловій конфігурації KRaft — з одного Aggregate, написаного розробником,
у Kubernetes, синтезуючи його безпосередньо з офіційного образу Apache Kafka
без жодного зовнішнього чарта.
Kafka — це брокер потокової передачі подій: продюсери додають записи до топіків, а консюмери читають їх у порядку надходження. В одновузловій конфігурації KRaft ролі брокера і контролера виконуються в одному процесі — без ZooKeeper і без другого вбудованого сервісу, — тож увесь сервер є одним робочим навантаженням зі станом. Журнал комітів зберігається на локальному томі даних. Продюсер або консюмер підключається до клієнтської bootstrap-точки доступу й обмінюється записами через неї.
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: один компонент broker (core/messaging/kafka). |
manifest.yaml | Зіставляє тип компонента з Recipe синтезу Kafka (kafka). |
release.yaml | Запис оператора для цілі Kubernetes: обчислювальні ресурси сервера й розмір тому журналу комітів. |
Що демонструє приклад
- Одна поверхня авторингу. Один Aggregate є джерелом істини щодо того, що таке Kafka; Manifest визначає, як це реалізувати.
- Одновузловий брокер KRaft. Recipe синтезу рендерить Kafka як один
StatefulSetіз томом даних і двома об’єктамиService—ClusterIP, що відкриває клієнтський bootstrap-порт, і headless-сервіс, що керує StatefulSet. - KRaft без ZooKeeper. Вузол виконує ролі брокера й контролера в одному процесі, і вся конфігурація задається через змінні середовища.
- Зафіксований ідентифікатор кластера. Ідентифікатор кластера — це фіксоване значення розробника, яке передається образу дослівно; образ читає його як є, без випадкової генерації, тож відрендерений маніфест побайтово однаковий між збираннями.
- Стабільна оголошена адреса. Брокер оголошує ім’я внутрішньокластерного сервісу, тож клієнти перепідключаються через стабільну адресу, а не через власне ім’я хоста пода.
- Постійний журнал. Журнал комітів записується на постійний том у
/var/lib/kafka/data, тож дані записів зберігаються після перезапусків. - Експортований bootstrap-контракт. Компонент експортує свій bootstrap-хост
і клієнтський порт через топологію
uses, тож продюсер або консюмер під’єднується до нього й підключається туди. - Відтворювані образи. Recipe фіксує образ сервера Kafka на тезі, що розв’язується, тож відрендерене робоче навантаження посилається на зафіксовану версію.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example kafka-brokerПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd kafka-brokerЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:
aggrega pull --release release.yamlaggrega build --release release.yamlВідрендерені артефакти потрапляють у dist/. Ціль Kubernetes рендерить звичайні
маніфести офлайн — завантаження чарта не потрібне.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `kafka-broker`, викличте один раз інструмент `scaffold`, задавши для `example` значення `kafka-broker`, без `dir`: він запише приклад у нову теку `kafka-broker`. Потім викличте інструмент `build`, задавши для `workspace_root` значення `kafka-broker`, для `release` — `release.yaml`, для `auto_pull` — true і для `write` — true. Скажіть, які файли записала збірка; вони розташовані в `kafka-broker/dist/`.Що рендериться
Збирання видає сервер Kafka як три об’єкти Kubernetes:
StatefulSet— одновузловий процес Kafka, журнал комітів якого розміщено на постійному томі, змонтованому в/var/lib/kafka/data, а повна конфігурація KRaft задається через змінні середовища,ClusterIPService— відкриває клієнтський bootstrap-порт 9092,- headless
Service— керівний сервіс, потрібний StatefulSet для стабільної ідентичності кожної репліки.
Образ Kafka зафіксовано на тезі його випуску, тож робоче навантаження посилається на зафіксований тег образу.