Deploy a SingleStore Cluster

Now that your various object definition files are created, you will use kubectl to do the actual object creation and cluster deployment.

  1. Create the RBAC resources.

    kubectl create -f sdb-rbac.yaml
  2. Create the cluster resource definition.

    kubectl create -f sdb-cluster-crd.yaml
  3. When deploying on OpenShift, the recommended deployment method, perform this step.

    oc get namespace <the-namespace-you-want-to-deploy-in> \
    -o=jsonpath='{.metadata.annotations.openshift\.io/sa\.scc\.supplemental-groups}{"\n"}'

    This command will display output similar to 1096160000/10000. Note that the actual numbers may differ.

    Copy the number before the slash (/) and replace the value in --fs-group-id (which is currently 5555) with this number in the sdb-operator.yaml file.

  4. Deploy the Operator.

    kubectl create -f sdb-operator.yaml
  5. Verify the deployment was successful by checking the status of the pods in your Kube cluster. You should see the Operator with a status of Running.

    kubectl get pods
  6. Finally, create the cluster.

    kubectl create -f sdb-cluster.yaml
  7. After a couple minutes, run kubectl get pods again to verify the aggregator and leaf nodes all started and have a status of Running.

    kubectl get pods

    If you see no pods are in the Running state, then run kubectl get statefulsets to see if the statefulsets are running. If you need to debug an inoperable cluster, check the Operator logs by running kubectl logs deployment sdb-operator and then look at the various objects to see what is failing.

In this section

Last modified: July 24, 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