This directory contains the Helm chart for deploying the ECK operator, and charts for deploying any resource in the Elastic Stack individually, or as a group.

The instructions below are intended to deploy the Helm charts from a local copy of this repository. Refer to https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-install-helm.html to install the charts from the official repository.

View the available settings for customizing the installation.

helm show values ./eck-operator

Install the CRDs and deploy the operator with cluster-wide permissions to manage all namespaces.

helm install elastic-operator ./eck-operator -n elastic-system --create-namespace

Install the operator restricted to a single namespace.

# This step must be done by a cluster administrator to install the CRDs -- which are global resources.
helm install elastic-operator-crds ./eck-operator/charts/eck-operator-crds

# This step can be done by any user with full access to the my-namespace namespace.
helm install elastic-operator ./eck-operator -n my-namespace --create-namespace \
  --set=installCRDs=false \
  --set=managedNamespaces='{my-namespace}' \
  --set=createClusterScopedResources=false \
  --set=webhook.enabled=false

Install a quickstart Elasticsearch and Kibana resource in a cluster controlled by the ECK Operator.

helm install es-kb-quickstart ./eck-stack -n elastic-stack --create-namespace

To see all resources installed by the helm chart:

kubectl get elastic -l "app.kubernetes.io/instance"=es-kb-quickstart -n elastic-stack

Helm UnitTest Plugin is used to ensure Helm Charts render properly.

helm plugin install https://github.com/quintush/helm-unittest --version 0.2.8

The test suite can be run from the Makefile in the root of the project with the following command:

make helm-test

Note that the Makefile target runs the script in {root}/hack/helm/test.sh

The Helm unit tests can be manually invoked for any of the charts with the following command:

cd deploy/eck-stack
helm unittest -3 -f 'templates/tests/*.yaml' --with-subchart=false .

The ECK Helm Charts are licensed under the Elastic License 2.0 like the operator, but require different subscription levels.

The ECK Operator Helm Chart can be used with a Basic license for free, while the ECK Stack and Resources Helm Charts require an Elastic Enterprise License for use.