kafka快速入门(官方文档)

第1步:下载代码

下载 1.0.0版本并解压缩。

> tar -xzf kafka_2.11-1.0.0.tgz
> cd kafka_2.11-1.0.0

第2步:启动服务器

Kafka使用ZooKeeper,所以如果你还没有ZooKeeper服务器,你需要先启动一个ZooKeeper服务器。您可以使用与kafka一起打包的便捷脚本来获取快速而简单的单节点ZooKeeper实例。

> bin/zookeeper-server-start.sh config/zookeeper.properties
[2013-04-22 15:01:37,495] INFO Reading configuration from: config/zookeeper.properties (org.apache.zookeeper.server.quorum.QuorumPeerConfig)
...

现在启动Kafka服务器:

> bin/kafka-server-start.sh config/server.properties
[2013-04-22 15:01:47,028] INFO Verifying properties (kafka.utils.VerifiableProperties)
[2013-04-22 15:01:47,051] INFO Property socket.send.buffer.bytes is overridden to 1048576 (kafka.utils.VerifiableProperties)
...

第3步:创建一个主题

我们用一个分区和一个副本创建一个名为“test”的主题:

> bin/kafka-topics.sh --create --zookeeper localhost:2181 --replication-factor 1 --partitions 1 --topic test

我们现在可以看到这个主题,如果我们运行列表主题命令:

> bin/kafka-topics.sh --list --zookeeper localhost:2181
test

或者,您也可以将代理配置为在发布不存在的主题时自动创建主题,而不是手动创建主题。

第4步:发送一些消息

Kafka带有一个命令行客户端,它将从文件或标准输入中获取输入,并将其作为消息发送到Kafka集群。默认情况下,每行将作为单独的消息发送。

运行生产者,然后在控制台输入一些消息发送到服务器。

> bin/kafka-console-producer.sh --broker-list localhost:9092 --topic test
This is a message
This is another message

第5步:启动一个用户

Kafka也有一个命令行消费者,将消息转储到标准输出。

> bin/kafka-console-consumer.sh --bootstrap-server localhost:9092 --topic test --from-beginning
This is a message
This is another message

如果您将上述每个命令都运行在不同的终端中,则现在应该可以将消息键入生产者终端,并将其显示在消费者终端中。

所有的命令行工具都有其他选项。不带任何参数运行该命令将显示使用信息更详细地记录它们。

第6步:设置多代理群集

到目前为止,我们一直在与一个broker竞争,但这并不好玩。对于kafka来说,一个broker只是一个规模一个的集群,所以除了开始一些borker实例之外没有太大的变化。但是为了得到它的感觉,让我们把我们的集群扩展到三个节点(仍然都在我们的本地机器上)。

首先,我们为每个代理创建一个配置文件(在Windows上使用copy命令代替):

> cp config/server.properties config/server-1.properties
> cp config/server.properties config/server-2.properties

现在编辑这些新文件并设置以下属性:

config/server-1.properties:
    broker.id=1
    listeners=PLAINTEXT://:9093
    log.dir=/tmp/kafka-logs-1
 
config/server-2.properties:
    broker.id=2
    listeners=PLAINTEXT://:9094
    log.dir=/tmp/kafka-logs-2

broker.id属性是群集中每个节点的唯一且永久的名称。我们必须重写端口和日志目录,因为我们在同一台机器上运行这些端口和日志目录,我们希望让所有的代理都试图在同一个端口注册或覆盖彼此的数据。

我们已经有Zookeeper和我们的单节点了,所以我们只需要启动两个新的节点:

> bin/kafka-server-start.sh config/server-1.properties &
...
> bin/kafka-server-start.sh config/server-2.properties &
...

现在创建一个ReplicationFactor为3的新主题:

> bin/kafka-topics.sh --create --zookeeper localhost:2181 --replication-factor 3 --partitions 1 --topic my-replicated-topic

好吧,现在我们有一个集群,我们怎么知道哪个broker在做什么?要查看运行“描述主题”命令:

> bin/kafka-topics.sh --describe --zookeeper localhost:2181 --topic my-replicated-topic
Topic:my-replicated-topic   PartitionCount:1    ReplicationFactor:3 Configs:
    Topic: my-replicated-topic  Partition: 0    Leader: 1   Replicas: 1,2,0 Isr: 1,2,0

这里是对输出的解释。第一行给出了所有分区的摘要,每个附加行给出了关于一个分区的信息。由于我们只有一个分区,所以只有一行。

  • “leader”是负责给定分区的所有读取和写入的节点。每个节点将成为分区随机选择部分的领导者。
  • “replicas”是复制此分区日志的节点列表,无论它们是否是leader,或即使他们当前处于活动状态。
  • “isr”是一组“同步”副本。这是replicas列表的子集,当前活着并被引导到leader。

请注意,在我的示例中,节点1是该主题的唯一分区的领导者。

我们可以在我们创建的原始主题上运行相同的命令来查看它的位置:

> bin/kafka-topics.sh --describe --zookeeper localhost:2181 --topic test
Topic:test  PartitionCount:1    ReplicationFactor:1 Configs:
    Topic: test Partition: 0    Leader: 0   Replicas: 0 Isr: 0

所以这里并不奇怪,原来的主题没有副本,而且在服务器0上,这是我们创建集群时唯一的服务器。

让我们发表一些信息给我们的新主题:

> bin/kafka-console-producer.sh --broker-list localhost:9092 --topic my-replicated-topic
...
my test message 1
my test message 2
^C

现在让我们消费这些消息:

> bin/kafka-console-consumer.sh --bootstrap-server localhost:9092 --from-beginning --topic my-replicated-topic
...
my test message 1
my test message 2
^C

现在我们来测试一下容错。broker1是作为领导者,所以让我们杀了它:

> ps aux | grep server-1.properties
7564 ttys002    0:15.91 /System/Library/Frameworks/JavaVM.framework/Versions/1.8/Home/bin/java...
> kill -9 7564

在Windows上使用:

> wmic process where "caption = 'java.exe' and commandline like '%server-1.properties%'" get processid
ProcessId
6016
> taskkill /pid 6016 /f

领导已经切换到其中一个从属节点,并且节点1不再处于同步副本集合中:

> bin/kafka-topics.sh --describe --zookeeper localhost:2181 --topic my-replicated-topic
Topic:my-replicated-topic   PartitionCount:1    ReplicationFactor:3 Configs:
    Topic: my-replicated-topic  Partition: 0    Leader: 2   Replicas: 1,2,0 Isr: 2,0

但是,即使原先写入的领导者失败,这些消息仍然可用于消费:

> bin/kafka-console-consumer.sh --bootstrap-server localhost:9092 --from-beginning --topic my-replicated-topic
...
my test message 1
my test message 2
^C

第7步:使用Kafka Connect来导入/导出数据

从控制台写入数据并将其写回控制台是一个方便的起点,但您可能想要使用其他来源的数据或将数据从Kafka导出到其他系统。对于许多系统,您可以使用Kafka Connect来导入或导出数据,而不必编写自定义集成代码。

Kafka Connect是Kafka包含的一个工具,可以将数据导入和导出到Kafka。它是一个可扩展的工具,运行 连接器,实现与外部系统交互的自定义​​逻辑。在这个快速入门中,我们将看到如何使用简单的连接器运行Kafka Connect,这些连接器将数据从文件导入到Kafka主题,并将数据从Kafka主题导出到文件。

首先,我们将通过创建一些种子数据开始测试:

> echo -e "foo
bar" > test.txt

或在Windows上:

> echo foo> test.txt
> echo bar>> test.txt

接下来,我们将启动两个以独立模式运行的连接器,这意味着它们将在单个本地专用进程中运行。我们提供三个配置文件作为参数。首先是Kafka Connect过程的配置,包含常见的配置,例如要连接的Kafka代理以及数据的序列化格式。其余的配置文件都指定一个要创建的连接器。这些文件包括唯一的连接器名称,要实例化的连接器类以及连接器所需的任何其他配置。

> bin/connect-standalone.sh config/connect-standalone.properties config/connect-file-source.properties config/connect-file-sink.properties

Kafka附带的这些示例配置文件使用您之前启动的默认本地群集配置,并创建两个连接器:第一个是源连接器,用于从输入文件中读取行,并将每个连接生成为Kafka主题,第二个为连接器连接器它从Kafka主题读取消息,并在输出文件中产生每行消息。

在启动过程中,您会看到一些日志消息,其中一些指示连接器正在实例化。Kafka Connect进程启动后,源连接器应该开始读取test.txt主题connect-test,并将其生成主题,并且接收器连接器应该开始读取主题中的消息connect-test 并将其写入文件test.sink.txt我们可以通过检查输出文件的内容来验证通过整个管道传输的数据:

> more test.sink.txt
foo
bar

请注意,数据存储在Kafka主题中connect-test,因此我们也可以运行控制台使用者来查看主题中的数据(或使用自定义使用者代码来处理它):

> bin/kafka-console-consumer.sh --bootstrap-server localhost:9092 --topic connect-test --from-beginning
{"schema":{"type":"string","optional":false},"payload":"foo"}
{"schema":{"type":"string","optional":false},"payload":"bar"}
...

连接器继续处理数据,所以我们可以将数据添加到文件中,并看到它在管道中移动:

> echo Another line>> test.txt

您应该看到该行出现在控制台使用者输出和接收器文件中。

第8步:使用Kafka流来处理数据

Kafka Streams是用于构建关键任务实时应用程序和微服务的客户端库,输入和/或输出数据存储在Kafka集群中。Kafka Streams结合了在客户端编写和部署标准Java和Scala应用程序的简单性以及Kafka服务器端集群技术的优势,使这些应用程序具有高度可伸缩性,弹性,容错性,分布式等特性。快速入门示例将演示如何运行在此库中编码的流式应用程序。

原文地址:https://www.cnblogs.com/sa-dan/p/8079180.html