From 4afb6d8af794857c8aaef16f7782f930e00c15c3 Mon Sep 17 00:00:00 2001 From: Rakshith R Date: Mon, 27 Nov 2023 15:14:19 +0530 Subject: [PATCH 1/2] doc: update README for v3.10.0 release This commit updates README to deprecate 3.8.x release and pin latest release to v3.10.0 Signed-off-by: Rakshith R --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 214dd821f9e..618a87ef52d 100644 --- a/README.md +++ b/README.md @@ -54,11 +54,10 @@ Status: **GA** Ceph CSI drivers are currently developed and tested **exclusively** in Kubernetes environments. -| Ceph CSI Version | Container Orchestrator Name | Version Tested| -| -----------------| --------------------------- | --------------| -| v3.9.0 | Kubernetes | v1.25, v1.26, v1.27| -| v3.8.1 | Kubernetes | v1.25, v1.26, v1.27| -| v3.8.0 | Kubernetes | v1.24, v1.25, v1.26, v1.27| +| Ceph CSI Version | Container Orchestrator Name | Version Tested | +| -----------------| --------------------------- | -------------------| +| v3.10.0 | Kubernetes | v1.26, v1.27, v1.28| +| v3.9.0 | Kubernetes | v1.25, v1.26, v1.27| There is work in progress to make this CO-independent and thus support other orchestration environments (Nomad, Mesos..etc). @@ -129,12 +128,13 @@ in the Kubernetes documentation. | Ceph CSI Release/Branch | Container image name | Image Tag | | ----------------------- | ---------------------------- | --------- | | devel (Branch) | quay.io/cephcsi/cephcsi | canary | +| v3.10.0 (Release) | quay.io/cephcsi/cephcsi | v3.10.0 | | v3.9.0 (Release) | quay.io/cephcsi/cephcsi | v3.9.0 | -| v3.8.1 (Release) | quay.io/cephcsi/cephcsi | v3.8.1 | -| v3.8.0 (Release) | quay.io/cephcsi/cephcsi | v3.8.0 | | Deprecated Ceph CSI Release/Branch | Container image name | Image Tag | | ----------------------- | --------------------------------| --------- | +| v3.8.1 (Release) | quay.io/cephcsi/cephcsi | v3.8.1 | +| v3.8.0 (Release) | quay.io/cephcsi/cephcsi | v3.8.0 | | v3.7.2 (Release) | quay.io/cephcsi/cephcsi | v3.7.2 | | v3.7.1 (Release) | quay.io/cephcsi/cephcsi | v3.7.1 | | v3.7.0 (Release) | quay.io/cephcsi/cephcsi | v3.7.0 | From c4fbd4a040b2c02c771068cc0e11326b1e6baafe Mon Sep 17 00:00:00 2001 From: Rakshith R Date: Mon, 27 Nov 2023 15:15:12 +0530 Subject: [PATCH 2/2] doc: add steps for upgrading from 3.9 to 3.10 This commit adds steps for upgrading from 3.9 to 3.10. Signed-off-by: Rakshith R --- docs/ceph-csi-upgrade.md | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/docs/ceph-csi-upgrade.md b/docs/ceph-csi-upgrade.md index 48fbf7b09b7..f37890e3f8a 100644 --- a/docs/ceph-csi-upgrade.md +++ b/docs/ceph-csi-upgrade.md @@ -4,7 +4,7 @@ - [Pre-upgrade considerations](#pre-upgrade-considerations) - [Snapshot-controller and snapshot crd](#snapshot-controller-and-snapshot-crd) - [Upgrading from previous releases](#upgrading-from-previous-releases) - - [Upgrading from v3.8 to v3.9](#upgrading-from-v38-to-v39) + - [Upgrading from v3.9 to v3.10](#upgrading-from-v39-to-v310) - [Upgrading CephFS](#upgrading-cephfs) - [1. Upgrade CephFS Provisioner resources](#1-upgrade-cephfs-provisioner-resources) - [1.1 Update the CephFS Provisioner RBAC](#11-update-the-cephfs-provisioner-rbac) @@ -49,7 +49,7 @@ To avoid this issue in future upgrades, we recommend that you do not use the fuse client as of now. This guide will walk you through the steps to upgrade the software in a cluster -from v3.8 to v3.9 +from v3.9 to v3.10 ### Snapshot-controller and snapshot crd @@ -75,8 +75,10 @@ To upgrade from previous releases, refer to the following: to upgrade from cephcsi v3.6 to v3.7 - [upgrade-from-v3.7-v3.8](https://github.com/ceph/ceph-csi/blob/v3.8.0/docs/ceph-csi-upgrade.md) to upgrade from cephcsi v3.7 to v3.8 +- [upgrade-from-v3.8-v3.9](https://github.com/ceph/ceph-csi/blob/v3.9.0/docs/ceph-csi-upgrade.md) + to upgrade from cephcsi v3.8 to v3.9 -## Upgrading from v3.8 to v3.9 +## Upgrading from v3.9 to v3.10 **Ceph-csi releases from devel are expressly unsupported.** It is strongly recommended that you use [official @@ -86,15 +88,19 @@ that will not be supported in the official releases. Builds from the devel branch can have functionality changed and even removed at any time without compatibility support and without prior notice. -**Also, we do not recommend any direct upgrades to 3.9 except from 3.8 to 3.9.** -For example, upgrading from 3.7 to 3.9 is not recommended. +**Also, we do not recommend any direct upgrades to 3.10 except from 3.9 to 3.10.** +For example, upgrading from 3.8 to 3.10 is not recommended. -git checkout v3.9.0 tag +**Refer to the Breaking Changes Section in the +[release notes](https://github.com/ceph/ceph-csi/releases/tag/v3.10.0) before +proceeding further.** + +git checkout v3.10.0 tag ```bash git clone https://github.com/ceph/ceph-csi.git cd ./ceph-csi -git checkout v3.9.0 +git checkout v3.10.0 ``` ```console @@ -216,7 +222,7 @@ For each node: - The pod deletion causes the pods to be restarted and updated automatically on the node. -we have successfully upgraded cephfs csi from v3.8 to v3.9 +we have successfully upgraded cephfs csi from v3.9 to v3.10 ### Upgrading RBD @@ -280,7 +286,7 @@ daemonset.apps/csi-rbdplugin configured service/csi-metrics-rbdplugin configured ``` -we have successfully upgraded RBD csi from v3.8 to v3.9 +we have successfully upgraded RBD csi from v3.9 to v3.10 ### Upgrading NFS @@ -342,7 +348,7 @@ daemonset.apps/csi-nfsplugin configured service/csi-metrics-nfsplugin configured ``` -we have successfully upgraded nfs csi from v3.8 to v3.9 +we have successfully upgraded nfs csi from v3.9 to v3.10 ### CSI Sidecar containers consideration