Before you start, you must make sure you have the correct software products and versions installed on both the host system and your local client. The host environment is the set of servers where Kubernetes is installed, whether they are systems you set up yourself or hosted by a third-party cloud service, such as the Google Cloud Platform or Microsoft Azure. The local client environment is the system, such as a desktop or laptop, you use to access the services.

The following are the software requirements for running VoltDB in Kubernetes.

Host Environment

VoltDB on Kubernetes has been validated for the following cloud service providers:

Client Environment

Optionally, you may want to install VoltDB on the client so you can use the voltadmin and sqlcmd command utilities to access the database remotely. If not, you can still use kubectl to create an interactive shell process on one of the server instances and run the utilities directly on the Kubernetes pods.

Once you have the necessary software installed, you must prepare the host environment to run VoltDB. This includes adding the appropriate Docker and chart repositories to Helm and configuring your host account with the permissions necessary to access those repositories.

First, you need accounts on the Kubernetes host environment and on the docker repository where the VoltDB images are stored, https://docker.io. To run the VoltDB Helm charts, your accounts must be set up with the following permissions:

Next you must configure your client environment so you can communicate with and control Kubernetes and the Helm charts. First, install the Kubernetes and Helm command line interfaces, kubectl and helm. Next, configure the services to access the appropriate remote accounts and repositories.

The primary setup task for kubectl is creating the appropriate context for accessing the Kubernetes host you will be using. This is usually done as part of the installation or with a Kubconfig file and the kubectl config command. Once you have a context defined, you can use the kubectl cluster-info command to verify that your client is configured correctly.

For helm, you must add a link to the VoltDB docker repository, using the helm repo add command:

$ helm repo add voltdb \
     https://voltdb-kubernetes-charts.storage.googleapis.com

The first argument to the command ("voltdb") is a short name for referencing the repository in future commands. You can specify whatever name you like. The second argument is the location of the repository itself and must be entered as shown above.

Finally, you need to tell Kubernetes to access the Docker repository using the credentials for your Docker account. There are several ways to do this. You can specify your credentials on the helm command line each time you install a new VoltDB cluster. You can save the credentials in a YAML file with other parameters you pass to helm. Or you can set the credentials in a Kuerbernetes secret using kubectl.

The advantage of using a secret to store the credentials is that you only need to define them once and they are not easily discovered by others, since they are encrypted. To create a Kubernetes secret you use the kubectl create secret command, specifying the type of secret (docker-registry) and the name of the secret (which must be dockerio-registry), plus the individual credential elements as arguments:

$ kubectl create secret docker-registry dockerio-registry \
   --docker-username=johndoe          \
   --docker-password='ThisIsASecret'  \
   --docker-email="jdoe@anybody.org

Once you add the secret, you do not need to specify them again. If, on the other hand, you prefer to specify the credentials when you issue the helm commands to initialize the VoltDB cluster, you can supply them as the following helm properties using the methods described in Chapter 2, Configuring the VoltDB Database Cluster: