diff options
author | solsson <solsson@gmail.com> | 2018-02-03 14:52:58 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2018-02-03 14:52:58 +0100 |
commit | 467fbb9010c11fd5c2c8e95a2d5f146c356c85a4 (patch) | |
tree | 58254534d9fde69f6b3d2236fce7e3290aa2c331 /maintenance/README.md | |
parent | 5a2b8c72d43c82c4333c3f523e23bbbc17833fc9 (diff) | |
parent | 43c896bc65225ebd1184967e82045b172dc35497 (diff) | |
download | kubernetes-kafka-467fbb9010c11fd5c2c8e95a2d5f146c356c85a4.tar.gz kubernetes-kafka-467fbb9010c11fd5c2c8e95a2d5f146c356c85a4.tar.bz2 kubernetes-kafka-467fbb9010c11fd5c2c8e95a2d5f146c356c85a4.zip |
Merge pull request #95 from Yolean/ops-jobs
Add Jobs and tests for common maintenance operations
Diffstat (limited to 'maintenance/README.md')
-rw-r--r-- | maintenance/README.md | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/maintenance/README.md b/maintenance/README.md new file mode 100644 index 0000000..5830d79 --- /dev/null +++ b/maintenance/README.md @@ -0,0 +1,32 @@ + +## Re-assign Leadership + +This is one of the cases where this repo begs to differ from traditional Kafka setups. +In Kubernetes the restart of a pod, and subsequent start on a different node, should be a non-event. + +> ”when a broker is stopped and restarted, it does not resume leadership of any partitions automatically” + +_-- Neha Narkhede, Gwen Shapira, and Todd Palino. ”Kafka: The Definitive Guide”_ + +Create the `preferred-replica-election-job.yml` resource, after deleting any previous one. + +## Change a Partition's Replicas + +> ”From time to time, it may be necessary to change the replica assignments for a partition. Some examples of when this might be needed are: +> * If a topic’s partitions are not balanced across the cluster, causing uneven load on brokers +> * If a broker is taken offline and the partition is under-replicated +> * If a new broker is added and needs to receive a share of the cluster load” + +_-- Neha Narkhede, Gwen Shapira, and Todd Palino. ”Kafka: The Definitive Guide”_ + +Use the `reassign-paritions-job.yml`, after editing `TOPICS` and `BROKERS`. + +## Increase a topic's replication factor + +See https://github.com/Yolean/kubernetes-kafka/pull/140 + +Use the `replication-factor-increase-job.yml`, after editing `TOPICS` and `BROKERS`. + +The affected topics may end up without a preferred replica. See above to fix that, +or to affect only your selected topics use [Kafka Manager](https://github.com/Yolean/kubernetes-kafka/pull/83)'s topic screen, +Generate Partition Assignments followed by Reassign Partitions. |