From 6ae2421968adfcae9c6d20f7e43580593399361a Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Wed, 31 Mar 2021 01:31:28 +1000 Subject: [PATCH] doc/cephadm: add podman version note to install This PR adds a note to the cephadm installation guide that informs users that only podman version 2.0.0 and higher work with Ceph, with the exception of podman version 2.2.1, which does not work with Ceph. There is also a note regarding kubic stable 3.0.1 working, but only with newer kernels. Signed-off-by: Zac Dover (cherry picked from commit 3043aaaa8a880107fab9a755df948c0e9e8db358) --- doc/cephadm/compatibility.rst | 6 ++++++ doc/cephadm/install.rst | 7 +++++++ 2 files changed, 13 insertions(+) diff --git a/doc/cephadm/compatibility.rst b/doc/cephadm/compatibility.rst index a616506def0fa..7c75b7445114b 100644 --- a/doc/cephadm/compatibility.rst +++ b/doc/cephadm/compatibility.rst @@ -3,6 +3,8 @@ Compatibility and Stability =========================== +.. _cephadm-compatibility-with-podman: + Compatibility with Podman Versions ---------------------------------- @@ -25,6 +27,10 @@ Those versions are expected to work: | >= 16.2.1 | False | True | True | False | True | +-----------+-------+-------+-------+-------+-------+ +.. 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. + + .. _cephadm-stability: Stability diff --git a/doc/cephadm/install.rst b/doc/cephadm/install.rst index 7ea78b3d44259..7c9f6546757e4 100644 --- a/doc/cephadm/install.rst +++ b/doc/cephadm/install.rst @@ -23,6 +23,13 @@ Requirements Any modern Linux distribution should be sufficient. Dependencies are installed automatically by the bootstrap process below. +See the section :ref:`Compatibility With Podman +Versions` for a table of Ceph versions that +are compatible with Podman. Not every version of Podman is compatible with +Ceph. + + + .. _get-cephadm: Install cephadm -- 2.39.5