Skip to main content

Kubernetes

Step 1 - Prerequisites

note

Kubernetes is still in Beta.

  1. A local cluster. There are multiple options to run a local cluster:

    1. docker-for-desktop
    2. kind
    3. microk8s
    4. minikube
caution

This local cluster is only required when you want to test the Kubernetes deployment on a local environment. If you have classic Kubernetes infrastructure, skip this first step and check the necessary additional configuration of Volumes, Networking, or General configuration.

info

This guide has been tested on minikube.

  1. kubectl, with a correct kubeconfig. Check your installation with kubectl version.
  2. helm cli. Check your installation with helm version.

Step 2 - Installation

  1. Add the repo:

    ```
    helm repo add exivity https://charts.exivity.com
    ```
    info

    If you had already added this repo earlier, run helm repo update to retrieve the latest versions of the packages.

  2. Verify the repo is added:

    helm search repo exivity
  3. Create a namespace:

    kubectl create ns exivity-quickstart
  4. Install the helm-chart:

    helm install -n exivity-quickstart exivity-quickstart exivity/exivity -f https://raw.githubusercontent.com/exivity/charts/main/charts/exivity/examples/quickstart-config.yaml

Step 3 - Verifying Installation

Linux

  1. Enable ingress, on minikube this can be done with:

    minikube addons enable ingress
  2. Get the IP for your minikube instance by running:

    minikube ip
  3. Add a DNS record to your /etc/hosts file by appending the following to the file, replacing the IP with the result from the minikube ip command:

    0.0.0.0    exivity-quickstart.local 
info

You might need admin rights to edit this file.

  1. Browse to exivity-quickstart.local
  2. Log in using these credentials
    username: admin
    password: exivity

Windows

  1. Enable ingress, on minikube this can be done with:
    minikube addons enable ingress
  2. Make the application available on localhost by executing:
    minikube tunnel
  3. Browse to localhost
  4. Log in using these credentials:
    username: admin
    password: exivity

Removing Installation

To uninstall the chart:

helm delete <chart-name>

To delete the PVCs (Persistent Volume Claims) associated with the release:

kubectl delete pvc -l app.kubernetes.io/instance=exivity