This is an automated email from the ASF dual-hosted git repository.
junrao pushed a commit to branch 2.8
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/2.8 by this push:
new a7bbaa8 MINOR: Add note about topic IDs to upgrade doc (#10125)
a7bbaa8 is described below
commit a7bbaa86da87cd4b5b920458f81a1d1e4c024cd0
Author: Justine Olshan <[email protected]>
AuthorDate: Wed Feb 17 12:45:40 2021 -0500
MINOR: Add note about topic IDs to upgrade doc (#10125)
Reviewers: Jun Rao <[email protected]>
---
docs/upgrade.html | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 9b43244..9ce1037 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -23,13 +23,17 @@
<ul>
<li>
The 2.8.0 release added a new method to the Authorizer Interface
introduced in
- <a href="https://cwiki.apache.org/confluen
ce/display/KAFKA/KIP-679%3A+Producer+will+enable+the+strongest+delivery+guarantee+by+default">KIP-679</a>.
+ <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-679%3A+Producer+will+enable+the+strongest+delivery+guarantee+by+default";>KIP-679</a>.
The motivation is to unblock our future plan to enable the strongest
message delivery guarantee by default.
Custom authorizer should consider providing a more efficient
implementation that supports audit logging and any custom configs or access
rules.
</li>
-</ul>
-
-<ul>
+ <li>
+ IBP 2.8 introduces topic IDs to topics as a part of
+ <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-516%3A+Topic+Identifiers";>KIP-516</a>.
+ When using ZooKeeper, this information is stored in the TopicZNode. If
the cluster is downgraded to a previous IBP or version,
+ future topics will not get topic IDs and it is not guaranteed that
topics will retain their topic IDs in ZooKeeper.
+ This means that upon upgrading again, some topics or all topics will
be assigned new IDs.
+ </li>
<li>Kafka Streams introduce a type-safe <code>split()</code> operator as a
substitution for deprecated <code>KStream#branch()</code> method
(cf. <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-418%3A+A+method-chaining+way+to+branch+KStream";>KIP-418</a>).
</li>
