gguridi/kafka

Kafka服务器

镜像概述

本镜像用于在测试和开发环境中快速部署Kafka服务，方便验证集成功能。基于Alpine系统构建，体积小巧，但未针对性能进行优化，不建议用于生产环境或需要精细控制实例设置的场景。

核心功能与特性

• 版本灵活组合：支持通过构建参数指定Scala和Kafka版本，可生成多种版本组合的镜像
• 轻量级设计：基于Alpine系统，镜像体积小，适合开发测试环境快速部署
• 环境变量配置：通过环境变量可灵活覆盖Kafka和ZooKeeper的默认配置
• 自动化构建：支持自动生成多种版本标签，方便选择特定版本

使用场景

• 开发环境中快速搭建Kafka服务进行功能测试
• 集成测试中验证Kafka消息生产与消费流程
• 学习和演示Kafka基本功能与配置

构建方法

构建镜像需指定两个可选参数：

• SCALA_VERSION：指定Scala版本
• KAFKA_VERSION：指定Kafka版本

若未指定参数，将使用最新的Scala和Kafka版本构建镜像。

构建命令示例

bash
docker build -t {镜像名称:标签} --build-arg SCALA_VERSION=2.11 --build-arg KAFKA_VERSION=1.1.0 .

有关标签自动生成规则的更多信息，可查看hooks/pre_build文件或访问https://hub.docker.com/r/gguridi/kafka/tags/%E3%80%82

使用方法

可使用预构建镜像（https://hub.docker.com/r/gguridi/kafka/tags/%EF%BC%89%E6%88%96%E8%87%AA%E8%A1%8C%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%E3%80%82

基本运行

启动接受localhost连接的基础实例：

bash
docker run -d -p 9092:9092 gguridi/kafka:latest

指定版本运行

使用特定版本组合（标签格式：{Scala版本}-{Kafka版本}）：

bash
docker run -d -p 9092:9092 gguridi/kafka:2.11-2.0.0

查看https://hub.docker.com/r/gguridi/kafka/tags/%E8%8E%B7%E5%8F%96%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%E7%BB%84%E5%90%88%E3%80%82

配置说明

通过环境变量可覆盖Kafka和ZooKeeper的默认配置，格式如下：

• KAFKA__PROPERTY_NAME=value：用于配置Kafka的server.properties
• ZOOKEEPER__PROPERTY_NAME=value：用于配置ZooKeeper的zookeeper.properties

环境变量中的双下划线__会被替换为点.，用于表示配置属性层级。

配置示例

1. 设置Kafka的advertised.host.name属性：

   bash
   docker run -d -p 9092:9092 -e KAFKA__ADVERTISED_HOST_NAME=my-docker-image gguridi/kafka:latest
   

2. 配置Kafka监听器使用多个端口：

   bash
   docker run -d -p 9092:9092 -p 9093:9093 -e KAFKA__LISTENERS=PLAINTEXT://0.0.0.0:9092,SSL://0.0.0.0:9093 gguridi/kafka:latest
   

3. 修改Kafka日志目录：

   bash
   docker run -d -p 9092:9092 -e KAFKA__LOG_DIR=/var/kafka/log gguridi/kafka:latest