]> git.proxmox.com Git - ceph.git/blobdiff - ceph/doc/cephadm/compatibility.rst
import ceph quincy 17.2.6
[ceph.git] / ceph / doc / cephadm / compatibility.rst
index 7c75b7445114b66b673456beeb4f1b4b44d5cef6..46ab62a62726f1661980f08f3a08850d210abcb3 100644 (file)
@@ -8,27 +8,40 @@ Compatibility and Stability
 Compatibility with Podman Versions
 ----------------------------------
 
-Podman and Ceph have different end-of-life strategies that
-might make it challenging to find compatible Podman and Ceph 
-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.
 
-Those versions are expected to work:
+This table shows which version pairs are expected to work or not work together:
 
 
-+-----------+---------------------------------------+
-|  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  |
-+-----------+-------+-------+-------+-------+-------+
++-----------+-----------------------------------------------+
+|  Ceph     |                 Podman                        |
++-----------+-------+-------+-------+-------+-------+-------+
+|           | 1.9   |  2.0  |  2.1  |  2.2  |  3.0  | > 3.0 |
++===========+=======+=======+=======+=======+=======+=======+
+| <= 15.2.5 | True  | False | False | False | False | False |
++-----------+-------+-------+-------+-------+-------+-------+
+| >= 15.2.6 | True  | True  | True  | False | False | False |
++-----------+-------+-------+-------+-------+-------+-------+
+| >= 16.2.1 | False | True  | True  | False | True  | True  |
++-----------+-------+-------+-------+-------+-------+-------+
+| >= 17.2.0 | False | True  | True  | False | True  | True  |
++-----------+-------+-------+-------+-------+-------+-------+
+
+.. note::
+
+  While not all podman versions have been actively tested against
+  all Ceph versions, there are no known issues with using podman
+  version 3.0 or greater with Ceph Quincy and later releases.
 
 .. warning:: 
-  Only podman versions that are 2.0.0 and higher work with Ceph Pacific, with the exception of podman version 2.2.1, which does not work with Ceph Pacific. kubic stable is known to work with Ceph Pacific, but it must be run with a newer kernel.
+
+   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:
@@ -36,19 +49,18 @@ Those versions are expected to work:
 Stability
 ---------
 
-Cephadm is actively in development. Please be aware that some
-functionality is still rough around the edges. Especially the 
-following components are working with cephadm, but the
-documentation is not as complete as we would like, and there may be some
-changes in the near future:
-
-- RGW
+Cephadm is relatively stable but new functionality is still being
+added and bugs are occasionally discovered. If issues are found, please
+open a tracker issue under the Orchestrator component (https://tracker.ceph.com/projects/orchestrator/issues)
 
-Cephadm support for the following features is still under development and may see breaking
-changes in future releases:
+Cephadm support remains under development for the following features:
 
-- Ingress
-- Cephadm exporter daemon
-- cephfs-mirror
+- ceph-exporter deployment
+- stretch mode integration
+- monitoring stack (moving towards prometheus service discover and providing TLS)
+- RGW multisite deployment support (requires lots of manual steps currently)
+- cephadm agent
 
-In case you encounter issues, see also :ref:`cephadm-pause`.
+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.