README.md

Eclipse Ditto :: Helm

This folder contains a example helm chart which can be used to start Eclipse Ditto with its backing Database - MongoDB - and a reverse proxy - nginx - in front of the HTTP and WebSocket API.

Configure nginx

The nginx's configuration is located in the nginx.conf file and contains a "Basic authentication" for accessing the HTTP and WebSocket API. The users for this sample authentication are configured in the nginx.httpasswd file also located in this directory.

In order to add a new entry to this file, use the "openssl passwd" tool to create a hashed password:

openssl passwd -quiet
 Password: <enter password>
 Verifying - Password: <enter password>

Append the printed hash in the nginx.httpasswd file placing the username who shall receive this password in front like this:

ditto:A6BgmB8IEtPTs

Requirements

• Minikube
• kubectl
• VirtualBox
• Helm

Start Eclipse Ditto

Start Minikube and install Helm into one node cluster

minikube start
helm init

Start Eclipse Ditto

cd <DITTO_PATH>/deployment/helm/
kubectl create namespace dittons
helm dependency update ./eclipse-ditto/

(Optional) we recommend to define a K8s PersistentVolumeClaim independent of the Helm release to ensure the data survives a helm delete:

kubectl apply -f ditto-mongodb-pvc.yaml --namespace dittons

...in this case start Ditto with:

helm upgrade ditto ./eclipse-ditto/ --namespace dittons --set mongodb.persistence.enabled=true,mongodb.persistence.existingClaim=ditto-mongodb-pvc --wait --install

.. or else

helm upgrade ditto ./eclipse-ditto/ --namespace dittons --set mongodb.persistence.enabled=true --wait --install

...or without persistence for the MongoDB at all:

helm upgrade ditto ./eclipse-ditto/ --namespace dittons --wait --install

Use Eclipse Ditto

minikube service ditto

Use Minikube Dashboard

minikube dashboard

Delete Eclipse Ditto release

cd <DITTO_PATH>/deployment/helm/
helm delete --purge ditto