aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorStaffan Olsson <staffan@repos.se>2017-06-25 21:40:12 +0200
committerStaffan Olsson <staffan@repos.se>2017-06-25 21:40:12 +0200
commita8c8a39713cbe5ae6199f0733454ae05cfd4eb20 (patch)
tree91d637084ab2454f5f537ecadc06a46f036e4859 /README.md
parent9479e819475f128e7fb1d82c5df0abae6c9cfa76 (diff)
downloadkubernetes-kafka-a8c8a39713cbe5ae6199f0733454ae05cfd4eb20.tar.gz
kubernetes-kafka-a8c8a39713cbe5ae6199f0733454ae05cfd4eb20.tar.bz2
kubernetes-kafka-a8c8a39713cbe5ae6199f0733454ae05cfd4eb20.zip
Updates the readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 8 insertions, 7 deletions
diff --git a/README.md b/README.md
index 5b9dbad..cb401d1 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,12 @@ To get consistent service DNS names `kafka-N.broker.kafka`(`.svc.cluster.local`)
kubectl create -f 00namespace.yml
```
+## Prepare your cluster
+
+For Minikube run `kubectl create -f configure-minikube/`.
+
+There's a similar setup for gke, in `configure-gke` of course. You might want to tweak it before creating.
+
## Set up volume claims
You may add [storage class](http://kubernetes.io/docs/user-guide/persistent-volumes/#storageclasses)
@@ -24,18 +30,13 @@ kubectl -n kafka get pvc
## Set up Zookeeper
-The Kafka book (Definitive Guide, O'Reilly 2016) recommends that Kafka has its own Zookeeper cluster with at least 5 instances,
-so we use the [official docker image](https://hub.docker.com/_/zookeeper/)
-but with a [startup script change to guess node id from hostname](https://github.com/solsson/zookeeper-docker/commit/df9474f858ad548be8a365cb000a4dd2d2e3a217).
+The Kafka book (Definitive Guide, O'Reilly 2016) recommends that Kafka has its own Zookeeper cluster with at least 5 instances.
+We use the zookeeper build that comes with the Kafka distribution, and tweak the startup command to support StatefulSet.
```
kubectl create -f ./zookeeper/
```
-Despite being a StatefulSet, there is no persistent volume by default.
-If you lose your zookeeper cluster, kafka will be unaware that persisted topics exist.
-The data is still there, but you need to re-create topics.
-
## Start Kafka
Assuming you have your PVCs `Bound`, or enabled automatic provisioning (see above), go ahead and: