安裝并配置單機(jī)版kafka所需環(huán)境

wsl2 環(huán)境可用性較高，如下介紹在該環(huán)境中安裝單機(jī)版本kafka的詳細(xì)過(guò)程。

1. 啟動(dòng)命令行工具
2. 啟動(dòng)wsl：wsl --user root --cd ~，（以root用戶啟動(dòng)，進(jìn)入wsl后當(dāng)前路徑為~“用戶主目錄”）
3. 安裝java：進(jìn)入：https://learn.microsoft.com/zh-cn/java/openjdk/download，選擇相應(yīng)的java版本，下載接口
   • 創(chuàng)建java的安裝路徑：mkdir -p /opt/sdk/java
   • 將剛剛下載的javasdk壓縮包移動(dòng)進(jìn)創(chuàng)建的路徑：mv /mnt/c/Users/你的用戶名/Downloads/microsoft-jdk-21.0.1-linux-aarch64.tar.gz /opt/sdk/java/
   • 切換到你java安裝路徑：cd /opt/sdk/java/
   • 解壓安裝：tar -zxvf microsoft-jdk-21.0.1-linux-aarch64.tar.gz
   • 可以選擇性刪除你剛剛的壓縮包：rm -rf microsoft-jdk-21.0.1-linux-aarch64.tar.gz
   • 配置環(huán)境變量 進(jìn)入jdk的解壓目錄：cd cd jdk-21.0.1+12
     查看一下當(dāng)前的絕對(duì)路徑：pwd
     復(fù)制一下絕對(duì)路徑的字符串
   • 使用vim 打開(kāi) /etc/profile
   • GG到文件尾部，在文件尾部追加如下內(nèi)容：

     export JAVA_HOME=/opt/sdk/java/jdk-21.0.1+12
     export PATH=$PATH:$JAVA_HOME/bin
     

     注意JAVA_HOME后邊的jdk_xxx是你自己下載的相應(yīng)版本信息
   • 讓profile文件生效：source /etc/profile
   • 查看java是否安裝成功：java -version，顯示版本信息則安裝成功

      root@Ophelia:/opt/sdk/java/jdk-21.0.1+12# java -versionopenjdk version "21.0.1" 2023-10-17 LTSOpenJDK Runtime Environment Microsoft-8526870 (build 21.0.1+12-LTS)OpenJDK 64-Bit Server VM Microsoft-8526870 (build 21.0.1+12-LTS, mixed mode)
     

4. 安裝kafka
   • 在kafka官網(wǎng)下載相應(yīng)版本kafka，我這里選最新版：Scala 2.13 - kafka_2.13-3.6.0.tgz (asc, sha512)
   • 創(chuàng)建kafka的安裝路徑：mkdir -p /opt/software/kafka
   • 將剛剛下載的kafka壓縮包移動(dòng)進(jìn)創(chuàng)建的路徑：mv /mnt/c/Users/你的用戶名/Downloads/kafka_2.13-3.6.1.tgz /opt/software/kafka/
   • cd /opt/software/kafka/
   • tar -zxvf kafka_2.13-3.6.1.tgz
   • cd kafka_2.13-3.6.1/
   • pwd，然后復(fù)制絕對(duì)路徑
   • vim /etc/profile 追加如下內(nèi)容

      # Kafkaexport KAFKA_HOME=/opt/software/kafka/kafka_2.13-3.6.1export PATH=$PATH:$KAFKA_HOME/bin
     

   • source /etc/profile
   • 配置文件修改： vim /opt/software/kafka/kafka_2.13-3.6.1/config/server.properties
     • 找到log.dirs=/tmp/kafka-logs將其修改為log.dirs=/opt/software/kafka/kafka-logs
     • 如下所示：

        # log.dirs=/tmp/kafka-logslog.dirs=/opt/software/kafka/kafka-logs
       

     • mkdir -p /opt/software/kafka/kafka-logs
     • 上述操作目的是防止topic中的數(shù)據(jù)丟失

啟動(dòng)kafka

啟動(dòng)kafka之前先啟動(dòng)zookeeper， Kafka 2.8.0 版本開(kāi)始，內(nèi)置了zookeeper。

1. 啟動(dòng)zookeeper
   zookeeper-server-start.sh -daemon /opt/software/kafka/kafka_2.13-3.6.1/config/zookeeper.properties
   命令看起來(lái)有點(diǎn)長(zhǎng)，實(shí)際上一點(diǎn)兒也不短。
   它分為3段[zookeeper-server-start.sh][-daemon][配置文件路徑]
   • -daemon參數(shù)是以守護(hù)進(jìn)程的方式啟動(dòng)。
   • zookeeper的啟動(dòng)腳本也存儲(chǔ)在kafka的環(huán)境變量指向的路徑中。
2. 啟動(dòng)kafka
   kafka-server-start.sh -daemon /opt/software/kafka/kafka_2.13-3.6.1/config/server.properties

關(guān)閉kafka

先停止kafka，后停止zookeeper

root@Ophelia:~# kafka-server-stop.sh
root@Ophelia:~# zookeeper-server-stop.sh

當(dāng)停用kafka集群的時(shí)候也是先停止kafka，后停止zookeeper，順序搞反了會(huì)導(dǎo)致kafka無(wú)法停止，只能使用kill去殺死。

kafka-topics.sh 主題相關(guān)操作

查看一下kafka-tpics.sh命令都能干什么

root@Ophelia:~# kafka-topics.sh
Create, delete, describe, or change a topic.
Option                                   Description
------                                   -----------
--alter                                  Alter the number of partitions andreplica assignment. Update theconfiguration of an existing topicvia --alter is no longer supportedhere (the kafka-configs CLI supportsaltering topic configs with a --bootstrap-server option).
--at-min-isr-partitions                  if set when describing topics, onlyshow partitions whose isr count isequal to the configured minimum.
--bootstrap-server <String: server to    REQUIRED: The Kafka server to connectconnect to>                              to.
--command-config <String: command        Property file containing configs to beconfig property file>                    passed to Admin Client. This is usedonly with --bootstrap-server optionfor describing and altering brokerconfigs.
--config <String: name=value>            A topic configuration override for thetopic being created or altered. Thefollowing is a list of validconfigurations:cleanup.policycompression.typedelete.retention.msfile.delete.delay.msflush.messagesflush.msfollower.replication.throttled.replicasindex.interval.bytesleader.replication.throttled.replicaslocal.retention.byteslocal.retention.msmax.compaction.lag.msmax.message.bytesmessage.downconversion.enablemessage.format.versionmessage.timestamp.after.max.msmessage.timestamp.before.max.msmessage.timestamp.difference.max.msmessage.timestamp.typemin.cleanable.dirty.ratiomin.compaction.lag.msmin.insync.replicaspreallocateremote.storage.enableretention.bytesretention.mssegment.bytessegment.index.bytessegment.jitter.mssegment.msunclean.leader.election.enableSee the Kafka documentation for fulldetails on the topic configs. It issupported only in combination with --create if --bootstrap-server optionis used (the kafka-configs CLIsupports altering topic configs witha --bootstrap-server option).
--create                                 Create a new topic.
--delete                                 Delete a topic
--delete-config <String: name>           A topic configuration override to beremoved for an existing topic (seethe list of configurations under the--config option). Not supported withthe --bootstrap-server option.
--describe                               List details for the given topics.
--exclude-internal                       exclude internal topics when runninglist or describe command. Theinternal topics will be listed bydefault
--help                                   Print usage information.
--if-exists                              if set when altering or deleting ordescribing topics, the action willonly execute if the topic exists.
--if-not-exists                          if set when creating topics, theaction will only execute if thetopic does not already exist.
--list                                   List all available topics.
--partitions <Integer: # of partitions>  The number of partitions for the topicbeing created or altered (WARNING:If partitions are increased for atopic that has a key, the partitionlogic or ordering of the messageswill be affected). If not suppliedfor create, defaults to the clusterdefault.
--replica-assignment <String:            A list of manual partition-to-brokerbroker_id_for_part1_replica1 :           assignments for the topic beingbroker_id_for_part1_replica2 ,           created or altered.broker_id_for_part2_replica1 :broker_id_for_part2_replica2 , ...>
--replication-factor <Integer:           The replication factor for eachreplication factor>                      partition in the topic beingcreated. If not supplied, defaultsto the cluster default.
--topic <String: topic>                  The topic to create, alter, describeor delete. It also accepts a regularexpression, except for --createoption. Put topic name in doublequotes and use the '\' prefix toescape regular expression symbols; e.g. "test\.topic".
--topic-id <String: topic-id>            The topic-id to describe.This is usedonly with --bootstrap-server optionfor describing topics.
--topics-with-overrides                  if set when describing topics, onlyshow topics that have overriddenconfigs
--unavailable-partitions                 if set when describing topics, onlyshow partitions whose leader is notavailable
--under-min-isr-partitions               if set when describing topics, onlyshow partitions whose isr count isless than the configured minimum.
--under-replicated-partitions            if set when describing topics, onlyshow under replicated partitions
--version                                Display Kafka version.

列出主要命令

選項(xiàng)	描述信息
–bootstrap-server <String: server to connect to>	連接kafka Broker 主機(jī)名:端口號(hào)
–topic <String: topic>	操作的topic名稱
–create	創(chuàng)建topic
–delete	刪除topic
–alter	修改topic
–list	查看所有topic
–describe	查看topic的詳細(xì)描述信息
–partitions <Integer: # of partitions>	設(shè)置分區(qū)數(shù)
–replication-factor <Integer: replication factor>	設(shè)置分區(qū)副本
–config <String: name=value>	更細(xì)系統(tǒng)默認(rèn)的配置

查看topic

kafka-topics.sh --list --bootstrap-server localhost:9092
或者，查看指定的topic
kafka-topics.sh --bootstrap-server localhost:9092 --topic 名稱 --describe

生產(chǎn)環(huán)境中可能有多臺(tái)機(jī)器，為了保證高可用性，防止訪問(wèn)的kafka掛掉之后無(wú)法查詢數(shù)據(jù)，可以指定多個(gè)實(shí)例，如：kafka-topics.sh --list --bootstrap-server localhost:9092 hostName1:9092 hostName2:9092

創(chuàng)建topic

創(chuàng)建之前先查看一下有多少個(gè)topic
kafka-topics.sh --list --bootstrap-server localhost:9092
一看，啥也木有，看了個(gè)寂寞，這就對(duì)溜，你不創(chuàng)建topic，它就沒(méi)topic
創(chuàng)建單副本，3個(gè)分區(qū)的 名 為 first的topic
kafka-topics.sh --bootstrap-server localhost:9092 --topic first --create --partitions 3 --replication-factor 1

查看一下：

root@Ophelia:~# kafka-topics.sh --list --bootstrap-server localhost:9092
first

或者

kafka-topics.sh --bootstrap-server localhost:9092 --topic first --describe
Topic: first    TopicId: Db5XuRoASzi4W2FgQbaW7A PartitionCount: 3       ReplicationFactor: 1    Configs:Topic: first    Partition: 0    Leader: 0       Replicas: 0     Isr: 0Topic: first    Partition: 1    Leader: 0       Replicas: 0     Isr: 0Topic: first    Partition: 2    Leader: 0       Replicas: 0     Isr: 0

修改topic

first topic的分區(qū)數(shù)從3個(gè)修改成4個(gè)，注意，分區(qū)數(shù)在命令行中只能增加，不能減少
kafka-topics.sh --bootstrap-server localhost:9092 --topic first --alter --partitions 4

嘗試一下，會(huì)報(bào)錯(cuò)的

root@Ophelia:~# kafka-topics.sh --bootstrap-server localhost:9092 --topic first --alter --partitions 3
Error while executing topic command : Topic currently has 4 partitions, which is higher than the requested 3.
[2023-12-17 17:55:41,130] ERROR org.apache.kafka.common.errors.InvalidPartitionsException: Topic currently has 4 partitions, which is higher than the requested 3.(kafka.admin.TopicCommand$)

刪除topic

刪除名為first的topic
kafka-topics.sh --bootstrap-server localhost:9092 --topic first --delete

kafka-console-producer.sh生產(chǎn)者相關(guān)操作

root@Ophelia:~# kafka-console-producer.sh
Missing required option(s) [bootstrap-server]
Option                                   Description
------                                   -----------
--batch-size <Integer: size>             Number of messages to send in a singlebatch if they are not being sentsynchronously. please note that thisoption will be replaced if max-partition-memory-bytes is also set(default: 16384)
--bootstrap-server <String: server to    REQUIRED unless --broker-listconnect to>                              (deprecated) is specified. The server(s) to connect to. The broker liststring in the form HOST1:PORT1,HOST2:PORT2.
--broker-list <String: broker-list>      DEPRECATED, use --bootstrap-serverinstead; ignored if --bootstrap-server is specified.  The brokerlist string in the form HOST1:PORT1,HOST2:PORT2.
--compression-codec [String:             The compression codec: either 'none',compression-codec]                       'gzip', 'snappy', 'lz4', or 'zstd'.If specified without value, then itdefaults to 'gzip'
--help                                   Print usage information.
--line-reader <String: reader_class>     The class name of the class to use forreading lines from standard in. Bydefault each line is read as aseparate message. (default: kafka.tools.ConsoleProducer$LineMessageReader)
--max-block-ms <Long: max block on       The max time that the producer willsend>                                    block for during a send request.(default: 60000)
--max-memory-bytes <Long: total memory   The total memory used by the producerin bytes>                                to buffer records waiting to be sentto the server. This is the option tocontrol `buffer.memory` in producerconfigs. (default: 33554432)
--max-partition-memory-bytes <Integer:   The buffer size allocated for amemory in bytes per partition>           partition. When records are receivedwhich are smaller than this size theproducer will attempt tooptimistically group them togetheruntil this size is reached. This isthe option to control `batch.size`in producer configs. (default: 16384)
--message-send-max-retries <Integer>     Brokers can fail receiving the messagefor multiple reasons, and beingunavailable transiently is just oneof them. This property specifies thenumber of retries before theproducer give up and drop thismessage. This is the option tocontrol `retries` in producerconfigs. (default: 3)
--metadata-expiry-ms <Long: metadata     The period of time in millisecondsexpiration interval>                     after which we force a refresh ofmetadata even if we haven't seen anyleadership changes. This is theoption to control `metadata.max.age.ms` in producer configs. (default:300000)
--producer-property <String:             A mechanism to pass user-definedproducer_prop>                           properties in the form key=value tothe producer.
--producer.config <String: config file>  Producer config properties file. Notethat [producer-property] takesprecedence over this config.
--property <String: prop>                A mechanism to pass user-definedproperties in the form key=value tothe message reader. This allowscustom configuration for a user-defined message reader.Default properties include:parse.key=falseparse.headers=falseignore.error=falsekey.separator=\theaders.delimiter=\theaders.separator=,headers.key.separator=:null.marker=   When set, any fields(key, value and headers) equal tothis will be replaced by nullDefault parsing pattern when:parse.headers=true and parse.key=true:"h1:v1,h2:v2...\tkey\tvalue"parse.key=true:"key\tvalue"parse.headers=true:"h1:v1,h2:v2...\tvalue"
--reader-config <String: config file>    Config properties file for the messagereader. Note that [property] takesprecedence over this config.
--request-required-acks <String:         The required `acks` of the producerrequest required acks>                   requests (default: -1)
--request-timeout-ms <Integer: request   The ack timeout of the producertimeout ms>                              requests. Value must be non-negativeand non-zero. (default: 1500)
--retry-backoff-ms <Long>                Before each retry, the producerrefreshes the metadata of relevanttopics. Since leader election takesa bit of time, this propertyspecifies the amount of time thatthe producer waits before refreshingthe metadata. This is the option tocontrol `retry.backoff.ms` inproducer configs. (default: 100)
--socket-buffer-size <Integer: size>     The size of the tcp RECV size. This isthe option to control `send.buffer.bytes` in producer configs.(default: 102400)
--sync                                   If set message send requests to thebrokers are synchronously, one at atime as they arrive.
--timeout <Long: timeout_ms>             If set and the producer is running inasynchronous mode, this gives themaximum amount of time a messagewill queue awaiting sufficient batchsize. The value is given in ms. Thisis the option to control `linger.ms`in producer configs. (default: 1000)
--topic <String: topic>                  REQUIRED: The topic id to producemessages to.
--version                                Display Kafka version.

生產(chǎn)消息

用生產(chǎn)者連接broker
kafka-console-producer.sh --bootstrap-server localhost:9092 --topic first
再啟動(dòng)一個(gè)命令行
wsl --user root --cd ~
啟動(dòng)一個(gè)消費(fèi)者
kafka-console-consumer.sh --bootstrap-server localhost:9092 --topic first
生產(chǎn)者發(fā)送消息
消費(fèi)者接收消息

kafka-console-consumer.sh消費(fèi)者相關(guān)操作

root@Ophelia:~# kafka-console-consumer.sh
This tool helps to read data from Kafka topics and outputs it to standard output.
Option                                   Description------                                   -------------bootstrap-server <String: server to    REQUIRED: The server(s) to connect to.connect to>--consumer-property <String:             A mechanism to pass user-definedconsumer_prop>                           properties in the form key=value tothe consumer.--consumer.config <String: config file>  Consumer config properties file. Notethat [consumer-property] takesprecedence over this config.
--enable-systest-events                  Log lifecycle events of the consumerin addition to logging consumedmessages. (This is specific forsystem tests.)--formatter <String: class>              The name of a class to use forformatting kafka messages fordisplay. (default: kafka.tools.DefaultMessageFormatter)
--formatter-config <String: config       Config properties file to initializefile>                                    the message formatter. Note that[property] takes precedence overthis config.--from-beginning                         If the consumer does not already havean established offset to consumefrom, start with the earliestmessage present in the log ratherthan the latest message.
--group <String: consumer group id>      The consumer group id of the consumer.
--help                                   Print usage information.
--include <String: Java regex (String)>  Regular expression specifying list oftopics to include for consumption.
--isolation-level <String>               Set to read_committed in order tofilter out transactional messageswhich are not committed. Set toread_uncommitted to read allmessages. (default: read_uncommitted)
--key-deserializer <String:deserializer for key>--max-messages <Integer: num_messages>   The maximum number of messages toconsume before exiting. If not set,consumption is continual.
--offset <String: consume offset>        The offset to consume from (a non-negative number), or 'earliest'which means from beginning, or'latest' which means from end(default: latest)
--partition <Integer: partition>         The partition to consume from.Consumption starts from the end ofthe partition unless '--offset' isspecified.--property <String: prop>                The properties to initialize themessage formatter. Defaultproperties include:print.timestamp=true|falseprint.key=true|falseprint.offset=true|falseprint.partition=true|falseprint.headers=true|falseprint.value=true|falsekey.separator=<key.separator>line.separator=<line.separator>headers.separator=<line.separator>null.literal=<null.literal>key.deserializer=<key.deserializer>value.deserializer=<value.deserializer>header.deserializer=<header.deserializer>Users can also pass in customizedproperties for their formatter; morespecifically, users can pass inproperties keyed with 'key.deserializer.', 'value.deserializer.' and 'headers.deserializer.' prefixes to configuretheir deserializers.
--skip-message-on-error                  If there is an error when processing amessage, skip it instead of halt.
--timeout-ms <Integer: timeout_ms>       If specified, exit if no message isavailable for consumption for thespecified interval.
--topic <String: topic>                  The topic to consume on.
--value-deserializer <String:deserializer for values>--version                                Display Kafka version.
--whitelist <String: Java regex          DEPRECATED, use --include instead;(String)>                                ignored if --include specified.Regular expression specifying listof topics to include for consumption.

增量接收

kafka-console-consumer.sh --bootstrap-server localhost:9092 --topic first

接收歷史全部數(shù)據(jù) –from-beginning

kafka-console-consumer.sh --bootstrap-server localhost:9092 --topic first --from-beginning
使用場(chǎng)景：根據(jù)情況而定