You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kafka.apache.org by mj...@apache.org on 2018/02/07 21:08:52 UTC
[kafka] 01/02: MINOR: update upgrade notes for Streams API;
message format 0.10 requiered (#4500)
This is an automated email from the ASF dual-hosted git repository.
mjsax pushed a commit to branch 1.1
in repository https://gitbox.apache.org/repos/asf/kafka.git
commit 8362164aad00830f0aabb99bae8afdde3a273a65
Author: Matthias J. Sax <mj...@apache.org>
AuthorDate: Wed Feb 7 11:43:57 2018 -0800
MINOR: update upgrade notes for Streams API; message format 0.10 requiered (#4500)
Author: Matthias J. Sax <ma...@confluent.io>
Reviewers: Bill Bejeck <bi...@confluent.io>, Guozhang Wang <gu...@confluent.io.>
---
docs/streams/developer-guide/datatypes.html | 2 +-
docs/streams/developer-guide/write-streams.html | 10 +++++-----
docs/upgrade.html | 3 ++-
3 files changed, 8 insertions(+), 7 deletions(-)
diff --git a/docs/streams/developer-guide/datatypes.html b/docs/streams/developer-guide/datatypes.html
index 155ee2c..a86ea3e 100644
--- a/docs/streams/developer-guide/datatypes.html
+++ b/docs/streams/developer-guide/datatypes.html
@@ -102,7 +102,7 @@
<div class="highlight-xml"><div class="highlight"><pre><span></span><span class="nt"><dependency></span>
<span class="nt"><groupId></span>org.apache.kafka<span class="nt"></groupId></span>
<span class="nt"><artifactId></span>kafka-clients<span class="nt"></artifactId></span>
- <span class="nt"><version></span>1.0.0-cp1<span class="nt"></version></span>
+ <span class="nt"><version></span>{{fullDotVersion}}<span class="nt"></version></span>
<span class="nt"></dependency></span>
</pre></div>
</div>
diff --git a/docs/streams/developer-guide/write-streams.html b/docs/streams/developer-guide/write-streams.html
index c9ca49c..1e4213d 100644
--- a/docs/streams/developer-guide/write-streams.html
+++ b/docs/streams/developer-guide/write-streams.html
@@ -69,12 +69,12 @@
<tbody valign="top">
<tr class="row-even"><td><code class="docutils literal"><span class="pre">org.apache.kafka</span></code></td>
<td><code>kafka-streams</code></td>
- <td><code class="docutils literal"><span class="pre">1.0.0</span></code></td>
+ <td><code class="docutils literal"><span class="pre">{{fullDotVersion}}</span></code></td>
<td>(Required) Base library for Kafka Streams.</td>
</tr>
<tr class="row-odd"><td><code class="docutils literal"><span class="pre">org.apache.kafka</span></code></td>
<td><code class="docutils literal"><span class="pre">kafka-clients</span></code></td>
- <td><code class="docutils literal"><span class="pre">1.0.0</span></code></td>
+ <td><code class="docutils literal"><span class="pre">{{fullDotVersion}}</span></code></td>
<td>(Required) Kafka client library. Contains built-in serializers/deserializers.</td>
</tr>
</tbody>
@@ -87,12 +87,12 @@
<div class="highlight-xml"><div class="highlight"><pre><span></span><span class="nt"><dependency></span>
<span class="nt"><groupId></span>org.apache.kafka<span class="nt"></groupId></span>
<span class="nt"><artifactId></span>kafka-streams<span class="nt"></artifactId></span>
- <span class="nt"><version></span>1.0.0<span class="nt"></version></span>
+ <span class="nt"><version></span>{{fullDotVersion}}<span class="nt"></version></span>
<span class="nt"></dependency></span>
<span class="nt"><dependency></span>
<span class="nt"><groupId></span>org.apache.kafka<span class="nt"></groupId></span>
<span class="nt"><artifactId></span>kafka-clients<span class="nt"></artifactId></span>
- <span class="nt"><version></span>1.0.0<span class="nt"></version></span>
+ <span class="nt"><version></span>{{fullDotVersion}}<span class="nt"></version></span>
<span class="nt"></dependency></span>
</pre></div>
@@ -245,4 +245,4 @@
// Display docs subnav items
$('.b-nav__docs').parent().toggleClass('nav__item__with__subs--expanded');
});
-</script>
\ No newline at end of file
+</script>
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 3c2d976..775b62a 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -197,7 +197,8 @@
<h5><a id="upgrade_100_streams" href="#upgrade_100_streams">Upgrading a 1.0.0 Kafka Streams Application</a></h5>
<ul>
<li> Upgrading your Streams application from 0.11.0 to 1.0.0 does not require a broker upgrade.
- A Kafka Streams 1.0.0 application can connect to 0.11.0, 0.10.2 and 0.10.1 brokers (it is not possible to connect to 0.10.0 brokers though). </li>
+ A Kafka Streams 1.0.0 application can connect to 0.11.0, 0.10.2 and 0.10.1 brokers (it is not possible to connect to 0.10.0 brokers though).
+ However, Kafka Streams 1.0 requires 0.10 message format or newer and does not work with older message formats. </li>
<li> If you are monitoring on streams metrics, you will need make some changes to the metrics names in your reporting and monitoring code, because the metrics sensor hierarchy was changed. </li>
<li> There are a few public APIs including <code>ProcessorContext#schedule()</code>, <code>Processor#punctuate()</code> and <code>KStreamBuilder</code>, <code>TopologyBuilder</code> are being deprecated by new APIs.
We recommend making corresponding code changes, which should be very minor since the new APIs look quite similar, when you upgrade.
--
To stop receiving notification emails like this one, please contact
mjsax@apache.org.