Skip to content

Kafka 4060 docs update#2377

Closed
hjafarpour wants to merge 34 commits intoapache:trunkfrom
hjafarpour:KAFKA-4060-docs-update
Closed

Kafka 4060 docs update#2377
hjafarpour wants to merge 34 commits intoapache:trunkfrom
hjafarpour:KAFKA-4060-docs-update

Conversation

@hjafarpour
Copy link
Copy Markdown

Updated the docs with changes in KAFKA-4060.

Hojjat Jafarpour and others added 29 commits September 19, 2016 17:10
…reating and deleting topics. They work in IDE but fail while build. Removing the new tests for now.
…new' of https://github.com/hjafarpour/kafka into KAFKA-4060-Remove-ZkClient-dependency-in-Kafka-Streams-new
@asfbot
Copy link
Copy Markdown

asfbot commented Jan 13, 2017

Refer to this link for build results (access rights to CI server needed):
https://builds.apache.org/job/kafka-pr-jdk8-scala2.12/871/
Test PASSed (JDK 8 and Scala 2.12).

@asfbot
Copy link
Copy Markdown

asfbot commented Jan 13, 2017

Refer to this link for build results (access rights to CI server needed):
https://builds.apache.org/job/kafka-pr-jdk8-scala2.11/873/
Test PASSed (JDK 8 and Scala 2.11).

@asfbot
Copy link
Copy Markdown

asfbot commented Jan 14, 2017

Refer to this link for build results (access rights to CI server needed):
https://builds.apache.org/job/kafka-pr-jdk7-scala2.10/871/
Test PASSed (JDK 7 and Scala 2.10).

Comment thread docs/upgrade.html Outdated
Please refer to the <code>KafkaConsumer</code> Javadoc for a more in-depth explanation of this change.</li>
<li>Multiple regular expressions separated by commas can be passed to MirrorMaker with the new Java consumer via the --whitelist option. This
makes the behaviour consistent with MirrorMaker when used the old Scala consumer.</li>
<li>Zookeeper dependency was removed from Streams API. Now Streams API uses Admin Client API to manage internal topics. If the Kafka cluster is secured the Streams apps require to have proper security privilege to create new topics.</li>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure it makes sense to say Admin Client API since it doesn't really exist. I think it would be better to say that the Kafka protocol is used to manage topics instead of modifying ZooKeeper. Also, more important than ZooKeeper dependency (which sounds like a library dependency) is the fact that network and write access to ZooKeeper is no longer required.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, will update the page accordingly.

@mjsax
Copy link
Copy Markdown
Member

mjsax commented Jan 14, 2017

Why does this change code? Shouldn't it only touch docs/upgrade.html ?

@guozhangwang
Copy link
Copy Markdown
Contributor

@hjafarpour Could you use git pull to merge all previous commits? Also there are code changes which I think should not be included..

@hjafarpour
Copy link
Copy Markdown
Author

I'm rebasing the branch and making minor changes based on @ijuma comment.

Copy link
Copy Markdown
Member

@mjsax mjsax left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Comment thread docs/upgrade.html Outdated
<li>Multiple regular expressions separated by commas can be passed to MirrorMaker with the new Java consumer via the --whitelist option. This
makes the behaviour consistent with MirrorMaker when used the old Scala consumer.</li>
<li>Zookeeper dependency was removed from the Streams API. Now the Streams API uses Kafka protocol to manage internal topics instead of modifying Zookeeprt directly. This eliminates the need for privilege[s] for accessing Zookeeper directly. If the Kafka cluster is secured the Streams apps require to have proper security privilege[s] to create new topics.</li>
<li>Several new fields including SECURITY_PROTOCOL_CONFIG, CONNECTIONS_MAX_IDLE_MS_CONFIG, RETRY_BACKOFF_MS_CONFIG RECONNECT_BACKOFF_MS_CONFIG and REQUEST_TIMEOUT_MS_CONFIG were added to StreamsConfig. User should pay attenntion to the default values and set these if needed.</li>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to provide the actually string name of the config instead of the variable names as they are internal variables and users would not recognize them. Also add a link to the configs section mentioning "please find the detailed description blah blah.."

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it, updating accordingly!

asfgit pushed a commit that referenced this pull request Jan 23, 2017
Updated the docs with changes in KAFKA-4060.

Author: Hojjat Jafarpour <hojjat@Hojjat-Jafarpours-MBP.local>
Author: Hojjat Jafarpour <hojjat@HojjatJpoursMBP.attlocal.net>

Reviewers: Ismael Juma, Matthias J. Sax, Guozhang Wang

Closes #2377 from hjafarpour/KAFKA-4060-docs-update

(cherry picked from commit 62206de)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>
@guozhangwang
Copy link
Copy Markdown
Contributor

Merged to trunk and 0.10.2.

@asfgit asfgit closed this in 62206de Jan 23, 2017
@asfbot
Copy link
Copy Markdown

asfbot commented Jan 23, 2017

Refer to this link for build results (access rights to CI server needed):
https://builds.apache.org/job/kafka-pr-jdk8-scala2.11/1115/
Test PASSed (JDK 8 and Scala 2.11).

@asfbot
Copy link
Copy Markdown

asfbot commented Jan 23, 2017

Refer to this link for build results (access rights to CI server needed):
https://builds.apache.org/job/kafka-pr-jdk7-scala2.10/1113/
Test PASSed (JDK 7 and Scala 2.10).

@asfbot
Copy link
Copy Markdown

asfbot commented Jan 23, 2017

Refer to this link for build results (access rights to CI server needed):
https://builds.apache.org/job/kafka-pr-jdk8-scala2.12/1113/
Test PASSed (JDK 8 and Scala 2.12).

soenkeliebau pushed a commit to soenkeliebau/kafka that referenced this pull request Feb 7, 2017
Updated the docs with changes in KAFKA-4060.

Author: Hojjat Jafarpour <hojjat@Hojjat-Jafarpours-MBP.local>
Author: Hojjat Jafarpour <hojjat@HojjatJpoursMBP.attlocal.net>

Reviewers: Ismael Juma, Matthias J. Sax, Guozhang Wang

Closes apache#2377 from hjafarpour/KAFKA-4060-docs-update
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants