YugabyteDB operator Quikstart

YugaByte DB is a high-performance distributed SQL database (more information here). Rook provides an operator that can create and manage YugabyteDB clusters.

Prerequisites

Follow these instructions to make your kubernetes cluster ready for Rook.

TL;DR

You can create a simple YugabyteDB cluster with below commands. For more detailed instructions, please skip to the Deploy Rook YugabyteDB Operator section.

  1. cd cluster/examples/kubernetes/yugabytedb
  2. kubectl create -f operator.yaml
  3. kubectl create -f cluster.yaml

Use below commands to observe the created cluster.

  1. kubectl -n rook-yugabytedb-system get pods

Deploy Rook YugabyteDB Operator

To begin with, deploy the Rook YugabyteDB operator, which can create/manage the YugabyteDB cluster. Use following commands to do the same.

  1. cd cluster/examples/kubernetes/yugabytedb
  2. kubectl create -f operator.yaml

Observe the rook operator using below command.

  1. kubectl -n rook-yugabytedb-system get pods

Create a simple YugabyteDB cluster

After the Rook YugabyteDB operator is up and running, you can create an object of the custom resource type ybclusters.yugabytedb.rook.io. A sample resource specs are present in cluster.yaml. You can also browse/modify the contents of cluster.yaml according to the configuration options available. Refer YugabyteDB CRD documentation for details on available configuration options.

To create a YugabyteDB cluster, run

  1. kubectl create -f cluster.yaml

Verify the created custom resource object using

  1. kubectl -n rook-yugabytedb get ybclusters.yugabytedb.rook.io

Check if the required replicas of Master & TServer are running, run the following command. Tally the Master & TServer pod count against the corresponding replica count you have in cluster.yaml. With no change to the replica count, you should see 3 pods each for Master & TServer.

  1. kubectl -n rook-yugabytedb get pods

Troubleshooting

Skip this section, if the cluster is up & running. Continue to the Access the Database section to access ysql api.
If the cluster does not come up, first run following command to take a look at operator logs.

  1. kubectl -n rook-yugabytedb-system logs -l app=rook-yugabytedb-operator

If everything is OK in the operator logs, check the YugabyteDB Master & TServer logs next.

  1. kubectl -n rook-yugabytedb logs -l app=yb-master-hello-ybdb-cluster
  2. kubectl -n rook-yugabytedb logs -l app=yb-tserver-hello-ybdb-cluster

Access the Database

After all the pods in YugabyteDB cluster are running, you can access the YugabyteDB’s postgres compliant ysql api. Run following command to access it.

  1. kubectl -n rook-yugabytedb exec -it yb-tserver-hello-ybdb-cluster-0 /home/yugabyte/bin/ysqlsh -- -h yb-tserver-hello-ybdb-cluster-0 --echo-queries

Refer the YugabyteDB documentation for more details on the ysql api.

Cleanup

Run the commands below to clean up all resources created above.

NOTE: This will destroy your database and delete all of its data.

  1. kubectl delete -f cluster.yaml
  2. kubectl delete -f operator.yaml

Manually delete any Persistent Volumes that were created for this YugabyteDB cluster.