Astarte Kubernetes Operator
Astarte Operator is the foundation of any Astarte installation, and you can find more information about it and how to use it once installed in the Astarte Administration guide.
Getting started
The preferred way to install and manage Astarte Operator leverages its Helm chart.
Astarte Operator requires cert-manager (v1.7+) to be installed in
the cluster in its default configuration. If you are using cert-manager in your cluster already
you don't need to take any action - otherwise, you will need to install it. A complete overview on
prerequisites can be found
here.
To install cert-manager simply run:
helm repo add jetstack https://charts.jetstack.io
helm repo update
kubectl create namespace cert-manager
helm install \
cert-manager jetstack/cert-manager \
--namespace cert-manager \
--version v1.7.0 \
--set installCRDs=trueInstalling the operator is as simple as:
helm repo add astarte https://helm.astarte-platform.org
helm repo update
helm install astarte-operator astarte/astarte-operatorThese instructions will take care of installing all needed components for the Operator to run. This includes all the RBAC roles, Custom Resource Definitions, Webhooks, and the Operator itself.
Moreover, Helm is responsible for upgrading the Astarte Operator. To do so, run:
helm upgrade astarte-operator astarte/astarte-operatorIf you are interested in having a deeper understanding on how the Astarte Operator works you should follow the Astarte Administration guide in Astarte's Documentation.
What's next?
Once your Astarte Operator is up and running in your cluster, it will be time to deploy your Astarte instance! All you have to do is Setting up the Cluster as described in Astarte's Documentation.
Kubernetes support
| Kubernetes Version | Supported | Tested by CI |
|---|---|---|
| v1.18.x | ||
| v1.19.x | ||
| v1.20.x | ||
| v1.21.x | ||
| v1.22.x | ||
| v1.23.x |
Key:
✅ : Supported and stable.🔶 : Partially supported / known to run in production, but not being targeted by the release.❌ : Not supported. Run at your own risk.⚠️ : Kubernetes version supporting AstarteVoyagerIngress. Please, be aware that the AstarteVoyagerIngress is deprecated and the new AstarteDefaultIngress should be used.
Development
Astarte's Operator is written in Go and built upon Operator SDK. It depends on Go 1.17.x, requires Go Modules and Kubernetes v1.20+.
The project is built with kustomize v3.8.7, controller-gen v0.8.0 and conversion-gen v0.19.16.