Setup and Run Apache Kafka on Ubuntu / Linux / Mac

To get started with Apache Kafka on Ubuntu/Linux/Mac OS, complete the instructions given in this quickstart tutorial.

Note: Your computer must have Java 8+ installed.

Download Kafka

Download latest stable Apache Kafka and extract it.


    $ tar -xzf kafka_2.13-2.6.0.tgz
    $ cd kafka_2.13-2.6.0

Start the Kafka Services

  1. Open terminal and start the ZooKeeper service:
  2. 
        $ bin/zookeeper-server-start.sh config/zookeeper.properties
        
  3. Open another terminal and start the Kafka broker service:
  4. 
        $ bin/kafka-server-start.sh config/server.properties
        

After starting these services, your basic Kafka environment should be ready for use.

Create a Topic

Next, you must create a topic to store events. A topic in Kafka, is like a table in a database where data are stored. You can have multiple topics for different events. To create a new topic, run the following command by replacing my-topic-name with the name of your topic:


    $ bin/kafka-topics.sh --create --topic my-topic-name --bootstrap-server localhost:9092
    

You can also view details of the new topic by running the following command:


    $ bin/kafka-topics.sh --describe --topic my-topic-name --bootstrap-server localhost:9092
    

Write Events to the Topic

A Kafka client communicates with the Kafka broker to write events. After the events are written, the broker will store the events for as long as you want.

There are Kafka clients libraries, supported for different languages, using which we can send events to Kafka topics. An application that sends data to the Kafka topic is called a producer application.

You can also use the console Producer to write events to the topic. By default, each entered line is treated as a separated event.


    $ bin/kafka-console-producer.sh --topic my-topic-name --bootstrap-server localhost:9092
>This is my first event
>This is my second event
>This is my third event
    

The console Producer client can be stopped by pressing Crtl+C at any time.

Read Events from the Topic

A Kafka client communicates with the Kafka broker to read events.

You can use Kafka clients libraries in your application to read events from Kafka topics. An application that reads data from the Kafka topics is called a consumer application.

You can also use console Consumer client to read events that you created. Following is the command to read events.


    $ bin/kafka-console-consumer.sh --topic my-topic-name --from-beginning --bootstrap-server localhost:9092
    

You can stop the Consumer client by pressing Ctrl+C at any time.

Stopping the Kafka Services

  1. Stop the Kafka console Producer and Consumer clients.
  2. Next, stop the Kafka broker by pressing Ctrl+C.
  3. Lastly, stop the Kafka ZooKeeper by pressing Ctrl+C.

Deleting the Kafka Topic

To delete a topic that you created, simply run the following command:


    $ bin/kafka-topics.sh --zookeeper localhost:9092 --delete --topic my-topic-name
   

Import/Export Data as Streams of Events into Kafka

Sometimes, you may need to collect data from any existing relational databases or messaging system into Kafka. To achieve this, you can use Kafka Connect. Kafka connect is a tool that helps to stream data reliably and durably between Kafka and other external systems. Kafka Connect can collect data continuously from any external systems into Kafka and vice versa.