Start ArangoDB on Kubernetes in 5 minutes

    The servers need to run in Pods, you need Secrets for authentication, TLS certificates and Services to enable communication with the database.

    Use kube-arangodb, the ArangoDB Kubernetes Operator to greatly simplify this process.

    In this guide, we will explain what the ArangoDB Kubernetes Operator is, how to install it and how use it to deploy your first ArangoDB database in a Kubernetes cluster.

    First, you obviously need a Kubernetes cluster and the right credentials to access it. If you already have this, you can immediately skip to the next section. Since different cloud providers differ slightly in their Kubernetes offering, we have put together detailed tutorials for those platforms we officially support, follow the link for detailed setup instructions:

    Note that in particular the details of Role Based Access Control (RBAC) matter.

    kube-arangodb is a set of two operators that you deploy in your Kubernetes cluster to (1) manage deployments of the ArangoDB database and (2) provide PersistentVolumes on local storage of your nodes for optimal storage performance.

    Note that the operator that provides PersistentVolumes is not needed to run ArangoDB deployments. You can also use PersistentVolumes provided by other controllers.

    In this guide we will focus on the ArangoDeployment operator.

    Installing kube-arangodb

    To install kube-arangodb in your Kubernetes cluster, make sure you have access to this cluster and the rights to deploy resources at cluster level.

    For now, any recent Kubernetes cluster will do (e.g. minikube).

    Then run (replace <version> with the version of the operator that you want to install):

    • ArangoDeploymentReplication is the resource used to deploy ArangoDB DC2DC replications.

    The second command installs a Deployment that runs the operator that controls resources.

    The optional third command installs a Deployment that runs the operator that provides PersistentVolumes on local disks of the cluster nodes. Use this when running on bare-metal or if there is no provisioner for fast storage in your Kubernetes cluster. Furthermore, this also installs a new custom resource definition:

    • ArangoLocalStorage is the resource used to provision PersistentVolumes on local storage.

    The optional fourth command installs a Deployment that runs the operator that takes care of DC2DC replications.

    The first database we are going to deploy is a single server database.

    Create a file called single-server.yaml with the following content.

    1. apiVersion: "database.arangodb.com/v1alpha"
    2. kind: "ArangoDeployment"
    3. metadata:
    4.   name: "single-server"
    5. spec:
    6.   mode: Single

    Now insert this resource in your Kubernetes cluster using:

    1. kubectl apply -f single-server.yaml

    The ArangoDeployment operator in kube-arangodb will now inspect the resource you just deployed and start the process to run a single server database.

    To inspect the current status of your deployment, run:

    To inspect the pods created for this deployment, run:

      The result will look similar to this:

      1. NAME                                 READY     STATUS    RESTARTS   AGE
      2. single-server-sngl-cjtdxrgl-fe06f0   1/1       Running   0          1m

      Once the pod reports that it is has a Running status and is ready, your database s available.

      Connecting to your database

      Access to the database from outside the Kubernetes cluster is provided using an external-access service. By default this service is of type . If this type of service is not supported by your Kubernetes cluster, it will be replaced by a service of type NodePort after a minute.

      To see the type of service that has been created, run:

      When the service is of the LoadBalancer type, use the IP address listed in the EXTERNAL-IP column with port 8529. When the service is of the NodePort type, use the IP address of any of the nodes of the cluster, combine with the high (>30000) port listed in the PORT(S) column.

      Now you can connect your browser to https://<ip>:<port>/.

      Your browser will show a warning about an unknown certificate. Accept the certificate for now.

      Then login using username root and an empty password.

      If you want to delete your single server ArangoDB database, just run:

      1. kubectl delete ArangoDeployment single-server

      The deployment of a full blown cluster is very similar to deploying a single server database. The difference is in the mode field of the ArangoDeployment specification.

      Create a file called cluster.yaml with the following content.

      1. apiVersion: "database.arangodb.com/v1alpha"
      2. kind: "ArangoDeployment"
      3. metadata:
      4.   name: "cluster"
      5. spec:
      6.   mode: Cluster

      Now insert this resource in your Kubernetes cluster using:

      The same commands used in the single server deployment can be used to inspect your cluster. Just use the correct deployment name (cluster instead of single-server).

      Where to go from here