KAFKA-21128: Generalize version in upgrade guide - #23524
Open
Parkerhiphop wants to merge 2 commits into
Open
Parkerhiphop wants to merge 2 commits into
Parkerhiphop wants to merge 2 commits into
Conversation
chia7712
reviewed
Sep 20, 2026
| # Upgrade Guide and API Changes | ||
|
|
||
| Upgrading from any older version to 4.3.0 is possible: if upgrading from 3.4 or below, you will need to do two rolling bounces, where during the first rolling bounce phase you set the config `upgrade.from="older version"` (possible values are `"2.4" - "3.4"`) and during the second you remove it. This is required to safely handle 2 changes. The first is a change in foreign-key join serialization format. The second is a change in the serialization format for an internal repartition topic. For more details, please refer to [KIP-904](https://cwiki.apache.org/confluence/x/P5VbDg): | ||
| Upgrading from any older version to the current release is possible: if upgrading from 3.4 or below, you will need to do two rolling bounces, where during the first rolling bounce phase you set the config `upgrade.from="older version"` (possible values are `"2.4" - "3.4"`) and during the second you remove it. This is required to safely handle 2 changes. The first is a change in foreign-key join serialization format. The second is a change in the serialization format for an internal repartition topic. For more details, please refer to [KIP-904](https://cwiki.apache.org/confluence/x/P5VbDg): |
Member
There was a problem hiding this comment.
Would you mind updating the links hardcoded with /43/ to use /{version}/ as well?
Contributor
Author
There was a problem hiding this comment.
Yes. I have updated all links.
chia7712
reviewed
Sep 21, 2026
| ## Streams API changes in 3.6.0 | ||
|
|
||
| Rack aware task assignment was introduced in [KIP-925](https://cwiki.apache.org/confluence/x/CQ40Dw). Rack aware task assignment can be enabled for `StickyTaskAssignor` or `HighAvailabilityTaskAssignor` to compute task assignments which can minimize cross rack traffic under certain conditions. For more information, including how it can be enabled and further configured, see the [**Kafka Streams Developer Guide**](/43/documentation/streams/developer-guide/config-streams.html#rack-aware-assignment-strategy). | ||
| Rack aware task assignment was introduced in [KIP-925](https://cwiki.apache.org/confluence/x/CQ40Dw). Rack aware task assignment can be enabled for `StickyTaskAssignor` or `HighAvailabilityTaskAssignor` to compute task assignments which can minimize cross rack traffic under certain conditions. For more information, including how it can be enabled and further configured, see the [**Kafka Streams Developer Guide**](/{version}/documentation/streams/developer-guide/config-streams.html#rack-aware-assignment-strategy). |
Member
There was a problem hiding this comment.
/{version}/documentation/streams/developer-guide/config-streams.html#rack-aware-assignment-strategy).
Those links are broken. Would you mind fixing them in this PR as well?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The upgrade guide currently refers specifically to 4.3.0 when describing the upgrade path.
This updates the wording to use a more general version so the instructions also apply to later releases.
Reviewers: Chia-Ping Tsai chia7712@gmail.com