helm-charts-hardened/examples/tornjak/README.md

Recommended setup to deploy Tornjak

Warning

The default version of Tornjak in this chart is deployed without authentication. Therefore it is not suitable to run this version in production. In order to enable the user authentication, follow Keycloak instructions

Deploy Standard SPIRE

Follow the production installation of SPIRE as described in the install instructions document.

Upgrade to Enable Tornjak

Before we can deploy Tornjak with SPIRE, we need to decide whether the services will be using direct access, ingress, or some other method.

Tornjak with Direct Access

This can be done using port forward.

Deploy SPIRE with Tornjak enabled and start the Tornjak API on port 10000.

export TORNJAK_API=http://localhost:10000

helm upgrade --install -n spire-mgmt spire spire \
--repo https://spiffe.github.io/helm-charts-hardened/ \
--set tornjak-frontend.apiServerURL=$TORNJAK_API \
--values examples/tornjak/values.yaml \
--values your-values.yaml \
--render-subchart-notes

# test the Tornjak deployment
helm test spire -n spire-server

Port forward the Tornjak backend (APIs) and Tornjak frontend (UI) services. Execute these commands in separate consoles. If you deployed in a different namespace, your values might differ. Consult the install notes printed when running above helm upgrade command in that case.

kubectl -n spire-server port-forward service/spire-tornjak-backend 10000:10000

kubectl -n spire-server port-forward service/spire-tornjak-frontend 3000:3000

You can now access Tornjak with your browser at localhost:3000.

See values.yaml for more details on the chart configurations to achieve this setup.

Deploy Tornjak with ingress-nginx

Update your-values.yaml with your ingress information (most importantly your trustDomain) and redeploy by adding the following:

--set global.spire.ingressControllerType=ingress-nginx \
--values examples/tornjak/values-ingress.yaml

Deploy Tornjak with Ingress on Openshift

Obtain the OpenShift apps subdomain for ingress and assign it to the trustDomain environment variable:

export appdomain=$(oc get cm -n openshift-config-managed console-public -o go-template="{{ .data.consoleURL }}" | sed 's@https://@@; s/^[^.]*\.//')
echo $appdomain

So it can be passed as follow:

--set global.openshift=true \
--set global.spire.trustDomain=$appdomain \
--values examples/tornjak/values-ingress.yaml \

When running on Openshift in some environments like IBM Cloud, you may need to add the following configurations:

--values examples/openshift/values-ibm-cloud.yaml

Validation

Confirm access to the Tornjak API (backend):

curl https://tornjak-backend.$appdomain
"Welcome to the Tornjak Backend!"

If the APIs are accessible, we can verify the Tornjak UI (a React application running in the local browser) can be accessed. Test access to Tornjak by opening the URL provided in Tornjak-frontend route:

oc get route -n spire-server -l=app.kubernetes.io/name=tornjak-frontend -o jsonpath='https://{ .items[0].spec.host }'

The value should match the following URL:

echo "https://tornjak-frontend.$appdomain"