KAFKA-18422: add Kafka client upgrade path #19097
Conversation
|
Preview: As the discussion on KIP-1124 is still ongoing and the content is quite extensive with many details, it may not be ideal to include everything in the documentation. Instead, we can add a KIP link to the doc. By the way, I'm unsure if the current location of the documentation is appropriate. Let me know if you have any suggestions. Thank you! |
Thanks for the comment @frankvicky. Perhaps not? zk2kraft.html focuses on ZK migration to KRaft, which seems more related to the server side. In contrast, KIP-1124 focuses on the client upgrade. |
docs/upgrade.html
Outdated
| @@ -46,6 +46,9 @@ <h4><a id="upgrade_4_0_0" href="#upgrade_4_0_0">Upgrading to 4.0.0 from any vers | |||
| Every <a href="https://github.com/apache/kafka/blob/trunk/server-common/src/main/java/org/apache/kafka/server/common/MetadataVersion.java">MetadataVersion</a> | |||
| has a boolean parameter that indicates if there are metadata changes (i.e. <code>IBP_4_0_IV1(23, "4.0", "IV1", true)</code> means this version has metadata changes). | |||
| Given your current and target versions, a downgrade is only possible if there are no metadata changes in the versions between.</li> | |||
| <li>For the Kafka client upgrade path, note that many deprecated APIs were removed in Kafka 4.0. Additionally, upgrading directly to 4.x from certain versions is not feasible. | |||
| For more information, please refer to <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-1124%3A+Providing+a+clear+Kafka+Client+upgrade+path+for+4.x">KIP-1124</a>. | |||
There was a problem hiding this comment.
Could you please use https://cwiki.apache.org/confluence/x/y4kgF instead? otherwise, the link gets invalid after renaming.
|
I'm going to merge this PR for 4.0 RC1, and we will keep tweaking the docs |
Add client upgrade documentation, for more information, please refer to https://cwiki.apache.org/confluence/x/y4kgF Reviewers: TengYao Chi <[email protected]>, Chia-Ping Tsai <[email protected]>
|
cherry-pick to 4.0 |
Add client upgrade documentation, for more information, please refer to https://cwiki.apache.org/confluence/x/y4kgF