Skip to content

Introduction

Kannika Armory is a Kubernetes-native backup and restore solution for streaming data sources. Currently, only Kafka is supported, but many more integrations are planned.

To install Kannika Armory, follow the steps below. For all requirements, see Requirements. For a more detailed installation guide, see Installation.

Step 1: Install the Custom Resource Definitions (CRDs)

Section titled “Step 1: Install the Custom Resource Definitions (CRDs)”

Install the Custom Resource Definitions (CRDs) on your Kubernetes cluster using kubectl.

Terminal window
$ kubectl apply -f https://docs.kannika.io/refs/0.12.4/crd/kannika-crd-v1alpha.yml

Install your license to your Kubernetes cluster using kubectl. Replace <YOUR_LICENSE_FILE> with the path to your license file.

Terminal window
$ kubectl create secret generic kannika-license \
--type=kannika.io/license \
--namespace kannika-system \
--from-file=license=<YOUR_LICENSE_FILE>

To upgrade an existing license, you may simply overwrite the existing license using kubectl apply:

Terminal window
$ kubectl create secret generic kannika-license \
--namespace kannika-system \
--from-file=license=<YOUR_LICENSE_FILE> \
--type=kannika.io/license \
--dry-run=client -o yaml | kubectl apply -f -

The operator will automatically pick up the license key and check its validity.

Install the Helm chart using Helm 3.

Terminal window
$ helm install kannika oci://quay.io/kannika/charts/kannika \
--namespace kannika-system \
--create-namespace \
--version 0.12.4

This will install all required components to your Kubernetes cluster.

You’re all set up! Head over to Creating your first backup to secure your Kafka data.

Kannika Armory currently supports all platforms that provide a Kafka API, including:

  • Apache Kafka
  • Confluent Kafka
  • Redpanda