Deploying on Kubernetes with Helm

The Tonic Textual Helm chart is available in the GitHub repository https://github.com/TonicAI/textual_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.

During the onboarding period, you are provided access credentials to our docker image repository on Quay.io. If you require new credentials, or you experience issues accessing the repository, contact [email protected].

Configure

Before you deploy Textual, 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 Textual from the forked repository, follow the instructions in the repository readme.

To use the OCI-based registry, run:

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

The GitHub repository contains a readme with the details on how to populate a values.yaml file and deploy Textual.

Update

To update to a new version of Textual:

1. In values.yaml, set textualVersion to identify the version of Textual to upgrade to. To find the latest version, review the release notes. The tag value is the version number, without the "V" prefix.

2. Run the following:

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

If you use the OCI-based registry:

helm upgrade <name_of_release> -n <namespace_name> oci://quay.io/tonicai/textual -f values.yaml --version "1.${TONIC_RELEASE}.0"