Skip to main content

Installation

The LittleHorse Sink Connectors can be installed like any other Kafka Connector: simply download the plugin and add it to the classpath of your Kafka Connect workers.

Getting the Plugins​

All three connectors are available on GitHub releases as a TGZ file.

You can install the Kafka Connector by downloading the latest zip file and extracting it into the plugins directory of your Kafka Connect workers:

# Download the connectors
wget -O lh-kafka-connect-0.13.1.zip https://github.com/littlehorse-enterprises/lh-kafka-connect/releases/download/v0.13.1/lh-kafka-connect-0.13.1.zip

# Load them into your Connect worker classpath
unzip lh-kafka-connect-0.13.1.zip -d /path/to/kafka-connect-plugins/lh-kafka-connect

Strimzi​

For example, to include the LittleHorse Kafka Connector as a plugin in a Strimzi KafkaConnect image build, you can do the following:

apiVersion: strimzi.io/v1beta1
kind: KafkaConnect
metadata:
  # ...
spec:
  # ...
  build:
    # ...
    plugins:
    - name: littlehorse-connector
      artifacts:
      - type: zip
        url: https://github.com/littlehorse-enterprises/lh-kafka-connect/releases/download/v0.13.1/lh-kafka-connect-0.13.1.zip

Similar examples for LittleHorse for Kubernetes can be found in the LittleHorse for Kubernetes documentation.

Artifact Information​

The LittleHorse Sink Connectors for Apache Kafka package is a first-class citizen of the LittleHorse ecosystem. It lives in the lh-kafka-connect GitHub repository.

Versioning​

We use Semantic Versioning where major.minor numbers indicate littlehorse version compatibility, and the patch digit indicates the lh-kafka-connect bundle version.

  • major LittleHorse server major version compatibility.
  • minor LittleHorse server minor version compatibility.
  • patch LittleHorse Connectors bundle version.

Dependencies​

  • Java version 11 or greater is required.
  • Developed and tested against Apache Kafka version 3.8, 3.9, and 4.0, which is equivalent to Confluent Platform 7.8 and 7.9.