WIP MINOR: Copy over apache/kafka/3.6 docs into master #586
Conversation
|
|
||
| <h1>Documentation</h1> | ||
| <h3>Kafka 3.6 Documentation</h3> | ||
| <h3>Kafka 3.4 Documentation</h3> |
There was a problem hiding this comment.
this is stale
There was a problem hiding this comment.
apache/kafka@4302653 is missing in AK/3.6.x
There was a problem hiding this comment.
This does not seem right. This is the 3.6 documentation so it should be Kafka 3.6.
| url: https://www.apache.org/licenses/LICENSE-2.0.html | ||
| title: Kafka Connect REST API | ||
| version: 3.6.1 | ||
| version: 3.6.2-SNAPSHOT |
There was a problem hiding this comment.
shouldn't be snapshot
There was a problem hiding this comment.
Again we don't want this change. The docs should cover the last released version for 3.6, hence 3.6.1.
| "version": "36", | ||
| "dotVersion": "3.6", | ||
| "fullDotVersion": "3.6.1", | ||
| "fullDotVersion": "3.6.2-SNAPSHOT", |
There was a problem hiding this comment.
shouldn't be snapshot, I should check out 3.6.1 and build from there I think
There was a problem hiding this comment.
Yes we want this to stay 3.6.1
| </pre> | ||
| </p> | ||
|
|
||
| <p>Try to send messages to the `tieredTopic` topic to roll the log segment:</p> |
There was a problem hiding this comment.
Seems like this should be kept?
There was a problem hiding this comment.
Need to find the commit that introduced this
There was a problem hiding this comment.
Yes I'd keep the larger section we currently have in the docs.
| Every <a href="https://github.com/apache/kafka/blob/trunk/server-common/src/main/java/org/apache/kafka/server/common/MetadataVersion.java">MetadataVersion</a> | ||
| after 3.2.x has a boolean parameter that indicates if there are metadata changes (i.e. <code>IBP_3_3_IV3(7, "3.3", "IV3", true)</code> means this version has metadata changes). | ||
| Given your current and target versions, a downgrade is only possible if there are no metadata changes in the versions between.</li> | ||
| <li>Note that the cluster metadata version cannot be downgraded to a pre-production 3.0.x, 3.1.x, or 3.2.x version once it has been upgraded. |
There was a problem hiding this comment.
not sure about the source of truth here either
There was a problem hiding this comment.
ok so this was fixed in 3.7+ onwards for the old versions with apache/kafka@aec07f7
| ./gradlew clean :storage:testJar</pre> | ||
| <p>After build successfully, there should be a `kafka-storage-x.x.x-test.jar` file under `storage/build/libs`. | ||
| Next, setting configurations in the broker side to enable tiered storage feature.</p> | ||
| <h4 class="anchor-heading"><a id="tiered_storage_config_ex" class="anchor-link"></a><a href="#tiered_storage_config_ex">Configurations Example</a></h4> |
There was a problem hiding this comment.
81773f6 was not done in AK 3.6
|
|
||
| <h1>Documentation</h1> | ||
| <h3>Kafka 3.6 Documentation</h3> | ||
| <h3>Kafka 3.4 Documentation</h3> |
There was a problem hiding this comment.
This does not seem right. This is the 3.6 documentation so it should be Kafka 3.6.
| <a href="/30/documentation.html">3.0.X</a>. | ||
| <a href="/31/documentation.html">3.1.X</a>. | ||
| <a href="/32/documentation.html">3.2.X</a>. | ||
| <a href="/33/documentation.html">3.3.X</a>. |
There was a problem hiding this comment.
This is the 3.6 docs, so it should point to all previous releases including 3.4 and 3.5. Why are we removing them?
There was a problem hiding this comment.
yes, I don't intend to - I captured it in https://github.com/apache/kafka-site/pull/586/files#r1499488695 - that commit is missing.
| url: https://www.apache.org/licenses/LICENSE-2.0.html | ||
| title: Kafka Connect REST API | ||
| version: 3.6.1 | ||
| version: 3.6.2-SNAPSHOT |
There was a problem hiding this comment.
Again we don't want this change. The docs should cover the last released version for 3.6, hence 3.6.1.
| "version": "36", | ||
| "dotVersion": "3.6", | ||
| "fullDotVersion": "3.6.1", | ||
| "fullDotVersion": "3.6.2-SNAPSHOT", |
There was a problem hiding this comment.
Yes we want this to stay 3.6.1
| </pre> | ||
| </p> | ||
|
|
||
| <p>Try to send messages to the `tieredTopic` topic to roll the log segment:</p> |
There was a problem hiding this comment.
Yes I'd keep the larger section we currently have in the docs.
| <li>The example connectors, <code>FileStreamSourceConnector</code> and <code>FileStreamSinkConnector</code>, have been | ||
| removed from the default classpath. To use them in Kafka Connect standalone or distributed mode they need to be | ||
| explicitly added, for example <code>CLASSPATH=./libs/connect-file-3.2.0.jar ./bin/connect-distributed.sh</code>.</li> | ||
| explicitly added, for example <code>CLASSPATH=./lib/connect-file-3.2.0.jar ./bin/connect-distributed.sh</code>.</li> |
There was a problem hiding this comment.
The correct path is ./libs so we should not change this line.
|
This is still WIP, I should have marked it as such - sorry |
|
@stanislavkozlovski -- what is the status of this PR? |
stanislavkozlovski
changed the title
3 participants
No description provided.