diff --git a/doc/source/configuration/block-storage/drivers/ceph-rbd-volume-driver.rst b/doc/source/configuration/block-storage/drivers/ceph-rbd-volume-driver.rst index 78c564b9ab9..948cbba0481 100644 --- a/doc/source/configuration/block-storage/drivers/ceph-rbd-volume-driver.rst +++ b/doc/source/configuration/block-storage/drivers/ceph-rbd-volume-driver.rst @@ -18,6 +18,27 @@ public or private clouds. Ceph architecture +.. note:: + **Supported Ceph versions** + + The current `release cycle model for Ceph + `_ + targets a new release yearly on 1 March, with there being at most + two active stable releases at any time. + + For a given OpenStack release, *Cinder supports the current Ceph + active stable releases plus the two prior releases.* + + For example, at the time of the OpenStack Wallaby release in + April 2021, the Ceph active supported releases are Pacific and + Octopus. The Cinder Wallaby release therefore supports Ceph + Pacific, Octopus, Nautilus, and Mimic. + + Additionally, it is expected that the version of the Ceph client + available to Cinder or any of its associated libraries (os-brick, + cinderlib) is aligned with the Ceph server version. Mixing server + and client versions is *unsupported* and may lead to anomalous behavior. + RADOS ~~~~~ diff --git a/releasenotes/notes/announce-ceph-min-version-4eddb0def1c39928.yaml b/releasenotes/notes/announce-ceph-min-version-4eddb0def1c39928.yaml new file mode 100644 index 00000000000..bb25933a7e4 --- /dev/null +++ b/releasenotes/notes/announce-ceph-min-version-4eddb0def1c39928.yaml @@ -0,0 +1,32 @@ +--- +upgrade: + - | + RBD driver: Prior to this release, the Cinder project did not have a + statement concerning what versions of Ceph are supported by Cinder. + We hereby announce that: + + * For a given OpenStack release, Cinder supports the current Ceph + active stable releases plus the two prior releases. + * For any OpenStack release, it is expected that the versions of + the Ceph client and server are in alignment. + + The `Ceph RADOS Block Device (RBD) + `__ + driver documentation has been updated to reflect + this policy and explains it in more detail. +other: + - | + **Supported Ceph versions** + + The Cinder project wishes to clarify its policy concerning what versions + of Ceph are supported by Cinder. + + * For a given OpenStack release, Cinder supports the current Ceph + active stable releases plus the two prior releases. + * For any OpenStack release, it is expected that the versions of + the Ceph client and server are in alignment. + + The `Ceph RADOS Block Device (RBD) + `__ + driver documentation has been updated to reflect + this policy and explains it in more detail.