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
Operator Dashboards
The ArangoDB Kubernetes Operator can create a dashboard for each type of resource it supports. These dashboards are intended to give an overview of the created resources, their state and instructions on how to modify those resources.
The dashboards do not provide direct means to modify the resources.
All modifications are done using kubectl
commands (which are provided by the dashboards)
so the standard security of your Kubernetes cluster is not bypassed.
Exposing the dashboards
For each resource type (deployment, deployment replication & local storage) operator
a Service
is created that serves the dashboard internally in the Kubernetes cluster.
To expose a dashboard outside the Kubernetes cluster, run a kubecty expose
command like this:
kubectl expose service <service-name> --type=LoadBalancer \
--port=8528 --target-port=8528 \
--name=<your-exposed-service-name> --namespace=<the-namespace>
Replace <service-name>
with:
arango-deployment-operator
for the ArangoDeployment operator dashboard.arango-deployment-replication-operator
for the ArangoDeploymentReplication operator dashboard.arango-storage-operator
for the ArangoLocalStorage operator dashboard. (use ‘kube-system’ namespace)
Replace <the-namespace>
with the name of the namespace that the operator is in.
This will often be default
.
This will create an additional Service
of type LoadBalancer
that copies
the selector from the existing Service
.
If your Kubernetes cluster does not support loadbalancers,
use --type=NodePort
instead.
Run the following command to inspect your new service and look for the loadbalancer IP/host address (or nodeport).
kubectl get service <your-exposed-service-name> --namespace=<the-namespace>
This will result in something like this:
$ kubectl get service arango-storage-operator-lb --namespace=kube-system
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
arango-storage-operator-lb LoadBalancer 10.103.30.24 192.168.31.11 8528:30655/TCP 1d
Authentication
While the dashboards do not provide any means to directly modify resources, they still show sensitive information (e.g. TLS certificates). Therefore the dashboards require a username+password for authentications.
The username+password pair is configured in a generic Kubernetes Secret
named arangodb-operator-dashboard
, found in the namespace where the operator runs.
To create such a secret, run this:
kubectl create secret generic \
arangodb-operator-dashboard --namespace=<the-namespace> \
--from-literal=username=<username> \
--from-literal=password=<password>
Until such a Secret
is found, the operator will respond with a status 401
to any request related to the dashboard.