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:30:14 UTC
[kafka] branch 3.0 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.0
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/3.0 by this push:
new fca968c MINOR: Clarify producer idempotence default in upgrade docs (#11757)
fca968c is described below
commit fca968c2a79a4dc30089a17f633f58ebd29f1d64
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 | 17 ++++++++++++-----
1 file changed, 12 insertions(+), 5 deletions(-)
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 6e35533..6897170 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -19,8 +19,20 @@
<script id="upgrade-template" type="text/x-handlebars-template">
+<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>
@@ -98,11 +110,6 @@
understood by brokers or version 2.5 or higher, so you must upgrade your kafka cluster to get the stronger semantics. Otherwise, you can just pass
in <code>new ConsumerGroupMetadata(consumerGroupId)</code> to work with older brokers. See <a href="https://cwiki.apache.org/confluence/x/zJONCg">KIP-732</a> for more details.
</li>
- <li>Idempotence for the producer is enabled by default. In 3.0.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.
- </li>
<li>
The Connect <code>internal.key.converter</code> and <code>internal.value.converter</code> properties have been completely <a href="https://cwiki.apache.org/confluence/x/2YDOCg">removed</a>.
The use of these Connect worker properties has been deprecated since version 2.0.0.