eddie89/kafka

Ubuntu-Zookeeper-Kafka-WebConsole 镜像文档

镜像概述

本Docker镜像基于Ubuntu系统构建，集成了Zookeeper（分布式协调服务）、Kafka（分布式消息队列系统）和Kafka WebConsole（Web-based Kafka管理工具），旨在提供开箱即用的Kafka开发、测试及小型部署环境，简化Kafka相关组件的配置与管理流程。

核心功能和特性

• 基础系统：基于Ubuntu，提供稳定的Linux运行环境
• Zookeeper集成：内置Zookeeper服务，用于Kafka集群协调与元数据管理
• Kafka集成：包含Kafka服务，支持消息发布/订阅、流处理等核心功能
• Kafka WebConsole：提供Web界面，支持Kafka集群状态监控、主题管理、消息查看等操作
• 预配置服务：组件间已完成基础配置，支持快速启动与使用

使用场景和适用范围

• 开发测试环境：快速搭建本地Kafka开发环境，无需手动配置多组件
• 学习与演示：学习Kafka架构及消息队列原理的便捷环境
• 小型项目部署：适用于对资源要求不高的小型应用或原型系统
• 教学与培训：作为Kafka相关技术培训的实验环境

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name kafka-env \
  -p 2181:2181 \  # Zookeeper端口
  -p 9092:9092 \  # Kafka端口
  -p 8080:8080 \  # Kafka WebConsole端口（假设默认）
  [镜像名称]

环境变量配置（可选）

可通过环境变量自定义服务配置：

• ZOOKEEPER_PORT：Zookeeper服务端口（默认2181）
• KAFKA_PORT：Kafka服务端口（默认9092）
• KAFKA_WEB_CONSOLE_PORT：WebConsole端口（默认8080）
• KAFKA_ADVERTISED_LISTENERS：Kafka对外暴露的监听器地址（默认PLAINTEXT://localhost:9092）

示例：

bash
docker run -d \
  --name kafka-env \
  -p 2181:2181 \
  -p 9093:9093 \
  -p 8081:8081 \
  -e KAFKA_PORT=9093 \
  -e KAFKA_WEB_CONSOLE_PORT=8081 \
  [镜像名称]

访问与验证

1. Zookeeper验证：通过telnet localhost 2181连接验证Zookeeper服务
2. Kafka验证：使用Kafka命令行工具创建主题并发送消息

   bash
   # 进入容器
   docker exec -it kafka-env bash
   # 创建主题
   kafka-topics.sh --create --topic test-topic --bootstrap-server localhost:9092 --partitions 1 --replication-factor 1
   # 发送测试消息
   kafka-console-producer.sh --topic test-topic --bootstrap-server localhost:9092
   

3. WebConsole访问：浏览器访问http://localhost:8080，通过Web界面管理Kafka集群

docker-compose配置示例

yaml
version: '3'
services:
  kafka-env:
    image: [镜像名称]
    container_name: kafka-env
    ports:
      - "2181:2181"
      - "9092:9092"
      - "8080:8080"
    environment:
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka-env:9092
    restart: unless-stopped