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 23:26:23 UTC
[kafka] branch 3.1 updated: MINOR: Clarify producer idempotence default in upgrade docs (#11757)
This is an automated email from the ASF dual-hosted git repository.
ijuma pushed a commit to branch 3.1
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/3.1 by this push:
new 0243ef1 MINOR: Clarify producer idempotence default in upgrade docs (#11757)
0243ef1 is described below
commit 0243ef192a5e022cf5903fd8bd905860e5dc04d9
Author: Ismael Juma <is...@juma.me.uk>
AuthorDate: Mon Feb 14 15:17:44 2022 -0800
MINOR: Clarify producer idempotence default in upgrade docs (#11757)
* Mention `acks=1` to `acks=all` change in 3.0.0 upgrade docs
* Have a separate section for 3.0.1 and 3.1.1 as some may skip the
3.0.0/3.1.0 section when upgrading to a bug fix.
* Move the 3.0.0 note to the top since it's more impactful than the
other changes.
Reviewers: Jason Gustafson <ja...@confluent.io>
---
docs/upgrade.html | 24 +++++++++++++++++++-----
1 file changed, 19 insertions(+), 5 deletions(-)
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 9bf6b95..fccb3a4 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -61,6 +61,13 @@
</li>
</ol>
+<h5><a id="upgrade_311_notable" href="#upgrade_311_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>
@@ -80,11 +87,6 @@
for more details.</li>
<li>IBP 3.1 introduces topic IDs to FetchRequest as a part of
<a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-516%3A+Topic+Identifiers">KIP-516</a>.</li>
- <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>
</ul>
<h4><a id="upgrade_3_0_0" href="#upgrade_3_0_0">Upgrading to 3.0.0 from any version 0.8.x through 2.8.x</a></h4>
@@ -129,8 +131,20 @@
</li>
</ol>
+<h5><a id="upgrade_301_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>