Upgrade Run:ai¶

Preparations¶

Upgrade from Version 2.7 or 2.8.¶

Before upgrading the control plane, run:

POSTGRES_PV=$(kubectl get pvc pvc-postgresql -n runai-backend -o jsonpath='{.spec.volumeName}')
kubectl patch pv $POSTGRES_PV -p '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'

kubectl delete secret -n runai-backend runai-backend-postgresql
kubectl delete sts -n runai-backend keycloak runai-backend-postgresql

Then upgrade the control plane as described below. Before upgrading, find customizations and merge them as discussed below.

Upgrade from Version 2.9, 2.10 or 2.11¶

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

PVC Ownership¶

Run:ai will no longer directly create the PVCs that store Run:ai data (metrics and database). Instead, going forward,

• Run:ai requires a Kubernetes storage class to be installed.
• The PVCs are created by the Kubernetes StatefulSets.

The storage class, as per Kubernetes standards, controls the reclaim behavior: whether the data is saved or deleted when the Run:ai control plane is deleted.

To remove the ownership in an older installation, run:

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

Installation Customization¶

The Run:ai control-plane installation has been rewritten and is no longer using a backend values file. Instead, to customize the installation use standard --set flags. If you have previously customized the installation, you must now extract these customizations and add them as --set flag to the helm installation:

• Find previous customizations to the control plane if such exist. Run:ai provides a utility for that here https://raw.githubusercontent.com/run-ai/docs/v2.13/install/backend/cp-helm-vals-diff.sh. For information on how to use this utility please contact Run:ai customer support.
• Search for the customizations you found in the optional configurations table and add them in the new format.

Then upgrade the control plane as described below.

Upgrade the Control Plane¶

helm upgrade -i runai-backend -n runai-backend runai-backend/control-plane --version "~2.13.0"  \
--set global.domain=runai.apps.<OPENSHIFT-CLUSTER-DOMAIN> \ #(1)
--set global.config.kubernetesDistribution=openshift \
--set thanos.query.stores={thanos-grpc-port-forwarder:10901} \
--set postgresql.primary.persistence.existingClaim=pvc-postgresql

helm upgrade -i runai-backend  ./runai-backend-<version>.tgz -n runai-backend \
--set global.domain=runai.apps.<OPENSHIFT-CLUSTER-DOMAIN> \ #(1)
--set global.config.kubernetesDistribution=openshift \
--set thanos.query.stores={thanos-grpc-port-forwarder:10901} \
--set postgresql.primary.persistence.existingClaim=pvc-postgresql

Upgrade Cluster¶

helm get values runai-cluster -n runai > values.yaml
helm upgrade runai-cluster -n runai runai-cluster-<version>.tgz -f values.yaml