aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStaffan Olsson <staffan@repos.se>2017-07-28 10:49:09 +0200
committerStaffan Olsson <staffan@repos.se>2017-07-28 10:49:09 +0200
commitb58165916ff156082c8ed8ea08a8c68c1506efdc (patch)
treeaa1d2e7148781e4943259a013c83e8bb721a3016
parent21a94a36b8515308d098b216bdf785db1e6c6612 (diff)
downloadkubernetes-kafka-b58165916ff156082c8ed8ea08a8c68c1506efdc.tar.gz
kubernetes-kafka-b58165916ff156082c8ed8ea08a8c68c1506efdc.tar.bz2
kubernetes-kafka-b58165916ff156082c8ed8ea08a8c68c1506efdc.zip
Review after github render
-rw-r--r--README.md16
1 files changed, 8 insertions, 8 deletions
diff --git a/README.md b/README.md
index 97b6d46..2c747dc 100644
--- a/README.md
+++ b/README.md
@@ -7,20 +7,20 @@ Good for both experiments and production.
How to use:
* Run a Kubernetes cluster, [minikube](https://github.com/kubernetes/minikube) or real.
- * To quickly get a small Kafka cluster running, use the `kubectl apply`s below.
- * To start using Kafka for real, fork and have a look at [addon](https://github.com/Yolean/kubernetes-kafka/labels/addon)s.
- * Join the discussion here in issues and PRs.
+ * Quickstart: use the `kubectl apply`s below.
+ * Kafka for real: fork and have a look at [addon](https://github.com/Yolean/kubernetes-kafka/labels/addon)s.
+ * Join the discussion in issues and PRs.
Why?
-See for yourself. No single readable readme can properly introduce both Kafka and Kubernets.
+See for yourself, but we think this project gives you better adaptability than [helm](https://github.com/kubernetes/helm) [chart](https://github.com/kubernetes/charts/tree/master/incubator/kafka)s. No single readable readme or template can properly introduce both Kafka and Kubernets.
Back when we read [Newman](http://samnewman.io/books/building_microservices/) we were beginners with both.
-Now we read [Kleppmann](http://dataintensive.net/), [Confluent's blog](https://www.confluent.io/blog/) and [SRE](https://landing.google.com/sre/book.html) and enjoy this "Streaming Platform" lock-in :smile:.
+Now we've read [Kleppmann](http://dataintensive.net/), [Confluent](https://www.confluent.io/blog/) and [SRE](https://landing.google.com/sre/book.html) and enjoy this "Streaming Platform" lock-in :smile:.
## What you get
Keep an eye on `kubectl --namespace kafka get pods -w`.
-[Bootstrap servers](http://kafka.apache.org/documentation/#producerconfigs): `kafka-0.broker.kafka.svc.cluster.local:9092,kafka-1.broker.kafka.svc.cluster.local:9092,kafka-2.broker.kafka.svc.cluster.local:9092`
+The goal is to provide [Bootstrap servers](http://kafka.apache.org/documentation/#producerconfigs): `kafka-0.broker.kafka.svc.cluster.local:9092,kafka-1.broker.kafka.svc.cluster.local:9092,kafka-2.broker.kafka.svc.cluster.local:9092`
`
Zookeeper at `zookeeper.kafka.svc.cluster.local:2181`.
@@ -30,7 +30,7 @@ Zookeeper at `zookeeper.kafka.svc.cluster.local:2181`.
The [Kafka book](https://www.confluent.io/resources/kafka-definitive-guide-preview-edition/) recommends that Kafka has its own Zookeeper cluster with at least 5 instances.
```
-kubectl create -f ./zookeeper/
+kubectl apply -f ./zookeeper/
```
To support automatic migration in the face of availability zone unavailability we mix persistent and ephemeral storage.
@@ -38,7 +38,7 @@ To support automatic migration in the face of availability zone unavailability w
## Start Kafka
```
-kubectl create -f ./
+kubectl apply -f ./
```
You might want to verify in logs that Kafka found its own DNS name(s) correctly. Look for records like: