You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by ju...@apache.org on 2021/02/17 17:47:59 UTC

[kafka] branch 2.8 updated: MINOR: Add note about topic IDs to upgrade doc (#10125)

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 <jo...@confluent.io>
AuthorDate: Wed Feb 17 12:45:40 2021 -0500

    MINOR: Add note about topic IDs to upgrade doc (#10125)
    
    Reviewers: Jun Rao <ju...@gmail.com>
---
 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>