|
1 | 1 |
|
2 | 2 | # Upgrading a Cluster Installation
|
| 3 | +Below are instructions on how to upgrade a Run:ai cluster. |
3 | 4 |
|
4 |
| -## Find out Run:ai Cluster version |
| 5 | +## Upgrade Run:ai cluster |
| 6 | +Follow the steps bellow, based on the Run:ai Cluster version you would like to upgrade to: |
5 | 7 |
|
6 |
| -To find the Run:ai cluster version, run: |
| 8 | +=== "2.15-latest" |
| 9 | + * In the Run:ai interface, navigate to `Clusters`. |
| 10 | + * Select the cluster you want to upgrade. |
| 11 | + * Click on `Get Installation instructions`. |
| 12 | + * Choose the `Run:ai version` to upgrade to. |
| 13 | + * Press `Continue`. |
| 14 | + * Copy the [Helm](https://helm.sh/docs/intro/install/) command provided in the `Installation Instructions` and run it on in the cluster. |
| 15 | + * In the case of a failure, refer to the [Installation troubleshooting guide](../../troubleshooting/troubleshooting.md#installation). |
7 | 16 |
|
8 |
| -``` |
9 |
| -helm list -n runai -f runai-cluster |
10 |
| -``` |
| 17 | +=== "2.13" |
| 18 | + Run: |
11 | 19 |
|
12 |
| -and record the chart version in the form of `runai-cluster-<version-number>` |
13 |
| - |
14 |
| -## Upgrade Run:ai cluster |
15 |
| - |
16 |
| -### Upgrade from version 2.15+ |
17 |
| -* In the Run:ai interface, navigate to `Clusters`. |
18 |
| -* Select the cluster you want to upgrade. |
19 |
| -* Click on `Get Installation instructions`. |
20 |
| -* Choose the `Run:ai version` to be installed on the Cluster. |
21 |
| -* Press `Continue`. |
22 |
| -* Copy the [Helm](https://helm.sh/docs/intro/install/) command provided in the `Installation Instructions` and run it on in the cluster. |
23 |
| -* In the case of a failure, refer to the [Installation troubleshooting guide](../../troubleshooting/troubleshooting.md#installation). |
24 |
| - |
25 |
| -### Upgrade from version 2.9, 2.10, 2.11 or 2.12 |
26 |
| -Run: |
27 |
| - |
28 |
| -``` |
29 |
| -helm get values runai-cluster -n runai > old-values.yaml |
30 |
| -``` |
31 |
| - |
32 |
| -1. Review the file `old-values.yaml` and see if there are any changes performed during the last installation. |
33 |
| -2. Follow the instructions for [Installing Run:ai](cluster-install.md#install-runai) to download a new values file. |
34 |
| -3. Merge the changes from Step 1 into the new values file. |
35 |
| -4. Run `helm upgrade` as per the instructions in the link above. |
36 |
| - |
37 |
| - |
38 |
| -!!! Note |
39 |
| - To upgrade to a __specific__ version of the Run:ai cluster, add `--version <version-number>` to the `helm upgrade` command. You can find the relevant version with `helm search repo` as described above. |
40 |
| - |
41 |
| -### Upgrade from version 2.7 or 2.8 |
42 |
| - |
43 |
| -The process of upgrading from 2.7 or 2.8 requires [uninstalling](./cluster-delete.md) and then [installing](./cluster-install.md) again. No data is lost during the process. |
44 |
| - |
45 |
| -!!! Note |
46 |
| - The reason for this process is that Run:ai 2.9 cluster installation no longer installs pre-requisites. As such ownership of dependencies such as Prometheus will be undefined if a `helm upgrade` is run. |
47 |
| - |
48 |
| -The process: |
49 |
| - |
50 |
| -* Delete the Run:ai cluster installation according to these [instructions](cluster-delete.md) (do not delete the Run:ai cluster __object__ from the user interface). |
51 |
| -* The following commands should be executed __after__ running the helm uninstall command |
52 | 20 | ```
|
53 |
| - kubectl -n runai delete all --all |
54 |
| - kubectl -n runai delete cm --all |
55 |
| - kubectl -n runai delete secret --all |
56 |
| - kubectl -n runai delete roles --all |
57 |
| - kubectl -n runai delete rolebindings --all |
58 |
| - kubectl -n runai delete ingress --all |
59 |
| - kubectl -n runai delete servicemonitors --all |
60 |
| - kubectl -n runai delete podmonitors --all |
61 |
| - kubectl delete validatingwebhookconfigurations.admissionregistration.k8s.io -l app=runai |
62 |
| - kubectl delete mutatingwebhookconfigurations.admissionregistration.k8s.io -l app=runai |
63 |
| - kubectl delete svc -n kube-system runai-cluster-kube-prometh-kubelet |
64 |
| - ``` |
65 |
| -* Install the mandatory Run:ai [prerequisites](cluster-prerequisites.md): |
66 |
| - * If you have previously installed the SaaS version of Run:ai version 2.7 or below, you will need to install both [Ingress Controller](cluster-prerequisites.md#ingress-controller) and [Prometheus](cluster-prerequisites.md#prometheus). |
67 |
| - * If you have previously installed the SaaS version of Run:ai version 2.8 or any Self-hosted version of Run:ai, you will need to install [Prometheus](cluster-prerequisites.md#prometheus) only. |
68 |
| -
|
69 |
| -
|
70 |
| -* Install Run:ai cluster as described [here](cluster-install.md) |
71 |
| -
|
72 |
| -## Verify Successful Installation |
| 21 | + helm get values runai-cluster -n runai > old-values.yaml |
| 22 | + ``` |
73 | 23 |
|
| 24 | + * Review the file `old-values.yaml` and see if there are any changes performed during the last installation. |
| 25 | + * In the Run:ai interface, navigate to `Clusters`. |
| 26 | + * Select the cluster you want to upgrade. |
| 27 | + * Click on `Get Installation instructions`. |
| 28 | + * Select `Run:ai version: 2.13`. |
| 29 | + * Select the `cluster's Kubernetes distribution` and the `Cluster location` |
| 30 | + * If the Cluster locaiton is remote to the control plane - Enter a URL for the Kubernetes cluster. |
| 31 | + * Press `Continue`. |
| 32 | + * Follow the instructions to download a new values file. |
| 33 | + * Merge the changes from Step 1 into the new values file. |
| 34 | + * Copy the [Helm](https://helm.sh/docs/intro/install/) command provided in the `Installation Instructions` and run it on in the cluster. |
| 35 | + |
| 36 | +## Verify Successful Upgrade |
74 | 37 | See [Verify your installation](cluster-install.md#verify-your-clusters-health) on how to verify a Run:ai cluster installation
|
75 | 38 |
|
76 | 39 |
|
|
0 commit comments