Kafka in Docker
This repository provides everything you need to run Kafka in Docker.
For convenience also contains a packaged proxy that can be used to get data from a legacy Kafka 7 cluster into a dockerized Kafka 8.
Why?
The main hurdle of running Kafka in Docker is that it depends on Zookeeper. Compared to other Kafka docker images, this one runs both Zookeeper and Kafka in the same container. This means:
- No dependency on an external Zookeeper host, or linking to another container
- Zookeeper and Kafka are configured to work together out of the box
Run
docker run -p 2181:2181 -p 9092:9092 \
--env ADVERTISED_HOST=`docker-machine ip \`docker-machine active\`` \
--env ADVERTISED_PORT=9092 \
--env KAFKA_CREATE_TOPICS="foo:1:1" \ # csv of <topic:n_partitions:repl_factor>
docker/kafka
export KAFKA=`docker-machine ip \`docker-machine active\``:9092
kafka-console-producer.sh --broker-list $KAFKA --topic test
export ZOOKEEPER=`docker-machine ip \`docker-machine active\``:2181
kafka-console-consumer.sh --zookeeper $ZOOKEEPER --topic test
Running the proxy
Take the same parameters as the docker/kafka image with some new ones:
CONSUMER_THREADS
- the number of threads to consume the source kafka 7 withTOPICS
- whitelist of topics to mirrorZK_CONNECT
- the zookeeper connect string of the source kafka 7GROUP_ID
- the group.id to use when consuming from kafka 7
docker run -p 2181:2181 -p 9092:9092 \
--env ADVERTISED_HOST=`boot2docker ip` \
--env ADVERTISED_PORT=9092 \
--env CONSUMER_THREADS=1 \
--env TOPICS=my-topic,some-other-topic \
--env ZK_CONNECT=kafka7zookeeper:2181/root/path \
--env GROUP_ID=mymirror \
docker/kafkaproxy
In the box
-
docker/kafka
The docker image with both Kafka and Zookeeper. Built from the
kafka
directory. -
docker/kafkaproxy
The docker image with Kafka, Zookeeper and a Kafka 7 proxy that can be configured with a set of topics to mirror.
Public Builds
https://registry.hub.docker.com/u/docker/kafka/
https://registry.hub.docker.com/u/docker/kafkaproxy/
Build from Source
docker build -t docker/kafka kafka/
docker build -t docker/kafkaproxy kafkaproxy/
Todo
- Not particularily optimzed for startup time.
- Better docs