Configure Cassandra or DSE in Kubernetes with Cassandra Operator

Configure Cassandra or DSE in Kubernetes with Cass Operator.

Complete the following procedure to configure Cass Operator in your existing Kubernetes environment.

Prerequisites

Tip: If you haven't already, create a Kubernetes cluster. For a walkthrough of the steps – especially if you're new to Kubernetes – see the Google Kubernetes Engine (GKE) cloud example in this guide's topic, Create a Kubernetes cluster.
The Cass Operator prerequisites are:
  • The kubectl CLI tool.
  • A Kubernetes cluster.
    Tip: If you're new to Kubernetes, see Create a Kubernetes cluster for a walkthrough of the steps.
    Kubernetes v1.13 or later is recommended. For the supported manifests, refer to the sample YAML files in this GitHub folder.
  • The ability to download Docker Hub images from within the Kubernetes cluster.
  • At least one Kubernetes worker node per Cassandra or DSE instance.

Procedure

  1. Create a namespace
    Cass Operator is built to watch over pods running Cassandra 3.11 or later, or DSE 6.8.0 or later, in a Kubernetes namespace. Create a namespace for the cluster. Example:
    kubectl create ns my-db-ns
    In this topic, we will use the namespace my-db-ns. Adjust subsequent commands to match the namespace that you defined.
  2. Define a storage class
    Kubernetes uses the StorageClass resource as an abstraction layer between pods needing persistent storage and the physical storage resources that a specific Kubernetes cluster can provide.
    Tip: For an introduction to the storage class, refer to the Kubernetes documentation.
    DataStax recommends that you use the fastest type of networked storage available. For example, on Google Kubernetes Engine (GKE), the following YAML parameters would define persistent network SSD-backed volumes.
    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: server-storage
    provisioner: kubernetes.io/gce-pd
    parameters:
      type: pd-ssd
      replication-type: none
    volumeBindingMode: WaitForFirstConsumer
    You can customize the values for your environment and save the configuration. For example, as server-storage.yaml. This topic assumes you have defined a StorageClass and named it server-storage. Using the kubectl command, apply that file and get the resulting storage classes from Kubernetes with the following:
    kubectl -n my-db-ns apply -f ./server-storage.yaml
    To verify the storage class configuration:
    kubectl -n my-db-ns get storageclass
    NAME                 PROVISIONER            AGE
    server-storage       kubernetes.io/gce-pd   1m
    standard (default)   kubernetes.io/gce-pd   16m
  3. Deploy the operator
    The examples in this guide present several Kubernetes resources in a single operator YAML manifests file. It contains the properties needed to deploy the operator. DataStax provides a set of Cass Operator sample manifest YAML files based on supported Kubernetes releases. Download and customize the relevant YAML for your environment. The file includes values for the following resources:
    1. ServiceAccount, Role, and RoleBinding to describe a user and set of permissions necessary to run the operator. In non-production environments that do not have role-based access control enabled, these extra steps are unnecessary but do no harm to have defined, and serve as a best practice example ahead of your eventual production deployments.
    2. CustomResourceDefinition (CRD) for the CassandraDatacenter resources used to configure clusters managed by Cass Operator.
    3. Deployment parameters to start the operator in a state where it waits and watches for CassandaDatacenter resources.
    Generally, cluster-admin privileges are required to register a CRD. All privileges needed by Cass Operator are present within the release-specific sample manifest YAML files hosted by DataStax.
    Note: The operator does not require cluster-admin privileges. Only the user defining the CRD requires those permissions.
    Using kubectl, apply the cass-operator-manifests YAML file and wait for the deployment to become ready. Example:
    kubectl -n my-db-ns apply -f ./cass-operator-manifests.yaml
  4. Track progress during deployment
    For this async operation, you can watch the status by periodically checking the list of pods for the namespace. Example:
    kubectl -n my-db-ns get pod 
    NAME                           READY  STATUS   RESTARTS  AGE 
    cass-operator-f74447c57-kdf2p  1/1    Running  0         1h 
    When the pod status is Running, the operator is ready to use.

What's next

Provision Cassandra or DSE in Kubernetes with Cassandra Operator.