Add note warning against the :latest tag.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
Incorporating mgfritch's improvements.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
s/docker/podman/ -- as per mgfritch's suggestion

Signed-off-by: Zac Dover <zac.dover@gmail.com>
s/: latest/:latest/

Signed-off-by: Zac Dover <zac.dover@gmail.com>
s/image ids/image IDs/ -- as per Alex Settle's suggestion.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
Add note warning against the :latest tag.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
s/image ids/image IDs/ -- as per Alex Settle's suggestion.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
Linked to container page from cephadm install page.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
Clarified the note directing readers to the container documentation.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

diff --git a/doc/cephadm/install.rst b/doc/cephadm/install.rst
index aa54738a6af7317908e37eea1d7949295d443636..4459a70925c63fc073d0a48109cbd0645d073351 100644 (file)
--- a/doc/cephadm/install.rst
+++ b/doc/cephadm/install.rst
@@ -369,3 +369,6 @@ RADOS pool *nfs-ganesha* and namespace *nfs-ns*,::
 
 See :ref:`orchestrator-cli-placement-spec` for details of the placement specification.
 
+Deploying custom containers
+===========================
+It is also possible to choose different containers than the default containers to deploy Ceph. See :ref:`containers` for information about your options in this regard. 

diff --git a/doc/install/containers.rst b/doc/install/containers.rst
index c819c646dd0c59a9b4b0a5b051a444985703aba4..2c4efd00ef18f38cd34346d824f8e054693de06c 100644 (file)
--- a/doc/install/containers.rst
+++ b/doc/install/containers.rst
@@ -3,6 +3,19 @@
 Ceph Container Images
 =====================
 
+.. important::
+
+   Using the ``:latest`` tag is discouraged. If you use the ``:latest`` 
+   tag, there is no guarantee that the same image will be on each of 
+   your hosts.  Under these conditions, upgrades might not work 
+   properly. Remember that ``:latest`` is a relative tag, and a moving
+   target.
+
+   Instead of the ``:latest`` tag, use explicit tags or image IDs. For
+   example:
+
+   ``podman pull ceph/ceph:v15.2.0``
+
 Official Releases
 -----------------