Проектная лаборатория

Собственная Kafka

0 / 25этапов пройдено

Этап 22 · Отправка сообщений

Запись одной записи

Русский перевод заданий CodeCrafters. Примеры подготовлены для Go. Выбор языка меняет команды и результаты, но не текст задания.

На этом этапе вы реализуете сохранение одной записи на диск.

Сохранение записей

Получив запрос Produce, брокер Kafka должен проверить существование топика и раздела с помощью файла журнала __cluster_metadata, сохранить запись в соответствующий файл журнала в дисковом формате Kafka и вернуть успешный ответ.

Запись должна быть сохранена в файл журнала топика <log-dir>/<topic-name>-<partition-index>/00000000000000000000.log в формате RecordBatch Kafka.

Тесты

Тестирующая система запустит вашу программу следующим образом:

$ ./your_program.sh /tmp/server.properties

Затем подключится к серверу на порту 9092 и отправит запрос Produce (v11) с одним recordBatch, содержащим одну запись.

Она проверит, что:

  • Первые 4 байта ответа («длина сообщения») корректны.
  • Идентификатор корреляции в заголовке ответа совпадает с идентификатором в заголовке запроса.
  • Поле throttle_time_ms ответа равно 0.
  • Поле topics содержит 1 элемент, в котором:
    • Поле name совпадает с именем топика в запросе.
    • Поле partitions содержит 1 элемент, в котором:
      • Поле error_code равно 0 (NO_ERROR).
      • Поле index совпадает с разделом в запросе.
      • Поле base_offset равно 0, обозначая первую запись в разделе.
      • Поле log_append_time_ms равно -1, обозначая последнюю временную метку.
      • Поле log_start_offset равно 0.
  • Запись сохранена в соответствующем файле журнала на диске по пути <log-dir>/<topic-name>-<partition-index>/00000000000000000000.log.

Примечания

  • Файлы журнала на диске должны храниться в формате RecordBatch. Каждый RecordBatch из запроса нужно записать непосредственно в файл журнала соответствующего раздела топика.
  • Официальная документация API Produce находится здесь. Прокрутите до раздела «(Version: 11)».

Проверка в вашей IDE

Нужны Node.js, Git, Go 1.24+ для тестеров и инструменты выбранного языка. Тестеры загружаются и запускаются локально; отдельным проектам нужны дополнительные системные зависимости.

Настройка проекта и IDE

1. Создайте проект один раз

node '/opt/graphlms/tools/project-lab/cli.mjs' init kafka ./my-kafka --language go

2. Откройте папку в IDE

cd ./my-kafka

Реализуйте требования этапа в созданном проекте.

Запустите из папки проекта

node '/opt/graphlms/tools/project-lab/cli.mjs' submit --stage ls8

Запускайте submit из папки проекта. Это локальные проверки, а не сертификаты или результаты аккаунта CodeCrafters.

Результат проверки

go / ЛОКАЛЬНО

Подключение к локальной проверке…

Здесь появится результат

Запустите submit в терминале. Страница обновляет результаты каждые 8 секунд.

GraphLMS — инженерная лаборатория роста