2018-02-06 07:16:21 +00:00
# ArangoDB Kubernetes Operator
2018-09-11 13:03:30 +00:00
[](https://hub.docker.com/r/arangodb/kube-arangodb/)
2019-07-04 13:37:01 +00:00
ArangoDB Kubernetes Operator helps to run ArangoDB deployments
2018-04-06 11:58:19 +00:00
on Kubernetes clusters.
2018-02-06 07:16:21 +00:00
2018-04-06 11:58:19 +00:00
To get started, follow the Installation instructions below and/or
2023-06-05 12:18:04 +00:00
read the [tutorial ](https://www.arangodb.com/docs/stable/deployment-kubernetes-usage.html ).
2018-04-06 11:58:19 +00:00
## State
2022-03-24 23:19:51 +00:00
The ArangoDB Kubernetes Operator is Production ready.
2018-02-06 07:16:21 +00:00
2022-09-19 15:26:08 +00:00
[Documentation ](https://www.arangodb.com/docs/stable/deployment-kubernetes.html )
2018-03-12 11:18:50 +00:00
2023-07-24 15:10:59 +00:00
### Limits
<!-- START(limits) -->
| Limit | Description | Community | Enterprise |
|:-------------------|:-----------------------------------------------------------------------------|:----------|:-----------|
| Cluster size limit | Limits of the nodes (DBServers & Coordinators) supported in the Cluster mode | 64 | 1024 |
<!-- END(limits) -->
2018-06-19 10:02:21 +00:00
### Production readiness state
2019-06-07 10:02:04 +00:00
Beginning with Version 0.3.11 we maintain a production readiness
state for individual new features, since we expect that new
features will first be released with an "alpha" or "beta" readiness
state and over time move to full "production readiness".
2020-07-22 12:24:22 +00:00
Operator will supports versions supported on providers and maintained by Kubernetes.
Once version is not supported anymore it will go into "Deprecating" state and will be marked as deprecated on Minor release.
2022-03-24 23:19:51 +00:00
Kubernetes versions starting from 1.18 are supported and tested, charts and manifests can use API Versions which are not present in older versions.
2020-09-17 21:20:22 +00:00
2019-06-07 10:02:04 +00:00
The following table has the general readiness state, the table below
covers individual newer features separately.
2023-07-24 15:10:59 +00:00
<!-- START(kubernetesVersionsTable) -->
2023-02-24 11:16:35 +00:00
| Platform | Kubernetes Version | ArangoDB Version | State | Remarks | Provider Remarks |
|:--------------------|:-------------------|:-----------------|:-----------|:------------------------------------------|:-----------------------------------|
2023-07-24 15:10:59 +00:00
| Google GKE | 1.21-1.26 | >= 3.6.0 | Production | Don't use micro nodes | |
| Azure AKS | 1.21-1.26 | >= 3.6.0 | Production | | |
| Amazon EKS | 1.21-1.26 | >= 3.6.0 | Production | | [Amazon EKS ](./docs/providers/eks ) |
2023-02-24 11:16:35 +00:00
| IBM Cloud | 1.17 | >= 3.6.0 | Deprecated | Support will be dropped in Operator 1.5.0 | |
| IBM Cloud | 1.18-1.21 | >= 3.6.0 | Production | | |
| OpenShift | 3.11 | >= 3.6.0 | Deprecated | Support will be dropped in Operator 1.5.0 | |
2023-07-24 15:10:59 +00:00
| OpenShift | 4.2-4.13 | >= 3.6.0 | Production | | |
2023-02-24 11:16:35 +00:00
| BareMetal (kubeadm) | < = 1.20 | >= 3.6.0 | Deprecated | Support will be dropped in Operator 1.5.0 | |
2023-07-24 15:10:59 +00:00
| BareMetal (kubeadm) | 1.21-1.27 | >= 3.6.0 | Production | | |
| Minikube | 1.21-1.27 | >= 3.6.0 | Devel Only | | |
| Other | 1.21-1.27 | >= 3.6.0 | Devel Only | | |
<!-- END(kubernetesVersionsTable) -->
#### Operator Features
<!-- START(featuresCommunityTable) -->
| Feature | Operator Version | Introduced | ArangoDB Version | ArangoDB Edition | State | Enabled | Flag | Remarks |
|:-------------------------------------------------------------------------------------|:-----------------|:-----------|:-----------------|:----------------------|:-------------|:--------|:------------------------------------------------------|:-------------------------------------------------------------------------|
| [Rebalancer V2 ](docs/design/features/rebalancer_v2.md ) | 1.2.31 | 1.2.31 | >= 3.10.0 | Community, Enterprise | Alpha | False | --deployment.feature.rebalancer-v2 | N/A |
| [Secured containers ](docs/design/features/secured_containers.md ) | 1.2.31 | 1.2.31 | >= 3.8.0 | Community, Enterprise | Alpha | False | --deployment.feature.secured-containers | If set to True Operator will run containers in secure mode |
| Version Check V2 | 1.2.31 | 1.2.31 | >= 3.8.0 | Community, Enterprise | Alpha | False | --deployment.feature.upgrade-version-check-V2 | N/A |
| [Operator Ephemeral Volumes ](docs/design/features/ephemeral_volumes.md ) | 1.2.31 | 1.2.2 | >= 3.8.0 | Community, Enterprise | Beta | False | --deployment.feature.ephemeral-volumes | N/A |
| [Force Rebuild Out Synced Shards ](docs/design/features/rebuild_out_synced_shards.md ) | 1.2.27 | 1.2.27 | >= 3.8.0 | Community, Enterprise | Production | False | --deployment.feature.force-rebuild-out-synced-shards | It should be used only if user is aware of the risks. |
| [Spec Default Restore ](docs/design/features/deployment_spec_defaults.md ) | 1.2.25 | 1.2.21 | >= 3.8.0 | Community, Enterprise | Beta | True | --deployment.feature.deployment-spec-defaults-restore | If set to False Operator will not change ArangoDeployment Spec |
| Version Check | 1.2.23 | 1.1.4 | >= 3.8.0 | Community, Enterprise | Production | True | --deployment.feature.upgrade-version-check | N/A |
| [Failover Leader service ](docs/design/features/failover_leader_service.md ) | 1.2.13 | 1.2.13 | >= 3.8.0 | Community, Enterprise | Production | False | --deployment.feature.failover-leadership | N/A |
| Graceful Restart | 1.2.5 | 1.0.7 | >= 3.8.0 | Community, Enterprise | Production | True | ---deployment.feature.graceful-shutdown | N/A |
| Optional Graceful Restart | 1.2.0 | 1.2.5 | >= 3.8.0 | Community, Enterprise | Production | False | --deployment.feature.optional-graceful-shutdown | N/A |
| Operator Internal Metrics Exporter | 1.2.0 | 1.2.0 | >= 3.8.0 | Community, Enterprise | Production | True | --deployment.feature.metrics-exporter | N/A |
| Operator Maintenance Management Support | 1.2.0 | 1.0.7 | >= 3.8.0 | Community, Enterprise | Production | True | --deployment.feature.maintenance | N/A |
| Encryption Key Rotation Support | 1.2.0 | 1.0.3 | >= 3.8.0 | Enterprise | NotSupported | False | --deployment.feature.encryption-rotation | N/A |
| TLS Runtime Rotation Support | 1.1.0 | 1.0.4 | >= 3.8.0 | Enterprise | Production | True | --deployment.feature.tls-rotation | N/A |
| JWT Rotation Support | 1.1.0 | 1.0.3 | >= 3.8.0 | Enterprise | Production | True | --deployment.feature.jwt-rotation | N/A |
| Operator Single Mode | 1.0.4 | 1.0.4 | >= 3.8.0 | Community, Enterprise | Production | False | --mode.single | Only 1 instance of Operator allowed in namespace when feature is enabled |
| TLS SNI Support | 1.0.3 | 1.0.3 | >= 3.8.0 | Enterprise | Production | True | --deployment.feature.tls-sni | N/A |
| Disabling of liveness probes | 0.3.11 | 0.3.10 | >= 3.8.0 | Community, Enterprise | Production | True | N/A | N/A |
| Pod Disruption Budgets | 0.3.11 | 0.3.10 | >= 3.8.0 | Community, Enterprise | Production | True | N/A | N/A |
| Prometheus Metrics Exporter | 0.3.11 | 0.3.10 | >= 3.8.0 | Community, Enterprise | Production | True | N/A | Prometheus required |
| Sidecar Containers | 0.3.11 | 0.3.10 | >= 3.8.0 | Community, Enterprise | Production | True | N/A | N/A |
| Volume Claim Templates | 0.3.11 | 0.3.10 | >= 3.8.0 | Community, Enterprise | Production | True | N/A | N/A |
| Volume Resizing | 0.3.11 | 0.3.10 | >= 3.8.0 | Community, Enterprise | Production | True | N/A | N/A |
<!-- END(featuresCommunityTable) -->
#### Operator Enterprise Only Features
To upgrade to the Enterprise Edition, you need to get in touch with the ArangoDB team. [Contact us ](https://www.arangodb.com/contact/ ) for more details.
<!-- START(featuresEnterpriseTable) -->
| Feature | Operator Version | Introduced | ArangoDB Version | ArangoDB Edition | State | Enabled | Flag | Remarks |
|:-------------------------------------------------------|:-----------------|:-----------|:-----------------|:-----------------|:-----------|:--------|:-----|:----------------------------------------------------------------------------|
| AgencyCache | 1.2.30 | 1.2.30 | >= 3.8.0 | Enterprise | Production | True | N/A | Enable Agency Cache mechanism in the Operator (Increase limit of the nodes) |
| Member Maintenance Support | 1.2.25 | 1.2.16 | >= 3.8.0 | Enterprise | Production | True | N/A | Enable Member Maintenance during planned restarts |
| [Rebalancer ](docs/design/features/rebalancer.md ) | 1.2.15 | 1.2.5 | >= 3.8.0 | Enterprise | Production | True | N/A | N/A |
| [TopologyAwareness ](docs/design/topology_awareness.md ) | 1.2.4 | 1.2.4 | >= 3.8.0 | Enterprise | Production | True | N/A | N/A |
<!-- END(featuresEnterpriseTable) -->
2019-02-26 08:56:28 +00:00
2022-10-26 21:44:21 +00:00
## Operator Community Edition (CE)
2019-09-25 10:38:10 +00:00
2023-07-14 09:57:39 +00:00
Image: `arangodb/kube-arangodb:1.2.31`
2019-09-25 10:38:10 +00:00
2022-10-26 21:44:21 +00:00
### Installation of latest CE release using Kubectl
2019-04-08 09:42:21 +00:00
```bash
2023-07-14 09:57:39 +00:00
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/arango-crd.yaml
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/arango-deployment.yaml
2019-04-08 09:42:21 +00:00
# To use `ArangoLocalStorage`, also run
2023-07-14 09:57:39 +00:00
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/arango-storage.yaml
2019-04-08 09:42:21 +00:00
# To use `ArangoDeploymentReplication`, also run
2023-07-14 09:57:39 +00:00
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/arango-deployment-replication.yaml
2019-04-08 09:42:21 +00:00
```
This procedure can also be used for upgrades and will not harm any
running ArangoDB deployments.
2022-10-26 21:44:21 +00:00
### Installation of latest CE release using kustomize
2020-06-17 06:29:11 +00:00
Installation using [kustomize ](https://kubernetes.io/docs/tasks/manage-kubernetes-objects/kustomization/ ) looks like installation from yaml files,
but user is allowed to modify namespace or resource names without yaml modifications.
IT is recommended to use kustomization instead of handcrafting namespace in yaml files - kustomization will replace not only resource namespaces,
but also namespace references in resources like ClusterRoleBinding.
Example kustomization file:
```
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: my-custom-namespace
bases:
- https://github.com/arangodb/kube-arangodb/manifests/kustomize/deployment/?ref=1.0.3
```
2022-10-26 21:44:21 +00:00
### Installation of latest CE release using Helm
2019-04-08 09:42:21 +00:00
Only use this procedure for a new install of the operator. See below for
upgrades.
2018-08-20 14:25:07 +00:00
```bash
# The following will install the operator for `ArangoDeployment` &
2018-11-09 04:34:54 +00:00
# `ArangoDeploymentReplication` resources.
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz
2019-09-23 07:00:10 +00:00
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz --set "operator.features.storage=true"
2018-08-20 14:25:07 +00:00
```
2022-10-26 21:44:21 +00:00
### Upgrading the operator using Helm
2019-04-08 09:42:21 +00:00
To upgrade the operator to the latest version with Helm, you have to
delete the previous deployment and then install the latest. **HOWEVER** :
You *must not delete* the deployment of the custom resource definitions
(CRDs), or your ArangoDB deployments will be deleted!
Therefore, you have to use `helm list` to find the deployments for the
operator (`kube-arangodb`) and of the storage operator
(`kube-arangodb-storage`) and use `helm delete` to delete them using the
automatically generated deployment names. Here is an example of a `helm
list` output:
```
% helm list
NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE
vetoed-ladybird 1 Mon Apr 8 11:36:58 2019 DEPLOYED kube-arangodb-0.3.10-preview default
```
So here, you would have to do
2018-03-20 10:33:37 +00:00
```bash
2019-04-08 09:42:21 +00:00
helm delete vetoed-ladybird
```
but **not delete `steely-mule`** . Then you could install the new version
with `helm install` as normal:
```bash
# The following will install the operator for `ArangoDeployment` &
# `ArangoDeploymentReplication` resources.
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz
2019-09-23 07:00:10 +00:00
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz --set "operator.features.storage=true"
2018-03-20 10:33:37 +00:00
```
2022-10-26 21:44:21 +00:00
## Operator Enterprise Edition (EE)
2023-07-14 09:57:39 +00:00
Image: `arangodb/kube-arangodb-enterprise:1.2.31`
2022-10-26 21:44:21 +00:00
### Installation of latest EE release using Kubectl
```bash
2023-07-14 09:57:39 +00:00
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/enterprise-crd.yaml
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/enterprise-deployment.yaml
2022-10-26 21:44:21 +00:00
# To use `ArangoLocalStorage`, also run
2023-07-14 09:57:39 +00:00
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/enterprise-storage.yaml
2022-10-26 21:44:21 +00:00
# To use `ArangoDeploymentReplication`, also run
2023-07-14 09:57:39 +00:00
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/1.2.31/manifests/enterprise-deployment-replication.yaml
2022-10-26 21:44:21 +00:00
```
This procedure can also be used for upgrades and will not harm any
running ArangoDB deployments.
### Installation of latest EE release using kustomize
Installation using [kustomize ](https://kubernetes.io/docs/tasks/manage-kubernetes-objects/kustomization/ ) looks like installation from yaml files,
but user is allowed to modify namespace or resource names without yaml modifications.
IT is recommended to use kustomization instead of handcrafting namespace in yaml files - kustomization will replace not only resource namespaces,
but also namespace references in resources like ClusterRoleBinding.
Example kustomization file:
```
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: my-custom-namespace
bases:
- https://github.com/arangodb/kube-arangodb/manifests/kustomize-enterprise/deployment/?ref=1.0.3
```
### Installation of latest EE release using Helm
Only use this procedure for a new install of the operator. See below for
upgrades.
```bash
# The following will install the operator for `ArangoDeployment` &
# `ArangoDeploymentReplication` resources.
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz --set "operator.image=arangodb/kube-arangodb-enterprise:1.2.31"
2022-10-26 21:44:21 +00:00
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz --set "operator.image=arangodb/kube-arangodb-enterprise:1.2.31" --set "operator.features.storage=true"
2022-10-26 21:44:21 +00:00
```
### Upgrading the operator using Helm
To upgrade the operator to the latest version with Helm, you have to
delete the previous deployment and then install the latest. **HOWEVER** :
You *must not delete* the deployment of the custom resource definitions
(CRDs), or your ArangoDB deployments will be deleted!
Therefore, you have to use `helm list` to find the deployments for the
operator (`kube-arangodb`) and of the storage operator
(`kube-arangodb-storage`) and use `helm delete` to delete them using the
automatically generated deployment names. Here is an example of a `helm
list` output:
```
% helm list
NAME REVISION UPDATED STATUS CHART APP VERSION NAMESPACE
vetoed-ladybird 1 Mon Apr 8 11:36:58 2019 DEPLOYED kube-arangodb-0.3.10-preview default
```
So here, you would have to do
```bash
helm delete vetoed-ladybird
```
but **not delete `steely-mule`** . Then you could install the new version
with `helm install` as normal:
```bash
# The following will install the operator for `ArangoDeployment` &
# `ArangoDeploymentReplication` resources.
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz --set "operator.image=arangodb/kube-arangodb-enterprise:1.2.31"
2022-10-26 21:44:21 +00:00
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
2023-07-14 09:57:39 +00:00
helm install https://github.com/arangodb/kube-arangodb/releases/download/1.2.31/kube-arangodb-1.2.31.tgz --set "operator.image=arangodb/kube-arangodb-enterprise:1.2.31" --set "operator.features.storage=true"
2022-10-26 21:44:21 +00:00
```
2018-03-12 11:18:50 +00:00
## Building
```bash
2019-06-25 11:55:48 +00:00
DOCKERNAMESPACE=< your dockerhub account > make
2018-03-19 10:09:20 +00:00
kubectl apply -f manifests/arango-deployment-dev.yaml
# To use `ArangoLocalStorage`, also run
kubectl apply -f manifests/arango-storage-dev.yaml
2018-06-19 09:47:56 +00:00
# To use `ArangoDeploymentReplication`, also run
kubectl apply -f manifests/arango-deployment-replication-dev.yaml
2018-03-12 11:18:50 +00:00
```
