diff --git a/README.md b/README.md index 954f3d9172e3..989af29f601f 100644 --- a/README.md +++ b/README.md @@ -8,18 +8,18 @@ Card](https://goreportcard.com/badge/github.com/ceph/ceph-csi)](https://goreport [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/5940/badge)](https://bestpractices.coreinfrastructure.org/projects/5940) - [Ceph CSI](#ceph-csi) - - [Overview](#overview) - - [Project status](#project-status) - - [Known to work CO platforms](#known-to-work-co-platforms) - - [Support Matrix](#support-matrix) - - [Ceph-CSI features and available versions](#ceph-csi-features-and-available-versions) - - [CSI spec and Kubernetes version compatibility](#csi-spec-and-kubernetes-version-compatibility) - - [Ceph CSI Container images and release compatibility](#ceph-csi-container-images-and-release-compatibility) - - [Contributing to this repo](#contributing-to-this-repo) - - [Troubleshooting](#troubleshooting) - - [Weekly Bug Triage call](#weekly-bug-triage-call) - - [Dev standup](#dev-standup) - - [Contact](#contact) + - [Overview](#overview) + - [Project status](#project-status) + - [Known to work CO platforms](#known-to-work-co-platforms) + - [Support Matrix](#support-matrix) + - [Ceph-CSI features and available versions](#ceph-csi-features-and-available-versions) + - [CSI spec and Kubernetes version compatibility](#csi-spec-and-kubernetes-version-compatibility) + - [Ceph CSI Container images and release compatibility](#ceph-csi-container-images-and-release-compatibility) + - [Contributing to this repo](#contributing-to-this-repo) + - [Troubleshooting](#troubleshooting) + - [Weekly Bug Triage call](#weekly-bug-triage-call) + - [Dev standup](#dev-standup) + - [Contact](#contact) This repo contains the Ceph [Container Storage Interface (CSI)](https://github.com/container-storage-interface/) @@ -56,10 +56,8 @@ environments. | Ceph CSI Version | Container Orchestrator Name | Version Tested| | -----------------| --------------------------- | --------------| +| v3.8.0 | Kubernetes | v1.25, v1.26, v1.27| | v3.8.0 | Kubernetes | v1.24, v1.25, v1.26, v1.27| -| v3.7.2 | Kubernetes | v1.22, v1.23, v1.24| -| v3.7.1 | Kubernetes | v1.22, v1.23, v1.24| -| v3.7.0 | Kubernetes | v1.22, v1.23, v1.24| There is work in progress to make this CO-independent and thus support other orchestration environments (Nomad, Mesos..etc). @@ -69,8 +67,8 @@ NOTE: The supported window of Ceph CSI versions is "N.(x-1)": (N (Latest major release) . (x (Latest minor release) - 1)). -For example, if the Ceph CSI latest major version is `3.8.0` today, support is -provided for the versions above `3.7.0`. If users are running an unsupported +For example, if the Ceph CSI latest major version is `3.9.0` today, support is +provided for the versions above `3.9.0`. If users are running an unsupported Ceph CSI version, they will be asked to upgrade when requesting support. ## Support Matrix @@ -130,13 +128,14 @@ in the Kubernetes documentation. | Ceph CSI Release/Branch | Container image name | Image Tag | | ----------------------- | ---------------------------- | --------- | | devel (Branch) | quay.io/cephcsi/cephcsi | canary | +| v3.9.0 (Release) | quay.io/cephcsi/cephcsi | v3.9.0 | | 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 | | Deprecated Ceph CSI Release/Branch | Container image name | Image Tag | | ----------------------- | --------------------------------| --------- | +| 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 | | v3.6.1 (Release) | quay.io/cephcsi/cephcsi | v3.6.1 | | v3.6.0 (Release) | quay.io/cephcsi/cephcsi | v3.6.0 | | v3.5.1 (Release) | quay.io/cephcsi/cephcsi | v3.5.1 | diff --git a/docs/ceph-csi-upgrade.md b/docs/ceph-csi-upgrade.md index 491e8aefd7af..0c0c0e514936 100644 --- a/docs/ceph-csi-upgrade.md +++ b/docs/ceph-csi-upgrade.md @@ -1,40 +1,40 @@ # Ceph-csi Upgrade - [Ceph-csi Upgrade](#ceph-csi-upgrade) - - [Pre-upgrade considerations](#pre-upgrade-considerations) - - [Snapshot-controller and snapshot crd](#snapshot-controller-and-snapshot-crd) - - [Snapshot API version support matrix](#snapshot-api-version-support-matrix) - - [Upgrading from v3.2 to v3.3](#upgrading-from-v32-to-v33) - - [Upgrading from v3.3 to v3.4](#upgrading-from-v33-to-v34) - - [Upgrading from v3.4 to v3.5](#upgrading-from-v34-to-v35) - - [Upgrading from v3.5 to v3.6](#upgrading-from-v35-to-v36) - - [Upgrading from v3.6 to v3.7](#upgrading-from-v36-to-v37) - - [Upgrading from v3.7 to v3.8](#upgrading-from-v37-to-v38) - - [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) - - [1.2 Update the CephFS Provisioner deployment](#12-update-the-cephfs-provisioner-deployment) - - [2. Upgrade CephFS Nodeplugin resources](#2-upgrade-cephfs-nodeplugin-resources) - - [2.1 Update the CephFS Nodeplugin RBAC](#21-update-the-cephfs-nodeplugin-rbac) - - [2.2 Update the CephFS Nodeplugin daemonset](#22-update-the-cephfs-nodeplugin-daemonset) - - [2.3 Manual deletion of CephFS Nodeplugin daemonset pods](#23-manual-deletion-of-cephfs-nodeplugin-daemonset-pods) - - [Delete removed CephFS PSP, Role and RoleBinding](#delete-removed-cephfs-psp-role-and-rolebinding) - - [Upgrading RBD](#upgrading-rbd) - - [3. Upgrade RBD Provisioner resources](#3-upgrade-rbd-provisioner-resources) - - [3.1 Update the RBD Provisioner RBAC](#31-update-the-rbd-provisioner-rbac) - - [3.2 Update the RBD Provisioner deployment](#32-update-the-rbd-provisioner-deployment) - - [4. Upgrade RBD Nodeplugin resources](#4-upgrade-rbd-nodeplugin-resources) - - [4.1 Update the RBD Nodeplugin RBAC](#41-update-the-rbd-nodeplugin-rbac) - - [4.2 Update the RBD Nodeplugin daemonset](#42-update-the-rbd-nodeplugin-daemonset) - - [Delete removed RBD PSP, Role and RoleBinding](#delete-removed-rbd-psp-role-and-rolebinding) - - [Upgrading NFS](#upgrading-nfs) - - [5. Upgrade NFS Provisioner resources](#5-upgrade-nfs-provisioner-resources) - - [5.1 Update the NFS Provisioner RBAC](#51-update-the-nfs-provisioner-rbac) - - [5.2 Update the NFS Provisioner deployment](#52-update-the-nfs-provisioner-deployment) - - [6. Upgrade NFS Nodeplugin resources](#6-upgrade-nfs-nodeplugin-resources) - - [6.1 Update the NFS Nodeplugin RBAC](#61-update-the-nfs-nodeplugin-rbac) - - [6.2 Update the NFS Nodeplugin daemonset](#62-update-the-nfs-nodeplugin-daemonset) - - [CSI Sidecar containers consideration](#csi-sidecar-containers-consideration) + - [Pre-upgrade considerations](#pre-upgrade-considerations) + - [Snapshot-controller and snapshot crd](#snapshot-controller-and-snapshot-crd) + - [Snapshot API version support matrix](#snapshot-api-version-support-matrix) + - [Upgrading from v3.2 to v3.3](#upgrading-from-v32-to-v33) + - [Upgrading from v3.3 to v3.4](#upgrading-from-v33-to-v34) + - [Upgrading from v3.4 to v3.5](#upgrading-from-v34-to-v35) + - [Upgrading from v3.5 to v3.6](#upgrading-from-v35-to-v36) + - [Upgrading from v3.6 to v3.7](#upgrading-from-v36-to-v37) + - [Upgrading from v3.7 to v3.8](#upgrading-from-v37-to-v38) + - [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) + - [1.2 Update the CephFS Provisioner deployment](#12-update-the-cephfs-provisioner-deployment) + - [2. Upgrade CephFS Nodeplugin resources](#2-upgrade-cephfs-nodeplugin-resources) + - [2.1 Update the CephFS Nodeplugin RBAC](#21-update-the-cephfs-nodeplugin-rbac) + - [2.2 Update the CephFS Nodeplugin daemonset](#22-update-the-cephfs-nodeplugin-daemonset) + - [2.3 Manual deletion of CephFS Nodeplugin daemonset pods](#23-manual-deletion-of-cephfs-nodeplugin-daemonset-pods) + - [Delete removed CephFS PSP, Role and RoleBinding](#delete-removed-cephfs-psp-role-and-rolebinding) + - [Upgrading RBD](#upgrading-rbd) + - [3. Upgrade RBD Provisioner resources](#3-upgrade-rbd-provisioner-resources) + - [3.1 Update the RBD Provisioner RBAC](#31-update-the-rbd-provisioner-rbac) + - [3.2 Update the RBD Provisioner deployment](#32-update-the-rbd-provisioner-deployment) + - [4. Upgrade RBD Nodeplugin resources](#4-upgrade-rbd-nodeplugin-resources) + - [4.1 Update the RBD Nodeplugin RBAC](#41-update-the-rbd-nodeplugin-rbac) + - [4.2 Update the RBD Nodeplugin daemonset](#42-update-the-rbd-nodeplugin-daemonset) + - [Delete removed RBD PSP, Role and RoleBinding](#delete-removed-rbd-psp-role-and-rolebinding) + - [Upgrading NFS](#upgrading-nfs) + - [5. Upgrade NFS Provisioner resources](#5-upgrade-nfs-provisioner-resources) + - [5.1 Update the NFS Provisioner RBAC](#51-update-the-nfs-provisioner-rbac) + - [5.2 Update the NFS Provisioner deployment](#52-update-the-nfs-provisioner-deployment) + - [6. Upgrade NFS Nodeplugin resources](#6-upgrade-nfs-nodeplugin-resources) + - [6.1 Update the NFS Nodeplugin RBAC](#61-update-the-nfs-nodeplugin-rbac) + - [6.2 Update the NFS Nodeplugin daemonset](#62-update-the-nfs-nodeplugin-daemonset) + - [CSI Sidecar containers consideration](#csi-sidecar-containers-consideration) ## Pre-upgrade considerations @@ -232,10 +232,10 @@ For each node: - Drain your application pods from the node - Delete the CSI driver pods on the node - - The pods to delete will be named with a csi-cephfsplugin prefix and have a + - The pods to delete will be named with a csi-cephfsplugin prefix and have a random suffix on each node. However, no need to delete the provisioner pods: csi-cephfsplugin-provisioner-* . - - The pod deletion causes the pods to be restarted and updated automatically + - The pod deletion causes the pods to be restarted and updated automatically on the node. #### Delete removed CephFS PSP, Role and RoleBinding