Start ArangoDB on Google Kubernetes Engine (GKE)

In this guide you'll learn how to run ArangoDB on Google Kubernetes Engine (GKE).

Create a Kubernetes cluster

In order to run ArangoDB on GKE you first need to create a Kubernetes cluster.

To do so, go to the GKE console. You'll find a list of existing clusters (initially empty).

clusters

Click on CREATE CLUSTER.

In the form that follows, enter information as seen in the screenshot below.

create a cluster

We have successfully ran clusters with 4 1 vCPU nodes or 3 2 vCPU nodes. Smaller node configurations will likely lead to unschedulable Pods.

Once you click Create, you'll return to the list of clusters and your new cluster will be listed there.

with new cluster

It will take a few minutes for the cluster to be created.

Once you're cluster is ready, a Connect button will appear in the list.

cluster is ready

Getting access to your Kubernetes cluster

Once your cluster is ready you must get access to it. The standard Connect button provided by GKE will give you access with only limited permissions. Since the Kubernetes operator also requires some cluster wide permissions, you need "administrator" permissions.

To get these permissions, do the following.

Prepare your ~/.kube/config with the following content:

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data:
    server: https://
  name: my_cluster
contexts:
- context:
    cluster: my_cluster
    user: my_cluster
  name: my_cluster
current-context: my_cluster
kind: Config
preferences: {}
users:
- name: my_cluster
  user:
    username: admin
    password:

Click on the Edit button (pencil image) next to your cluster. This will lead you to the following page.

edit cluster

Copy the Endpoint IP address and paste it after server: https://.

The click on Show credentials. The following popup will appear.

show credentials

Copy the Password and paste it after password:.

Close the popup and then return to the cluster list.

Click on Connect next to your cluster. The following popup will appear.

connect to cluster

Click on Run in Cloud Shell. It will take some time to launch a shell (in your browser).

Once ready, run the gcloud command that is already prepare in your commandline.

The run cat ~/.kube/config and copy the line that starts with certificate-authority-data:. Override the corresponding line in your local ~/.kube.config file.

You should now be able to access your cluster using kubectl.

To verify try a command like:

kubectl get pods --all-namespaces

Installing kube-arangodb

You can now install the ArangoDB Kubernetes operator in your Kubernetes cluster on GKE.

To do so, follow the Installing kube-arangodb instructions.

Deploying your first ArangoDB database

Once the ArangoDB Kubernetes operator has been installed and its Pods are in the Ready state, you can launch your first ArangoDB deployment in your Kubernetes cluster on GKE.

To do so, follow the Deploying your first ArangoDB database instructions.

Note that GKE supports Services of type LoadBalancer.