Prerequisites

Kubernetes concepts

This tutorial assumes you have a basic knowledge of containers and Kubernetes concepts such as Objects, Pods, PersistentVolumes, and so on. In addition, some of the use cases for operators are mentioned in this tutorial, but you should read the CoreOS documentation for a more in-depth explanation of what they are and why they are useful.

kubectl

Follow these instructions to install kubectl on the host used to control and manage your cluster.

Host requirements

Cluster deployments must be on hosts that satisfy SingleStore’s hardware and software requirements. Specifically, the following requirements must be met on all hosts:

  • Red Hat OpenShift Container Platform 4.x+

  • Kubernetes versions 1.19 through 1.32

    Note

    For supported deployment on AWS, Azure, or Google, please deploy using SingleStore Helios.

    Using a Helm Chart to deploy SingleStore via the Operator is currently not supported.

  • Physical or virtual machines with the following:

    • At least four CPU cores and eight GB of RAM per machine (8 vCPU and 32 GB of RAM is recommended for leaf nodes to align with license unit calculations)

    • Running Linux kernel 3.10 or later and either an xfs or ext4 filesystem

    • Each SingleStore Pod needs to be able to communicate with other SingleStore Pods in the same cluster over port 3306

    • The Kubernetes worker nodes/host systems must meet the specified system requirements as outlined in our System Requirements and Recommendations documentation.

Refer to Set System Requirements for more information on how to configure hosts with a Kubernetes DaemonSet.

Host recommendations

Consideration should be given to future expansion needs. SingleStore recommends that allowVolumeExpansion is set to true to enable future storage size increases. Refer to the Kubernetes documentation for more information.

Docker Container Repository (Optional)

If your container registry is internal and you cannot access Docker Hub, you can pre-load the following images into your local container repository.

Operator Container

SingleStore Node Container

SingleStore Tools Container

Last modified: July 25, 2023

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined
  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined
  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
    --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
    --bundle undefined \
    --new-bundle-format -
    Verified OK