Prerequisites of the deployment

Prerequisites on the Local Machine

  • Kubernetes command line tool kubectl

  • Helm Version >= 3.13

  • The Helm chart and all necessary images have to be available in a registry that can be accessed over the Internet or via local network from the installation machine

You will need credentials (username/password) to be able to pull the CadenzaWeb-Image from the disy Registry. Please get in touch with your account representative to receive these credentials.

Prerequisites on the Kubernetes Cluster

  • Depending on the version of the Cadenza Helm chart you need a specific minimal Kubernetes version. You can get this information in the Chart.yaml under the id kubeVersion. Since Disy releases a chart version specifically for a Cadenza version (<major>.<minor> must always be the same for the Helmchart and the used Cadenza version), the minimal Kubernetes version changes between the Cadenza versions.

  • Working Kubernetes Ingress controller

  • Kubernetes cluster for exclusive use by Cadenza or a separate namespace within an existing cluster

    • Define the ressources for your project and namespace where CadenzaWeb should run

    • Create StorageClass for persistent VolumeClaims in ReadWriteOnce mode

Creation of customized Helm values for your installation

The Helmchart provides a values.yaml file with which the chart can be installed with its default values. In this state, all optional components are deactivated and no ingress objects are deployed. For a customized deployment adapted to your requirements and environment, an installation-specific custom-values.yaml should be created which can be used as input for the deployment.

An explanation of the individual values can be found in the documentation of the chart, where all variables are briefly described.

Please make sure to replace the 10.x.x in the version number with the actual values of version you want to use / look up , e.g. 10.2.0.

The documentation of the chart can be displayed with:

helm show readme oci://registry-ext.disy.net/cadenza-helm/cadenza --version 10.x.x

You can display the pre-assigned values in a terminal with:

helm show values oci://registry-ext.disy.net/cadenza-helm/cadenza --version 10.x.x

We encourage you to use the Disy ArtifactHUB instance at charts.disy.net to review the readme file of the Helm Chart:

https://charts.disy.net/packages/helm/cadenza/cadenza/10.x.x

The view for the default values also offers a diff view to earlier versions of the Helm chart so that you can easily detect which changes you need to make to your values file.

You can safe the pre-assigned values in a file with:

helm show values oci://registry-ext.disy.net/cadenza-helm/cadenza --version 10.x.x > custom-values.yaml

The generated custom-values.yaml should be stored in a version control system so that adjustments can be tracked and undone if necessary. This file is reused each time the deployment is updated.