Skip to content
Alex edited this page Feb 20, 2020 · 12 revisions

Trubka Is a CLI tool which gives you everything you need to

  • Manage, query and troubleshoot your Kafka cluster.
  • Consume protocol buffer and plain text messages from Kafka.
  • Publish protocol buffer and plain text messages to Kafka.

If you need to play around with Trubka locally, you can download the docker compose file from the repo and spin up a single node Kafka cluster on your machine:

$> mkdir -p ~/local_kafka
$> cd ~/local_kafka
$> wget https://raw.githubusercontent.com/xitonix/trubka/master/docker-compose.yml
$> docker-compose up

Installation

macOS

$> brew tap xitonix/trubka
$> brew install trubka

Build from source

Clone the repo locally and build trubka from source. You can also use Make to compile the code.

Pre built binaries

Download the pre-built binaries for the platform of your choice from the releases page.

Authentication

If your Kafka cluster has SASL or TLS enabled, Trubka's got your back. You can inject SASL credentials or TLS certs into all the commands that communicate with your Kafka cluster using the provided flags.

--sasl-mechanism=none      SASL authentication mechanism.
-U, --sasl-username=SASL-USERNAME
                           SASL authentication username. Will be ignored if --sasl-mechanism is set to none.
-P, --sasl-password=SASL-PASSWORD
                           SASL authentication password. Will be ignored if --sasl-mechanism is set to none.
--sasl-version=v1          SASL handshake version. Will be ignored if --sasl-mechanism is set to none.


--tls                      Enables TLS (Unverified by default).
--ca-cert=CA-CERT          Trusted root certificates for verifying the server.
--client-cert=CLIENT-CERT  Client certification file to enable mutual TLS authentication.
--client-key=CLIENT-KEY    Client private key file to enable mutual TLS authentication.
Clone this wiki locally