1
0
Fork 0
mirror of https://github.com/arangodb/kube-arangodb.git synced 2024-12-14 11:57:37 +00:00
ArangoDB Kubernetes Operator - Start ArangoDB on Kubernetes in 5min
Find a file
2019-10-14 10:11:24 +02:00
.vscode File header template added 2018-02-09 11:14:03 +01:00
chart Fix Storage RBAC (#470) 2019-10-14 10:11:24 +02:00
dashboard updated dashboard npm packages. 2019-09-30 09:32:47 +02:00
deps/k8s.io/code-generator ArangoSync-Client (#408) 2019-07-08 11:49:32 +02:00
docs Add Size Field to Backup CR (#460) 2019-10-07 07:48:36 +02:00
examples Sort out permissions in reboot procedure example. (#456) 2019-09-27 09:48:16 +02:00
manifests Fix Storage RBAC (#470) 2019-10-14 10:11:24 +02:00
pkg Feature/change user password (#463) 2019-10-10 10:55:08 +02:00
scripts Arango Backup support in Operator (#438) 2019-09-27 13:04:23 +02:00
tests Feature/change user password (#463) 2019-10-10 10:55:08 +02:00
tools Arango Backup support in Operator (#438) 2019-09-27 13:04:23 +02:00
.dockerignore Added dashboard to dockerignore 2018-07-09 16:25:41 +02:00
.gitattributes Arango Backup support in Operator (#438) 2019-09-27 13:04:23 +02:00
.gitignore Allow to set ImagePullSecrets in pods (#444) 2019-09-15 18:43:55 +02:00
CHANGELOG.md CHANGELOG for 0.4.0 2019-10-09 17:44:33 +02:00
Dockerfile Initial API objects & vendoring 2018-02-09 11:11:33 +01:00
Dockerfile.test Creating test framework 2018-02-20 09:49:01 +01:00
go.mod Add Size Field to Backup CR (#460) 2019-10-07 07:48:36 +02:00
go.sum Add Size Field to Backup CR (#460) 2019-10-07 07:48:36 +02:00
Jenkinsfile.groovy Added more test environment for license stuff. 2018-12-03 14:34:58 +01:00
LICENSE Add LICENSE 2018-04-03 08:20:49 +02:00
lifecycle.go Minor 2018-08-30 08:23:13 +02:00
main.go Arango Backup support in Operator (#438) 2019-09-27 13:04:23 +02:00
MAINTAINERS.md Adjust Helm Makefile (#451) 2019-09-24 09:22:06 +02:00
Makefile Feature/change user password (#463) 2019-10-10 10:55:08 +02:00
README.md Amend README.md w.r.t. release notes. 2019-10-09 18:22:57 +02:00
reboot.go Add a test. (#436) 2019-08-06 17:02:55 +02:00
storage.go Rename repository to kube-arangodb 2018-03-13 16:25:33 +01:00
VERSION Updated to 0.4.0+git 2019-10-09 17:51:03 +02:00

ArangoDB Kubernetes Operator

Docker Pulls

ArangoDB Kubernetes Operator helps to run ArangoDB deployments on Kubernetes clusters.

To get started, follow the Installation instructions below and/or read the tutorial.

State

The ArangoDB Kubernetes Operator is still in development.

Running ArangoDB deployments (single, active-failover or cluster) is reasonably stable, and we're in the process of validating production readiness of various Kubernetes platforms.

The feature set of the ArangoDB Kubernetes Operator is close to what it is intended to be.

Documentation

Production readiness state

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".

The following table has the general readiness state, the table below covers individual newer features separately.

Platform Kubernetes version ArangoDB version ArangoDB K8s Operator Version State Production ready Remarks
Google GKE 1.10 >= 3.3.13 Runs Yes Don't use micro nodes
Google GKE 1.11 >= 3.3.13 Runs Yes Don't use micro nodes
Amazon EKS 1.11 >= 3.3.13 Runs Yes
Pivotal PKS 1.11 >= 3.3.13 Runs Yes
IBM Cloud 1.11 >= 3.4.5 >= 0.3.11 Runs Yes
IBM Cloud 1.12 >= 3.4.5 >= 0.3.11 Runs Yes
IBM Cloud 1.13 >= 3.4.6.1 >= 0.3.11 Runs Yes
Amazon & Kops 1.10 >= 3.3.13 Runs No
Azure AKS 1.10 >= 3.3.13 Runs No
OpenShift 1.10 >= 3.3.13 Runs No
Bare metal (kubeadm) 1.10 >= 3.3.13 Runs Yes
Bare metal (kubeadm) 1.11 >= 3.3.13 Runs Yes
Bare metal (kubeadm) 1.12 >= 3.3.13 Runs In progress
Bare metal (kubeadm) 1.13 >= 3.3.13 Runs Yes
Bare metal (kubeadm) 1.14 >= 3.3.13 Runs In progress
Minikube 1.10 >= 3.3.13 Runs Not intended
Docker for Mac Edge 1.10 >= 3.3.13 Runs Not intended
Scaleway Kubernetes 1.10 >= 3.3.13 ? No

Feature-wise production readiness table:

Feature ArangoDB K8s Operator Version Production Readiness Remarks
Pod Disruption Budgets 0.3.10 new - alpha
0.3.11 beta
Volume Resizing 0.3.10 new - beta
0.3.11 beta
Disabling of liveness probes 0.3.10 new - beta
0.3.11 production ready
Volume Claim Templates 0.3.11 new - alpha
Prometheus Metrics export 0.3.11 new - alpha needs Prometheus
User sidecar containers 0.3.11 new - alpha
Support for ResignLeadership 0.3.16 new - alpha
Hot backup 0.4.0 new - alpha needs ArangoDB
>= 3.5.1

Release notes for 0.4.0

In this release we have amended the Helm charts again. The same comments as for 0.3.16 apply. Furthermore, 0.4.0 is the first version to support hot backups.

Release notes for 0.3.16

In this release we have reworked the Helm charts. One notable change is that we now create a new service account specifically for the operator. The actual deployment still runs by default under the default service account unless one changes that. Note that the service account under which the ArangoDB runs needs a small set of extra permissions. For the default service account we grant them when the operator is deployed. If you use another service account you have to grant these permissions yourself. See here for details.

Installation of latest release using Kubectl

kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/0.4.0/manifests/arango-crd.yaml
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/0.4.0/manifests/arango-deployment.yaml
# To use `ArangoLocalStorage`, also run
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/0.4.0/manifests/arango-storage.yaml
# To use `ArangoDeploymentReplication`, also run
kubectl apply -f https://raw.githubusercontent.com/arangodb/kube-arangodb/0.4.0/manifests/arango-deployment-replication.yaml

This procedure can also be used for upgrades and will not harm any running ArangoDB deployments.

Installation of latest release using Helm

Only use this procedure for a new install of the operator. See below for upgrades.

# The following will install the custom resources required by the operators.
helm install https://github.com/arangodb/kube-arangodb/releases/download/0.4.0/kube-arangodb-crd-0.4.0.tgz
# The following will install the operator for `ArangoDeployment` &
# `ArangoDeploymentReplication` resources.
helm install https://github.com/arangodb/kube-arangodb/releases/download/0.4.0/kube-arangodb-0.4.0.tgz
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm install https://github.com/arangodb/kube-arangodb/releases/download/0.4.0/kube-arangodb-0.4.0.tgz --set "operator.features.storage=true"

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
steely-mule     	1       	Sun Mar 31 21:11:07 2019	DEPLOYED	kube-arangodb-crd-0.3.9             	           	default  
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

helm delete vetoed-ladybird

but not delete steely-mule. Then you could install the new version with helm install as normal:

# The following will install the operator for `ArangoDeployment` &
# `ArangoDeploymentReplication` resources.
helm install https://github.com/arangodb/kube-arangodb/releases/download/0.3.16/kube-arangodb-0.3.16.tgz
# To use `ArangoLocalStorage`, set field `operator.features.storage` to true
helm install https://github.com/arangodb/kube-arangodb/releases/download/0.3.16/kube-arangodb-0.3.16.tgz --set "operator.features.storage=true"

Building

DOCKERNAMESPACE=<your dockerhub account> make
kubectl apply -f manifests/arango-deployment-dev.yaml
# To use `ArangoLocalStorage`, also run
kubectl apply -f manifests/arango-storage-dev.yaml
# To use `ArangoDeploymentReplication`, also run
kubectl apply -f manifests/arango-deployment-replication-dev.yaml