kafka/docs
Kevin Wu 857b1e92cc
KAFKA-19719: --no-initial-controllers should not assume kraft.version=1 (#20551)
Just because a controller node sets --no-initial-controllers flag does
not mean it is necessarily running kraft.version=1. The more precise
meaning is that the controller node being formatted does not know what
kraft version the cluster should be in, and therefore it is only safe to
assume kraft.version=0. Only by setting
--standalone,--initial-controllers, or --no-initial-controllers
AND not specifying the controller.quorum.voters static config, is it
known kraft.version > 0.

For example, it is a valid configuration (although confusing) to run a
static   quorum defined by controller.quorum.voters but have all the
controllers   format with --no-initial-controllers. In this case,
specifying --no-initial-controllers alongside a metadata version that
does not  support kraft.version=1 causes formatting to fail, which is
a  regression.

Additionally, the formatter should not check the kraft.version against
the release version, since kraft.version does not actually depend on any
release version. It should only check the kraft.version against the
static voters config/format arguments.

This PR also cleans up the integration test framework to match the
semantics of formatting an actual cluster.

Reviewers: TengYao Chi <kitingiao@gmail.com>, Kuan-Po Tseng
 <brandboat@gmail.com>, Chia-Ping Tsai <chia7712@gmail.com>, José
 Armando García Sancio <jsancio@apache.org>
2025-09-25 12:56:16 -04:00
..
documentation KAFKA-18074: Add kafka client compatibility matrix (#18091) 2025-03-11 18:38:37 -07:00
images KAFKA-18111: Add Kafka Logo to README (#18452) 2025-01-08 17:17:31 -08:00
js MINOR: Bump trunk to 4.2.0-SNAPSHOT (#19944) 2025-06-11 09:24:57 +02:00
streams KAFKA-15307: Kafka Streams configuration docs outdated (#20408) 2025-09-08 17:35:12 -07:00
README.md KAFKA-16467: add docs README (#15664) 2024-04-30 10:26:35 +08:00
api.html KAFKA-19353: Upgrade note and initial docs for KIP-932 (#19863) 2025-06-03 13:23:11 +01:00
compatibility-summary.html KAFKA-18074: Add kafka client compatibility matrix (#18091) 2025-03-11 18:38:37 -07:00
configuration.html KAFKA-19112 Unifying LIST-Type Configuration Validation and Default Values (#20334) 2025-09-06 01:25:55 +08:00
connect.html MINOR: Tidy up the Connect docs (#20531) 2025-09-25 09:39:37 +02:00
design.html KAFKA-19283: Update transaction exception handling documentation (#19931) 2025-06-09 17:07:29 -07:00
docker.html MINOR: Refresh of the docs (#16375) 2024-06-18 17:15:47 +02:00
documentation.html KAFKA-18074: Add kafka client compatibility matrix (#18091) 2025-03-11 18:38:37 -07:00
ecosystem.html MINOR: Use immutable KIP link (#19153) 2025-03-09 23:42:33 +08:00
implementation.html KAFKA-19644 Enhance the documentation for producer headers and integration tests (#20524) 2025-09-20 11:46:19 +08:00
introduction.html MINOR: Use immutable KIP link (#19153) 2025-03-09 23:42:33 +08:00
ops.html KAFKA-19719: --no-initial-controllers should not assume kraft.version=1 (#20551) 2025-09-25 12:56:16 -04:00
protocol.html MINOR: Use immutable KIP link (#19153) 2025-03-09 23:42:33 +08:00
quickstart.html KAFKA-18229: Move configs out of "kraft" directory (#18389) 2025-01-22 15:47:57 +01:00
security.html KAFKA-19623: Implement KIP-1147 for console producer/consumer/share-consumer. (#20479) 2025-09-17 15:28:20 +01:00
toc.html MINOR: add missing section to TOC (#20305) 2025-08-05 14:27:09 -07:00
upgrade.html KAFKA-15186 AppInfo metrics don't contain the client-id (#20493) 2025-09-21 16:28:03 +08:00
uses.html MINOR: Various fixes in the docs (#14914) 2023-12-04 22:06:49 +01:00
zk2kraft-summary.html MINOR: Adjust ToC of zk2kraft and fix wrong section number of docker (#19146) 2025-03-09 08:55:50 +08:00

README.md

Docs

The documentation needs to run with kafka-site. Please check the README in the kafka-site repository to preview documentation locally.