martinnowak/kafka

包含嵌入式ZooKeeper的简单Kafka容器

镜像概述和主要用途

本镜像集成了ZooKeeper和Kafka，专为CI测试设计。由于GitLab CI目前不易支持服务互连（参见#***），此容器以守护进程方式运行ZooKeeper，同时以前台进程运行Kafka，可直接用于CI测试环境。镜像遵循Apache Kafka快速入门指南，使用二进制发行版自带的CLI工具启动ZooKeeper和Kafka服务。

核心功能和特性

• 嵌入式ZooKeeper：无需独立部署ZooKeeper服务，简化配置流程
• 即开即用：适用于CI测试环境，无需复杂前置配置
• 灵活定制：支持通过环境变量、卷挂载和端口映射调整容器行为
• 版本可控：构建时可指定Kafka和Scala版本

使用场景和适用范围

主要适用于CI/CD测试环境，特别是GitLab CI，需要快速搭建独立Kafka环境进行集成测试的场景。适合开发团队在自动化测试流程中验证Kafka相关功能。

使用方法和配置说明

环境变量选项

可通过环境变量指定Kafka broker ID，默认自动生成唯一ID。

示例：

bash
docker run --rm -it --env=BROKER_ID=1 martinnowak/kafka

环境变量说明：

• BROKER_ID：Kafka broker ID，默认值为-1（自动生成唯一ID）

卷挂载

可挂载持久化卷以保存Kafka数据。

示例：

bash
docker run --rm -it --volume=/tmp/host/kafka:/var/lib/kafka martinnowak/kafka

卷说明：

• 容器内数据路径：/var/lib/kafka，用于存储Kafka持久化数据

端口映射

可将容器端口发布到主机，以便外部访问Kafka和ZooKeeper服务。

示例：

bash
docker run --rm -it --publish=2181:2181 --publish=9092:9092 martinnowak/kafka

暴露端口说明：

• 2181/tcp：ZooKeeper服务端口
• 9092/tcp：Kafka broker服务端口

构建选项

构建镜像时可通过构建参数指定Kafka和Scala版本。

示例：

bash
docker build --build-arg=KAFKA_VERSION=0.11.0.2 --build-arg=SCALA_VERSION=2.12 .

构建参数说明：

• KAFKA_VERSION：Kafka版本，默认值为1.1.0
• SCALA_VERSION：Scala版本，默认值为2.11