K8ssandra documentation

Welcome to K8ssandra!

The K8ssandra Documentation covers everything from architecture and configuration references to guided outcome-based tasks. Check out the sections at left based on your needs and be sure to leave us a star on Github!

What is K8ssandra?

K8ssandra is a cloud native distribution of Apache Cassandra® (Cassandra) meant to run on Kubernetes. Accompanying Cassandra is a suite of tools to ease and automate operational tasks. This includes metrics, data anti-entropy services, and backup tooling. As part of K8ssandra’s installation process all of these components are installed and wired together freeing your teams from having to perform the tedious plumbing of components.

Cassandra may be deployed in a number of environments. This includes on bare metal hosts, virtual machines, and within container platforms. Each deployment type has its pros and cons, but in all cases it is essential that automation be leveraged to ensure that all node are configured homogeneously and without failure.

K8ssandra focuses on deploying Cassandra within Kubernetes. Kubernetes was chosen as it allows for the consumption of a common, versioned, set of APIs and tooling across multiple cloud platforms and environments.

Why do I want K8ssandra?

Apache Cassandra is the NoSQL database for applications that require resilience and scalability. Unfortunately this comes with the same burdens as other distributed systems. There are multiple nodes replicating data all the time. Understanding the health of these systems requires advanced tooling and knowledge of the constituent parts. Users could spend time investigating and building out solutions to ensure operational stability of their Cassandra clusters. K8ssandra looks to provide those integrations from the start in a simple easy to deploy package.

What is K8ssandra good for?

K8ssandra is a great fit for operators looking for easy to install and manage Cassandra clusters. Even if your environment currently does not run Cassandra on Kubernetes we believe that simple installation and upkeep will win you over. Consider some of the integrations listed below:

  • All Cassandra containers are preinstalled with
  • Prometheus Operator ServiceMonitor custom resources complete with metric relabelling.
  • Grafana Operator Dashboard custom resources configured with metrics exposed by Prometheus
  • Reaper for Apache Cassandra custom resources connected to the cluster.

Where should I go next?

Depending on your needs, see the following:

  • Quick start: Get started with K8ssandra!
  • Tasks: Need to get something done? Check out the Tasks section for a helpful collection of outcome-based solutions.
  • Reference: Explore the K8ssandra configuration interface and options available.
  • Architecture: Dig in to each operational component of the K8ssandra stack and see how it communicates with the others.

Last modified March 5, 2021: Update size up/down example (#493) (c515698)