Skip to content

Latest commit

 

History

History
120 lines (78 loc) · 4.46 KB

DEVELOPER.md

File metadata and controls

120 lines (78 loc) · 4.46 KB

Developer Notes

This project requires bazel. Version 3.4.1 has been tested.

See: https://docs.bazel.build/versions/master/install.html

Take a look at the for various targets you can run. The e2e testing requires a container engine like docker running as it starts a K8s cluster with Kind. The Makefile is simply a wrapper for bazel commands and does not have any build functionality in it.

You will also need kubectl and a running Kubernetes cluster to run the k8s targets like make k8s/apply.

Bazel has been primarily tested on Linux but "should" run on macOS as well. Windows at this time has not been tested.

TODO: notes on python configuration for the host.

If you are new to Bazel take a look at the Workspace file, as it lays out which rule sets we are using, such as docker rules and k8s rules. The Makefile notes below talk about the different target groups that run various bazel commands.

Requirements

Just a quick recap of above. Please install the following.

  1. Bazel
  2. Python - TODO version
  3. Container Engine
  4. kubectl

If you are not running the e2e tests or the Kubernetes targets you not need the last two. But you probably have them anyways.

Makefile Notes

We have four different groups of commands withing the Makefile

  1. Testing targets - targets that a run during CI and you can run locally
  2. Dev targets - build commands
  3. Kubernetes targets - we use rules_k8s that allow the deployment of the operatator to an existing registry and k8s cluster
  4. Release targets - this is WIP, but allows for pushing the operator container to a registry

Please run the testing targets locally before you push a PR.

Testing CR Database

Notes on how to test an existing CR Database.

kubectl exec into a pod

cockroach sql
CREATE TABLE bank.accounts (id INT PRIMARY KEY, balance DECIMAL);
INSERT INTO bank.accounts VALUES (1, 1000.50);
SELECT * FROM bank.accounts;

Developer Install Instructions

These instructions are for developers only. If you want to try the alpha please use the instructions in the next section.

Install the operator

git clone https://github.com/cockroachdb/cockroach-operator.git
export CLUSTER=test
# create a gke cluster
./hack/create-gke-cluster.sh -c $CLUSTER

export IMAGE_REGISTRY=us.gcr.io/$(gcloud config get-value project)
export K8S_CLUSTER=$(kubectl config view --minify -o=jsonpath='{.contexts[0].context.cluster}')
bazel run --stamp --platforms=@io_bazel_rules_go//go/toolchain:linux_amd64 \
                 //manifests:install_operator.apply

There are various examples that can be installed. The files are located in the examples directory.

Delete the cluster

When you have removed your example and the persitent volumes you can use the following command to delete your cluster.

# delete the cluster
# note this is async, and the script will complete without waiting the entire time
./hack/delete-gke-cluster.sh -c $CLUSTER

Dev Release Install Instructions

  1. If you do not have a GKE cluster we have a helper script ./hack/create-gke-cluster.sh -c test.
  2. Locate the latest released tag here https://github.com/cockroachdb/cockroach-operator/tags
  3. Clone the tag git clone --depth 1 --branch <tag_name> https://github.com/cockroachdb/cockroach-operator
  4. Execute kubectl apply -f config/crd/bases/crdb.cockroachlabs.com_crdbclusters.yaml
  5. Execute kubectl apply -f manifests/operator.yaml
  6. Check that the operator has deployed properly

The examples directory contains various examples, for example you can run kubectl apply -f examples/example.yaml.

Accessing Admin UI

First you need to create a new Kubernetes Custom Resource, in this example we will use the example/example.yaml file.

kubectl create -f example/example.yaml

When the database is up and running run the following command to get the first pod that is creasted.

kubectl get po -l app.kubernetes.io/instance=crdb-example --no-headers=true | head -n 1 | awk '{ print $1 }'

The command-line above uses "crdb-example" as it is the instance name in example.yaml file. If you name your database differently then use the appropriate name. The command in the above example will output the name crdb-example-0, and use that name in the next command.

kubectl port-forward crdb-example-0 8080

Then point your browser to http://localhost:8080 and you will load the admin UI.

NOTE: If you are installing the database in a namespace other than default, please add the -n flag appropriately.