KRaft: a new controller can bootstrap against itself and never join the quorum

Open
#1,062 0 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@razvan is already working on this.

Since Nov 13, 2026.

  • #1063 by @razvan — open

Assessment

This issue has not been assessed yet.

Description

type/bug
Description

A controller that starts without metadata (a new pod, e.g. after scaling up a controller role group) finds the quorum leader through controller.quorum.bootstrap.servers. Outside Kerberos, that list has one entry per controller role group: the role group's headless Service. That Service sets publishNotReadyAddresses: true, so the name also resolves to the starting pod's own IP.

Kafka treats each entry in controller.quorum.bootstrap.servers as one bootstrap node and resolves its name when it connects. If the starting pod's lookup returns its own IP, the connection succeeds, so Kafka never tries another address. The pod asks itself for the leader, gets no answer, and repeats this forever.

This is a race in the quorum management added in #1010.

Symptoms
  • The new controller stays in Raft state unattached (epoch 0) and never becomes an observer. The quorum's replication status doesn't list it at all.
  • Its quorum-manager sidecar logs Local Raft state is 'unattached', nothing to do indefinitely, so it never calls add-controller.
  • The kafka container never becomes ready, and the StatefulSet rollout stalls. Because the StatefulSet uses OrderedReady, later replicas are not created either.
  • The pod's only connections on the controller port go to its own IP.
  • Deleting the pod usually clears it: the replacement resolves another IP and joins normally.
Dominant language
Rust
Stars
31
Forks
9
Avg merge
4d 5h
Merged PRs (30d)
14

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from stackabletech/kafka-operator

All issues in stackabletech/kafka-operator

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.