Skip to content

Upgrading a Cluster Installation

Below are the instructions on how to upgrade a Run:ai cluster.

Upgrade Run:ai cluster

Follow the steps below, based on the Run:ai cluster version you want to upgrade to:

  • In the Run:ai interface, navigate to Clusters
  • Select the cluster you want to upgrade
  • Click Get Installation instructions
  • Choose the Run:ai version to upgrade to
  • Click Continue
  • Copy the Helm command provided in the Installation Instructions and run it on in the cluster.
  • In the case of a failure, refer to the Installation troubleshooting guide.

Run:

helm get values runai-cluster -n runai > old-values.yaml
  • Review the file old-values.yaml and see if there are any changes performed during the last installation.
  • In the Run:ai interface, navigate to Clusters.
  • Select the cluster you want to upgrade.

  • Click Get Installation instructions.

  • Follow the instructions to download a new values file.

  • Merge the changes from Step 1 into the new values file.
  • Copy the Helm command provided in the Installation Instructions and run it on in the cluster.

Verify Successful Upgrade

See Verify your installation on how to verify a Run:ai cluster installation

Before proceeding with the upgrade, it's crucial to apply the specific prerequisites associated with your current version of Run:ai and every version in between up to the version you are upgrading to.

Upgrade from version 2.9

Two significant changes to the control-plane installation have happened with version 2.12: PVC ownership and installation customization. 

kubectl patch pvc -n runai-backend pvc-thanos-receive  -p '{"metadata": {"annotations":{"helm.sh/resource-policy": "keep"}}}'
kubectl patch pvc -n runai-backend pvc-postgresql  -p '{"metadata": {"annotations":{"helm.sh/resource-policy": "keep"}}}'

Ingress

Delete the ingress object which will be recreated by the control plane upgrade.

Upgrade Control Plane

Upgrade from version 2.13, or later

helm get values runai-backend -n runai-backend > runai_control_plane_values.yaml
helm upgrade runai-backend control-plane-<NEW-VERSION>.tgz -n runai-backend  -f runai_control_plane_values.yaml --reset-then-reuse-values

Upgrade from version 2.9

To upgrade the cluster follow the instructions here.