This is an automated email from the ASF dual-hosted git repository.
showuon pushed a commit to branch 4.0
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/4.0 by this push:
new 5df681bf8a3 MINOR: improve upgrade to v4.0.0 doc (#19172)
5df681bf8a3 is described below
commit 5df681bf8a397b966b60a5676e01822a903311e3
Author: Luke Chen <[email protected]>
AuthorDate: Tue Mar 11 16:48:42 2025 +0900
MINOR: improve upgrade to v4.0.0 doc (#19172)
In "Upgrading to 4.0.0 from any version 0.8.x through 3.9.x" section, we
directly give instructions about [Upgrading to KRaft-based
clusters](https://kafka.apache.org/documentation/#upgrade_390_kraft),
but there might still be some users under ZK cluster before upgrading to
v4.0.0. We need to make it clear that they need to upgrade to KRaft mode
first before upgrading to v4.0.0 in "Upgrading to 4.0.0 from any version
0.8.x through 3.9.x" section.
Reviewers: TengYao Chi <[email protected]>, Ken Huang
<[email protected]>, Chia-Ping Tsai <[email protected]>
---
docs/upgrade.html | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 29e499f8f97..cab3672ea02 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -21,6 +21,12 @@
<h4><a id="upgrade_4_0_0" href="#upgrade_4_0_0">Upgrading to 4.0.0 from any
version 0.8.x through 3.9.x</a></h4>
+<p>Note: Apache Kafka 4.0 only supports KRaft mode - ZooKeeper mode has been
removed. As such, <b>broker upgrades to 4.0.0 (and higher) require KRaft mode
and
+ the software and metadata versions must be at least 3.3.x</b> (the first
version when KRaft mode was deemed production ready). For clusters in KRaft mode
+ with versions older than 3.3.x, we recommend upgrading to 3.9.x before
upgrading to 4.0.x. Clusters in ZooKeeper mode
+ have to be <a
href="/{{version}}/documentation.html#kraft_zk_migration">migrated to KRaft
mode</a> before they can be upgraded to 4.0.x.
+</p>
+
<p><b>For a rolling upgrade:</b></p>
<ol>
@@ -51,10 +57,8 @@
<a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-896%3A+Remove+old+client+protocol+API+versions+in+Kafka+4.0";>KIP-896</a>
for the details.
</li>
<li>
- Apache Kafka 4.0 only supports KRaft mode - ZooKeeper mode has
been removed. As such, broker upgrades to 4.0.x (and higher) require KRaft mode
and
- the software and metadata versions must be at least 3.3.x (the
first version when KRaft mode was deemed production ready). For clusters in
KRaft mode
- with versions older than 3.3.x, we recommend upgrading to 3.9.x
before upgrading to 4.0.x. Clusters in ZooKeeper mode
- have to be <a
href="/39/documentation.html#kraft_zk_migration">migrated to KRaft mode</a>
before they can be upgraded to 4.0.x.
+ Apache Kafka 4.0 only supports KRaft mode - ZooKeeper mode has
been removed. About version upgrade,
+ check <a
href="/{{version}}/documentation.html#upgrade_4_0_0">Upgrading to 4.0.0 from
any version 3.3.x through 3.9.x</a> for more info.
</li>
<li>
Apache Kafka 4.0 ships with a brand-new group coordinator
implementation (See <a
href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=217387038#KIP848:TheNextGenerationoftheConsumerRebalanceProtocol-GroupCoordinator";>here</a>).
