openstack/cinder
Code Issues Proposed changes

doc: restrict supported Ceph versions

Browse Source 
As discussed at the PTG [0] and subsequent Cinder meetings [1],
set a minimum supported version of Ceph.  Also specify that we
expect the Ceph client and server versions to be in alignment.

[0] https://wiki.openstack.org/wiki/CinderWallabyPTGSummary#Ceph:_Minimum_supported_version
[1] http://eavesdrop.openstack.org/meetings/cinder/2020/cinder.2020-11-11-14.00.log.html#l-202

Change-Id: Ifd4cf76158350f60f84e3066ff41cc6ac5c2a3c3
This commit is contained in:
Brian Rosmaita 2020-11-12 18:42:37 -05:00
parent 4f0ce33d0a
commit 2f5179147c
2 changed files with 53 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/source/configuration/block-storage/drivers/ceph-rbd-volume-driver.rst
View File

@ -18,6 +18,27 @@ public or private clouds.
Ceph architecture Ceph architecture
.. note::
**Supported Ceph versions**
The current `release cycle model for Ceph
<https://docs.ceph.com/en/latest/releases/general/>`_
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 RADOS
~~~~~ ~~~~~

32
releasenotes/notes/announce-ceph-min-version-4eddb0def1c39928.yaml Normal file
View File

@ -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)
<https://docs.openstack.org/cinder/latest/configuration/block-storage/drivers/ceph-rbd-volume-driver.html>`__
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)
<https://docs.openstack.org/cinder/latest/configuration/block-storage/drivers/ceph-rbd-volume-driver.html>`__
driver documentation has been updated to reflect
this policy and explains it in more detail.