README.rst

Apache Kafka topology for clusterdock

This repository houses the Apache Kafka topology for clusterdock.

Usage

Assuming you've already installed clusterdock (if not, go read the docs), you use this topology by cloning it to a local folder and then running commands with the clusterdock script:

$ git clone https://github.com/clusterdock/topology_apache_kafka.git
$ clusterdock start topology_apache_kafka --kafka-version 1.0.0 --scala-version 2.11

To see full usage instructions for the start action, use -h/--help:

$ clusterdock start topology_apache_kafka -h
usage: clusterdock start [--always-pull] [--namespace ns] [--network nw]
                         [-o sys] [-r url] [-h] [--kafka-version ver]
                         [--scala-version ver] [--brokers node [node ...]]
                         topology

Start a Kafka cluster

positional arguments:
  topology              A clusterdock topology directory

optional arguments:
  --always-pull         Pull latest images, even if they're available locally
                        (default: False)
  --namespace ns        Namespace to use when looking for images (default:
                        None)
  --network nw          Docker network to use (default: cluster)
  -o sys, --operating-system sys
                        Operating system to use for cluster nodes (default:
                        None)
  -r url, --registry url
                        Docker Registry from which to pull images (default:
                        docker.io)
  -h, --help            show this help message and exit

Kafka arguments:
  --kafka-version ver   Kafka version to use (default: 1.0.0)
  --scala-version ver   Scala version to use (default: 2.11)

Node groups:
  --brokers node [node ...]
                        Nodes of the brokers group (default: ['node-1'])