activiti-cloud-full-chart

Getting Started Guide

More information:

• all chart archives, located at: https://github.com/Activiti/activiti-cloud-helm-charts
• full chart, located at: https://github.com/Activiti/activiti-cloud-full-chart (this repo)
• a common chart as a base chart for all charts, located at: https://github.com/Activiti/activiti-cloud-common-chart
• charts for components, as sub folders located at: https://github.com/Activiti/activiti-cloud-application

Running on Docker Desktop

Install Docker Desktop and make sure the included single node Kubernetes cluster is started.

Install the latest version of Helm.

Add the magic host.docker.internal hostname to your hosts file:

sudo echo "127.0.0.1        host.docker.internal" > /etc/hosts

Install a recent version of ingress-nginx:

helm install --repo https://kubernetes.github.io/ingress-nginx ingress-nginx ingress-nginx --version 2.16.0

Update all dependencies:

helm dependency update charts/activiti-cloud-full-example

Create a values.yaml file with any customised values from the default values.yaml you want, as documented in the chart README.

In your local installation to start with, this would be:

global:
  gateway:
    host: host.docker.internal
  keycloak:
    host: host.docker.internal

In a generic cluster install, you can just add --set global.gateway.domain=$YOUR_CLUSTER_DOMAIN to the helm command line, provided your DNS is configured with a wildcard entry *.$YOUR_CLUSTER_DOMAIN pointing to your cluster ingress.

Install or upgrade an existing installation:

helm upgrade --install \
  --atomic --create-namespace --namespace activiti \
  -f values.yaml \
  activiti charts/activiti-cloud-full-example

Uninstall:

helm uninstall --namespace activiti activiti

WARNING All the PVCs are not deleted by helm uninstall and that should be done manually unless you want to keep data for another install.

kubectl get pvc --namespace activiti
kubectl delete pvc --namespace activiti ...

or just delete the namespace fully:

kubectl delete ns activiti

As an alternative, generate a Kubernetes descriptor you can analyse or apply offline using kubectl apply -f output.yaml:

helm template --validate \
  --atomic --create-namespace --dependency-update --namespace activiti \
  -f values.yaml \
  activiti charts/activiti-cloud-full-example

Skipping CI

If you want to skip running release pipeline stages, simply add [ci skip] to your commit message.

CI/CD

Running on Travis, requires the following environment variable to be set:

Name	Description
MAVEN_USERNAME	Internal Maven repository username
MAVEN_PASSWORD	Internal Maven repository password
GITHUB_TOKEN	Github token for git service account
GITHUB_USER	Github user name for git service account
K8S_API_TOKEN	Kubernetes API token
K8S_API_URL	Kubernetes API url