summaryrefslogtreecommitdiffstats
path: root/doc/cephadm/compatibility.rst
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doc/cephadm/compatibility.rst58
1 files changed, 58 insertions, 0 deletions
diff --git a/doc/cephadm/compatibility.rst b/doc/cephadm/compatibility.rst
new file mode 100644
index 000000000..7d9c763bb
--- /dev/null
+++ b/doc/cephadm/compatibility.rst
@@ -0,0 +1,58 @@
+
+===========================
+Compatibility and Stability
+===========================
+
+.. _cephadm-compatibility-with-podman:
+
+Compatibility with Podman Versions
+----------------------------------
+
+Podman and Ceph have different end-of-life strategies. This means that care
+must be taken in finding a version of Podman that is compatible with Ceph.
+
+These versions are expected to work:
+
+
++-----------+---------------------------------------+
+| Ceph | Podman |
++-----------+-------+-------+-------+-------+-------+
+| | 1.9 | 2.0 | 2.1 | 2.2 | 3.0 |
++===========+=======+=======+=======+=======+=======+
+| <= 15.2.5 | True | False | False | False | False |
++-----------+-------+-------+-------+-------+-------+
+| >= 15.2.6 | True | True | True | False | False |
++-----------+-------+-------+-------+-------+-------+
+| >= 16.2.1 | False | True | True | False | True |
++-----------+-------+-------+-------+-------+-------+
+
+.. warning::
+
+ To use Podman with Ceph Pacific, you must use **a version of Podman that
+ is 2.0.0 or higher**. However, **Podman version 2.2.1 does not work with
+ Ceph Pacific**.
+
+ "Kubic stable" is known to work with Ceph Pacific, but it must be run
+ with a newer kernel.
+
+
+.. _cephadm-stability:
+
+Stability
+---------
+
+Cephadm is under development. Some functionality is incomplete. Be aware
+that some of the components of Ceph may not work perfectly with cephadm.
+These include:
+
+- RGW
+
+Cephadm support remains under development for the following features:
+
+- Ingress
+- Cephadm exporter daemon
+- cephfs-mirror
+
+If a cephadm command fails or a service stops running properly, see
+:ref:`cephadm-pause` for instructions on how to pause the Ceph cluster's
+background activity and how to disable cephadm.