rmstar/docker-kafka

镜像概述

本镜像用于在Docker容器中运行Apache Kafka，旨在提供生产环境友好的部署方案。它不捆绑ZooKeeper（可通过Docker Compose集成），支持参数化配置构建集群，允许卷挂载管理数据和日志，并暴露JMX用于监控。

核心功能

• 参数化配置：通过环境变量自定义Broker ID、端口、复制因子等关键参数。
• 数据持久化：支持挂载/data（Kafka数据）和/logs（日志）目录。
• 监控支持：暴露7203端口用于JMX连接，集成Prometheus监控能力。
• 灵活集成：可通过链接容器或环境变量配置ZooKeeper地址。

使用场景

• 生产集群：部署多节点Kafka集群，满足高可用消息传递需求。
• 本地开发：快速搭建测试环境，用于开发生产者/消费者应用。
• 微服务架构：作为微服务间的异步消息中间件。

配置说明

以下环境变量可自定义配置（默认值括号内）：

• KAFKA_BROKER_ID=0：Broker唯一标识。
• KAFKA_PORT=9092：Broker监听端口。
• KAFKA_ADVERTISED_HOST_NAME：生产者可访问的Broker主机名。
• ZOOKEEPER_IP：ZooKeeper地址（未链接容器时必填）。
• ZOOKEEPER_CONNECTION_STRING：ZooKeeper集群连接串（覆盖IP和端口）。
• KAFKA_LOG_RETENTION_HOURS=168：日志保留时间（小时）。

部署示例

快速启动（含ZooKeeper）

bash
# 创建网络
docker network create kafka-net
# 启动ZooKeeper
docker run -d --name zookeeper --network kafka-net zookeeper:3.4
# 启动Kafka
docker run -d --name kafka --network kafka-net --env ZOOKEEPER_IP=zookeeper rmstar/docker-kafka
# 创建测试主题
docker run --rm --network kafka-net rmstar/docker-kafka kafka-topics.sh --create --topic test --replication-factor 1 --partitions 1 --zookeeper zookeeper:2181

本地开发环境（端口映射到主机）

bash
mkdir -p kafka-ex/{data,logs} && cd kafka-ex
# 启动ZooKeeper
docker run -d --name zookeeper --publish 2181:2181 zookeeper:3.4
# 启动Kafka（挂载数据卷+端口映射）
docker run -d \
  --hostname localhost \
  --name kafka \
  --volume ./data:/data --volume ./logs:/logs \
  --publish 9092:9092 --publish 7203:7203 \
  --env KAFKA_ADVERTISED_HOST_NAME=127.0.0.1 --env ZOOKEEPER_IP=127.0.0.1 \
  rmstar/docker-kafka