Skip to main content

Command Line Interface for Strimzi Kafka Operator

Project description

Build Deploy PyPI Downloads License Strimzi AMQ Streams

Strimzi CLI logo

Strimzi Kafka CLI

Strimzi Kafka CLI is a CLI that helps traditional Apache Kafka users -both developers and administrators- to easily adapt to Strimzi, a Kubernetes operator for Apache Kafka.

The main intention is to ramp up Strimzi usage by creating a similar CLI experience with the traditional Apache Kafka tools that mostly starts with kafka-* prefix under the bin directory in an ordinary Kafka package.

Strimzi Kafka CLI uses the kfk command as an abbreviation for "Kafka For Kubernetes" or simply "k a f k a" which reminds of the kafka-* prefix of the ordinary Kafka script file names.

While having similar set of commands or options for some of the common objects, Strimzi Kafka CLI has some extra capabilities for managing or configuring Strimzi related resources.

Following are the commands of the current version of Strimzi Kafka CLI, that are used for different purposes:

Usage: kfk [OPTIONS] COMMAND [ARGS]...

  Strimzi Kafka CLI

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  acls              Manages ACLs on Kafka.
  clusters          Creates, alters, deletes, describes Kafka cluster(s).
  configs           Adds/Removes entity config for a topic, client, user or...
  connect           Creates, alters, deletes, describes Kafka connect...
  console-consumer  Reads data from Kafka topics and outputs it to standard...
  console-producer  Reads data from standard input and publish it to Kafka.
  env               Prints the environment variable values for Strimzi Kafka CLI
  operator          Installs/Uninstalls Strimzi Kafka Operator
  topics            Creates, alters, deletes, describes Kafka topic(s).
  users             Creates, alters, deletes, describes Kafka users(s).

Please take a look at the relevant article Strimzi Kafka CLI: Managing Strimzi in a Kafka Native Way for more details.

Installation

Using Python Package Installer

pip install strimzi-kafka-cli --user

Or to install Strimzi Kafka CLI in an isolated environment, you can simply use pipx:

pipx install strimzi-kafka-cli

Using Homebrew

#Tap the homebrew repository first.
brew tap systemcraftsman/strimzi-kafka-cli

#Install Strimzi Kafka CLI
brew install strimzi-kafka-cli

Installing the CLI by using Homebrew already uses a virtual environment, so you don't have to worry about your main Python environment.

Project requires: Python >=3.8

Examples

Dependencies

Python Dependencies

Please see pyproject.toml file.

External Dependencies

kubectl and Strimzi resources are the tools that Strimzi Kafka CLI uses. These dependencies are automatically downloaded when the first kfk command is run. You can always check the dependency versions of your CLI with the following command:

kfk --version

You can change where you want to locate the kubectl, Strimzi resources, or Strimzi CLI files/folders. You can use the following environment variables:

STRIMZI_KAFKA_CLI_BASE_PATH: Set this if you want to have a custom Strimzi Kafka CLI folder. It is ~/.strimzi-kafka-cli as default.

STRIMZI_KAFKA_CLI_STRIMZI_PATH: Set this if you want to use a custom Strimzi/AMQ Streams. We only recommend this when using AMQ Streams instead of Strimzi.

STRIMZI_KAFKA_CLI_KUBECTL_PATH: Set this if you want to use a custom kubectl.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

strimzi_kafka_cli-0.1.0a79.tar.gz (36.2 kB view details)

Uploaded Source

Built Distribution

strimzi_kafka_cli-0.1.0a79-py3-none-any.whl (34.5 kB view details)

Uploaded Python 3

File details

Details for the file strimzi_kafka_cli-0.1.0a79.tar.gz.

File metadata

  • Download URL: strimzi_kafka_cli-0.1.0a79.tar.gz
  • Upload date:
  • Size: 36.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for strimzi_kafka_cli-0.1.0a79.tar.gz
Algorithm Hash digest
SHA256 dc80a0960e5fb22c0b5f2aebc0455851b2d0eac212fbdc72346dfc742c34aa23
MD5 ca0003f89ab04b93794b736fc1dc11ef
BLAKE2b-256 498439d9f02fe0d4d16b5b9afd8ae26e1d4dda505b45059d99b435ecf54b0fb4

See more details on using hashes here.

File details

Details for the file strimzi_kafka_cli-0.1.0a79-py3-none-any.whl.

File metadata

File hashes

Hashes for strimzi_kafka_cli-0.1.0a79-py3-none-any.whl
Algorithm Hash digest
SHA256 4bd1aad5bdea11b6442d731300a5d4540bff62e0028d1426929cec3d9b409a5e
MD5 8d50902be645c77a8c3b5e0f3c4adfb0
BLAKE2b-256 6ea0365acab992a86e3063a8be7c6c968e940425f6c3441b387e63faeaa6c54a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page