ArangoDB v3.8 reached End of Life (EOL) and is no longer supported.

This documentation is outdated. Please see the most recent version at docs.arangodb.com

Using the ArangoDB Kubernetes Operator

Installation

The ArangoDB Kubernetes Operator needs to be installed in your Kubernetes cluster first.

If you have Helm available, we recommend installation using Helm.

Installation with Helm

To install the ArangoDB Kubernetes Operator with helm, run the following commands (replace <version> with the version of the operator that you want to install):

export URLPREFIX=https://github.com/arangodb/kube-arangodb/releases/download/<version>
helm install $URLPREFIX/kube-arangodb-crd-<version>.tgz
helm install $URLPREFIX/kube-arangodb-<version>.tgz

This installs operators for the ArangoDeployment and ArangoDeploymentReplication resource types.

If you want to avoid the installation of the operator for the ArangoDeploymentReplication resource type, add --set=DeploymentReplication.Create=false to the helm install command.

To use ArangoLocalStorage resources, also run:

helm install $URLPREFIX/kube-arangodb-<version>.tgz --set "operator.features.storage=true"

The default CPU architecture of the operator is amd64 (x86-64). To enable ARM support (arm64) in the operator, overwrite the following setting:

helm install $URLPREFIX/kube-arangodb-<version>.tgz --set "operator.architectures={amd64,arm64}"

Use at least version 1.2.20 of the operator to use the ARM architecture.

Note that you need to set spec.architecture in the deployment specification, too, in order to create a deployment that runs on ARM chips.

For more information on installing with Helm and how to customize an installation, see Using the ArangoDB Kubernetes Operator with Helm.

Installation with Kubectl

To install the ArangoDB Kubernetes Operator without Helm, run (replace <version> with the version of the operator that you want to install):

export URLPREFIX=https://raw.githubusercontent.com/arangodb/kube-arangodb/<version>/manifests
kubectl apply -f $URLPREFIX/arango-crd.yaml
kubectl apply -f $URLPREFIX/arango-deployment.yaml

To use ArangoLocalStorage resources, also run:

kubectl apply -f $URLPREFIX/arango-storage.yaml

To use ArangoDeploymentReplication resources, also run:

kubectl apply -f $URLPREFIX/arango-deployment-replication.yaml

You can find the latest release of the ArangoDB Kubernetes Operator in the kube-arangodb repository.

ArangoDB deployment creation

Once the operator is running, you can create your ArangoDB database deployment by creating a ArangoDeployment custom resource and deploying it into your Kubernetes cluster.

For example (all examples can be found in the kube-arangodb repository):

kubectl apply -f examples/simple-cluster.yaml

Deployment removal

To remove an existing ArangoDB deployment, delete the custom resource. The operator will then delete all created resources.

For example:

kubectl delete -f examples/simple-cluster.yaml

Note that this will also delete all data in your ArangoDB deployment!

If you want to keep your data, make sure to create a backup before removing the deployment.

Operator removal

To remove the entire ArangoDB Kubernetes Operator, remove all clusters first and then remove the operator by running:

helm delete <release-name-of-kube-arangodb-chart>
# If `ArangoLocalStorage` operator is installed
helm delete <release-name-of-kube-arangodb-storage-chart>

or when you used kubectl to install the operator, run:

kubectl delete deployment arango-deployment-operator
# If `ArangoLocalStorage` operator is installed
kubectl delete deployment -n kube-system arango-storage-operator
# If `ArangoDeploymentReplication` operator is installed
kubectl delete deployment arango-deployment-replication-operator

See also