Skip to content

Commit e161e4c

Browse files
committed
remove 2.11 and 2.7 2.8 fro mcontrol plane upgrade
1 parent eab603a commit e161e4c

File tree

2 files changed

+6
-42
lines changed

2 files changed

+6
-42
lines changed

docs/admin/runai-setup/self-hosted/k8s/upgrade.md

Lines changed: 3 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -36,33 +36,7 @@ If you are installing an air-gapped version of Run:ai, The Run:ai tar file conta
3636

3737
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.
3838

39-
### Upgrade from version 2.7 or 2.8
40-
41-
Before upgrading the control plane, run:
42-
43-
``` bash
44-
POSTGRES_PV=$(kubectl get pvc pvc-postgresql -n runai-backend -o jsonpath='{.spec.volumeName}')
45-
THANOS_PV=$(kubectl get pvc pvc-thanos-receive -n runai-backend -o jsonpath='{.spec.volumeName}')
46-
kubectl patch pv $POSTGRES_PV $THANOS_PV -p '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'
47-
48-
kubectl delete secret -n runai-backend runai-backend-postgresql
49-
kubectl delete sts -n runai-backend keycloak runai-backend-postgresql
50-
```
51-
52-
Before version 2.9, the Run:ai installation, by default, included NGINX. It was possible to disable this installation. If NGINX is enabled in your current installation, as per the default, run the following 2 lines:
53-
54-
``` bash
55-
kubectl delete ValidatingWebhookConfiguration runai-backend-nginx-ingress-admission
56-
kubectl delete ingressclass nginx
57-
```
58-
(If Run:ai configuration has previously disabled NGINX installation then these lines should not be run).
59-
60-
Next, install NGINX as described [here](../../cluster-setup/cluster-prerequisites.md#ingress-controller)
61-
62-
Then create a TLS secret and upgrade the control plane as described in the [control plane installation](backend.md). Before upgrading, find customizations and merge them as discussed below.
63-
64-
65-
### Upgrade from version 2.9, 2.10 , or 2.11
39+
### Upgrade from version 2.9
6640

6741
Two significant changes to the control-plane installation have happened with version 2.12: _PVC ownership_ and _installation customization_.
6842

@@ -114,7 +88,7 @@ The Run:ai control-plane installation has been rewritten and is no longer using
11488
helm upgrade runai-backend control-plane-<NEW-VERSION>.tgz -n runai-backend -f runai_control_plane_values.yaml --reset-then-reuse-values
11589
```
11690

117-
### Upgrade from version 2.7, 2.8, 2.9, or 2.11
91+
### Upgrade from version 2.9
11892

11993
* Create a `tls secret` as described in the [control plane installation](backend.md).
12094
* Upgrade the control plane as described in the [control plane installation](backend.md). During the upgrade, you must tell the installation __not__ to create the two PVCs:
@@ -141,4 +115,5 @@ The Run:ai control-plane installation has been rewritten and is no longer using
141115
```
142116

143117
## Upgrade Cluster
118+
144119
To upgrade the cluster follow the instructions [here](../../cluster-setup/cluster-upgrade.md).

docs/admin/runai-setup/self-hosted/ocp/upgrade.md

Lines changed: 3 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,19 @@
22
title: Upgrade self-hosted OpenShift installation
33
---
44
# Upgrade Run:ai
5-
6-
75
!!! Important
86
Run:ai data is stored in Kubernetes persistent volumes (PVs). Prior to Run:ai 2.12, PVs are owned by the Run:ai installation. Thus, uninstalling the `runai-backend` helm chart may delete all of your data.
97

108
From version 2.12 forward, PVs are owned the customer and are independent of the Run:ai installation. As such, they are subject to storage class [reclaim](https://kubernetes.io/docs/concepts/storage/storage-classes/#reclaim-policy){target=_blank} policy.
119

1210
## Preparations
13-
1411
### Helm
1512
Run:ai requires [Helm](https://helm.sh/){target=_blank} 3.14 or later.
1613
Before you continue, validate your installed helm client version.
1714
To install or upgrade Helm, see [Installing Helm](https://helm.sh/docs/intro/install/){target=_blank}.
1815
If you are installing an air-gapped version of Run:ai, The Run:ai tar file contains the helm binary.
1916

2017
### Software files
21-
2218
=== "Connected"
2319
Run the helm command below:
2420

@@ -32,11 +28,8 @@ If you are installing an air-gapped version of Run:ai, The Run:ai tar file conta
3228
* Upload the images as described [here](preparations.md#software-artifacts).
3329

3430
## Before upgrade
35-
3631
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.
3732

38-
### Upgrade from version 2.7 or 2.8
39-
4033
Before upgrading the control plane, run:
4134

4235
``` bash
@@ -49,11 +42,10 @@ kubectl delete sts -n runai-backend keycloak runai-backend-postgresql
4942

5043
Then upgrade the control plane as described [below](#upgrade-control-plane). Before upgrading, find customizations and merge them as discussed below.
5144

52-
### Upgrade from version 2.9, 2.10 or 2.11
53-
45+
### Upgrade from version 2.9
5446
Two significant changes to the control-plane installation have happened with version 2.12: _PVC ownership_ and _installation customization_.
55-
#### PVC ownership
5647

48+
#### PVC ownership
5749
Run:ai will no longer directly create the PVCs that store Run:ai data (metrics and database). Instead, going forward,
5850

5951
* Run:ai requires a Kubernetes storage class to be installed.
@@ -68,17 +60,14 @@ kubectl patch pvc -n runai-backend pvc-postgresql -p '{"metadata": {"annotation
6860
```
6961

7062
#### Installation customization
71-
7263
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:
7364

7465
* 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.
7566
* Search for the customizations you found in the [optional configurations](./backend.md#additional-runai-configurations-optional) table and add them in the new format.
7667

7768

7869
## Upgrade Control Plane
79-
8070
### Upgrade from version 2.13, or later
81-
8271
=== "Connected"
8372

8473
``` bash
@@ -92,7 +81,7 @@ The Run:ai control-plane installation has been rewritten and is no longer using
9281
helm upgrade runai-backend control-plane-<NEW-VERSION>.tgz -n runai-backend -f runai_control_plane_values.yaml --reset-then-reuse-values
9382
```
9483

95-
### Upgrade from version 2.7, 2.8, 2.9, or 2.11
84+
### Upgrade from version 2.9
9685

9786
=== "Connected"
9887

0 commit comments

Comments
 (0)