• Kubernetes v1.16+
• Helm 3

Flowable REST app can be deployed to a Kubernetes cluster using the flowable-rest.yaml manifest located in the resources folder. This manifest contains 'only' the deployment and service descriptors for Flowable REST.

A more preferred way of deploying FlowableRest is using the Helm chart. This deploys Flowable using a predefined configuration; which can be overridden. By default the chart will deploy a PostgreSQL instance. For this a PersistantVolume is required. Because different cloud providers have different implementations the applicable storage class must be provided when deploying in order to create the PersistantVolumeClaim.

There are several ways to expose the deployed Flowable REST service on the Kubernetes cluster to the outside world. For convenience the Flowable Helm chart includes ingress rules that can be used to configure an Ingress controller. For this the Ingress controller must be present and configured on the cluster. By default an Ingress with the annotation kubernetes.io/ingress.class: "nginx" will located. This class is configurable.

Info on how to install the ingress-nginx controller can be found here; Ingress-Nginx.

helm repo add flowable-oss https://flowable.github.io/helm/

helm install flowable flowable-oss/flowable \
    --create-namespace --namespace=flowable \
    --set host.external=<cluster external hostname> --set ingress.useHost=true \
    --set postgres.storage.storageClassName=default

flowable.host.external will be used for client redirects

Check for individual pod status

kubectl get pods -n flowable -w

helm delete flowable -n flowable