You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by ij...@apache.org on 2022/02/14 15:23:09 UTC
[kafka] 01/01: MINOR: Clarify producer idempotence upgrade docs
This is an automated email from the ASF dual-hosted git repository.
ijuma pushed a commit to branch producer-idempotence-upgrade-docs-tweaks-1
in repository https://gitbox.apache.org/repos/asf/kafka.git
commit 71ee9fb45fd2f60f74afb6e9d2ab11bdeea1d08e
Author: Ismael Juma <is...@juma.me.uk>
AuthorDate: Mon Feb 14 07:16:21 2022 -0800
MINOR: Clarify producer idempotence upgrade docs
---
docs/upgrade.html | 26 ++++++++++++++++++++++----
1 file changed, 22 insertions(+), 4 deletions(-)
diff --git a/docs/upgrade.html b/docs/upgrade.html
index e0c9be3..8d53f0e 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -21,10 +21,9 @@
<h5><a id="upgrade_320_notable" href="#upgrade_320_notable">Notable changes in 3.2.0</a></h5>
<ul>
- <li>Idempotence for the producer is enabled by default. In 3.0.0 and 3.1.0, a bug prevented this default from being applied,
- which meant that idempotence remained disabled unless the user had explicitly set <code>enable.idempotence</code> to true
- (See <a href="https://issues.apache.org/jira/browse/KAFKA-13598">KAFKA-13598</a>for more details).
- This issue was fixed and the default is properly applied in 3.0.1, 3.1.1, and 3.2.0.</li>
+ <li>A bug prevented the producer idempotence default from being applied which meant that it remained disabled unless the user had explicitly set
+ <code>enable.idempotence</code> to true. See <a href="https://issues.apache.org/jira/browse/KAFKA-13598">KAFKA-13598</a>for more details.
+ This issue was fixed and the default is properly applied.</li>
</ul>
<h4><a id="upgrade_3_1_0" href="#upgrade_3_1_0">Upgrading to 3.1.0 from any version 0.8.x through 3.0.x</a></h4>
@@ -69,6 +68,13 @@
</li>
</ol>
+<h5><a id="upgrade_300_notable" href="#upgrade_301_notable">Notable changes in 3.1.1</a></h5>
+<ul>
+ <li>A bug prevented the producer idempotence default from being applied which meant that it remained disabled unless the user had explicitly set
+ <code>enable.idempotence</code> to true. See <a href="https://issues.apache.org/jira/browse/KAFKA-13598">KAFKA-13598</a>for more details.
+ This issue was fixed and the default is properly applied.</li>
+</ul>
+
<h5><a id="upgrade_310_notable" href="#upgrade_310_notable">Notable changes in 3.1.0</a></h5>
<ul>
<li>Apache Kafka supports Java 17.</li>
@@ -132,8 +138,20 @@
</li>
</ol>
+<h5><a id="upgrade_300_notable" href="#upgrade_301_notable">Notable changes in 3.0.1</a></h5>
+<ul>
+ <li>A bug prevented the producer idempotence default from being applied which meant that it remained disabled unless the user had explicitly set
+ <code>enable.idempotence</code> to true. See <a href="https://issues.apache.org/jira/browse/KAFKA-13598">KAFKA-13598</a>for more details.
+ This issue was fixed and the default is properly applied.</li>
+</ul>
+
<h5><a id="upgrade_300_notable" href="#upgrade_300_notable">Notable changes in 3.0.0</a></h5>
<ul>
+ <li>The producer has stronger delivery guarantees by default: <code>idempotence</code> is enabled and <code>acks</code> is set to <code>all</code> instead of <code>1</code>.
+ See <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-679%3A+Producer+will+enable+the+strongest+delivery+guarantee+by+default">KIP-679</a> for details.
+ In 3.0.0 and 3.1.0, a bug prevented the idempotence default from being applied which meant that it remained disabled unless the user had explicitly set
+ <code>enable.idempotence</code> to true. Note that the bug did not affect the <code>acks=all</code> change. See <a href="https://issues.apache.org/jira/browse/KAFKA-13598">KAFKA-13598</a>for more details.
+ This issue was fixed and the default is properly applied in 3.0.1, 3.1.1, and 3.2.0.
<li>ZooKeeper has been upgraded to version 3.6.3.</li>
<li>A preview of KRaft mode is available, though upgrading to it from the 2.8 Early Access release is not possible. See
the <code>config/kraft/README.md</code> file for details.</li>