docker-desktop

Local cluster example using Docker Desktop

This example installs the stack on a local cluster. This is especially useful for testing, developing, and for educational purposes.

Note: This example has only been tested with Kubernetes single node cluster provided by Docker Desktop on Windows 10.

👁️‍🗨️ Requirements

• A local (single node) Kubernetes cluster
• kubectl installed and configured for you local cluster
• helm installed

🚀 Usage

1. Get the helm repos of all dependencies

   helm repo add iot-stack https://tum-gis.github.io/tum-gis-iot-stack-k8s
   
   # Optional, comment out if nginx-ingress controller is already installed in your cluster
   # helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
   
   # Optional: Uncomment, if you want to test cert-manager as certificate issuer
   # helm repo add jetstack https://charts.jetstack.io
   
   # Update all repos
   helm repo update

2. Install the chart with the default configuration specified in values-local.yml:

   helm install iot-stack iot-stack/tum-gis-iot-stack-k8s \
     -n iot-stack --create-namespace \
     --atomic --wait \
     --values "https://raw.githubusercontent.com/tum-gis/tum-gis-iot-stack-k8s/main/examples/local/values-local.yml"

3. After the chart has installed successfully, the services are available here:

   • FROST-Server:
     • HTTP: https://localhost/frost
     • MQTT: localhost:1883
   • Grafana: https://localhost/grafana
   • Node-Red: https://localhost/nodered

All services can be accessed with the username admin and password changeMe.

🛠️ Customization

If you want to change the default configuration (which is highly recommended to change the default password), download a copy of values-local.yml. Edit the file locally and install the chart using your local configuration:

helm install iot-stack iot-stack/tum-gis-iot-stack-k8s \
  -n iot-stack --create-namespace \
  --atomic --wait \
  --values my-local-values.yml