Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

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 на тезі, що розв’язується, тож відрендерене робоче навантаження посилається на зафіксовану версію.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example kafka-broker

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd kafka-broker

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:

Terminal window
aggrega pull --release release.yaml
aggrega 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 задається через змінні середовища,
  • ClusterIP Service — відкриває клієнтський bootstrap-порт 9092,
  • headless Service — керівний сервіс, потрібний StatefulSet для стабільної ідентичності кожної репліки.

Образ Kafka зафіксовано на тезі його випуску, тож робоче навантаження посилається на зафіксований тег образу.