Deploying on Kubernetes with Helm

Install

A Tonic Structural Helm chart is located at: https://github.com/TonicAI/tonic_helm_charts.

To use the Helm chart, you can either:

• Use the OCI-based registry that Tonic hosts on Quay.io.

• Fork or clone the repository and then maintain it locally.

The Structural images are hosted on Quay.io. During the onboarding period, you are provided access credentials to our repositories. If you require new credentials, or you experience issues accessing the repository, contact [e-mail].

Configure

Before you deploy Structural, you create a values.yaml file with the configuration for your instance.

For details about the required and optional configuration options, go to the repository readme.

Deploy

To deploy and validate access to Structural from the forked repository, follow the instructions in the repository readme.

To use the OCI-based registry, run:

helm install structural oci://quay.io/tonicai/structural -f values.yaml -n structural --create-namespace

Update

Structural notifies you when the current version is more than 10 versions behind the most recent release. The notification is on the System Status tab of Tonic Settings view.

To get the latest Structural version, users with the Update Tonic global permission can use the in-app update feature.

Alternatively, if you need to specify a particular version of Structural to use, set tonicVersion, then run the following:

$ helm upgrade <name_of_release> -n <namespace_name> <path-to-helm-chart>

To upgrade using the OCI-based repository, run:

helm upgrade -n structural structural oci://quay.io/tonicai/structural -f values.yaml --version "1.${TONIC_RELEASE}.0"

When you make changes to your deployment with Helm, if your tonicVersion tag is latest, make sure that you update all of your individual pods/containers to the same version.