|
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 |
5 | 6 |
|
6 | | -To find the Run:ai cluster version, run: |
7 | | - |
8 | | -``` |
9 | | -helm list -n runai -f runai-cluster |
10 | | -``` |
11 | | - |
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 | 7 | * In the Run:ai interface, navigate to `Clusters`. |
18 | 8 | * Select the cluster you want to upgrade. |
19 | 9 | * Click on `Get Installation instructions`. |
20 | | -* Choose the `Run:ai version` to be installed on the Cluster. |
| 10 | +* Optional: Choose the `Run:ai version` to upgrade to (default: latest) |
21 | 11 | * Press `Continue`. |
22 | 12 | * Copy the [Helm](https://helm.sh/docs/intro/install/) command provided in the `Installation Instructions` and run it on in the cluster. |
23 | 13 | * In the case of a failure, refer to the [Installation troubleshooting guide](../../troubleshooting/troubleshooting.md#installation). |
24 | 14 |
|
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 | | - ``` |
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 |
73 | | -
|
| 15 | +## Verify Successful Upgrade |
74 | 16 | See [Verify your installation](cluster-install.md#verify-your-clusters-health) on how to verify a Run:ai cluster installation |
75 | 17 |
|
76 | 18 |
|
|
0 commit comments