Deploy Zun with Cinder Ceph support

Enables zun to access cinder volumes when cinder is configured to use
external ceph.
Copies ceph config file and ceph cinder keyring to /etc/ceph in
zun_compute container.

Closes-Bug: 1848934
Change-Id: Ie56868d5e9ed37a9274b8cbe65895f3634b895c8

1 files changed, 27 insertions, 0 deletions

diff --git a/doc/source/reference/storage/external-ceph-guide.rst b/doc/source/reference/storage/external-ceph-guide.rst
index ca5c87701..fe47442f4 100644
--- a/doc/source/reference/storage/external-ceph-guide.rst
+++ b/doc/source/reference/storage/external-ceph-guide.rst
@@ -138,6 +138,23 @@ Nova must also be configured to allow access to Cinder volumes:
 
    * ``/etc/kolla/config/nova/<ceph_cinder_keyring>``
 
+If ``zun`` is enabled, and you wish to use cinder volumes with zun,
+it must also be configured to allow access to Cinder volumes:
+
+#. Enable Cinder Ceph backend for Zun in ``globals.yml``:
+
+   .. code-block:: yaml
+
+      zun_configure_for_cinder_ceph: "yes"
+
+#. Copy Ceph configuration file to:
+   * ``/etc/kolla/config/zun/zun-compute/ceph.conf``
+
+#. Copy Ceph keyring file(s) to:
+
+   * ``/etc/kolla/config/zun/zun-compute/<ceph_cinder_keyring>``
+
+
 Nova
 ----
 
@@ -303,3 +320,13 @@ HTTPS (443) port will be used. For example:
 
 The HAProxy frontend port is defined via ``ceph_rgw_port``, and defaults to
 6780.
+
+Cephadm and Ceph Client Version
+===============================
+When configuring Zun with Cinder volumes, kolla-ansible installs some
+Ceph client packages on zun-compute hosts. You can set the version
+of the Ceph packages installed by,
+
+#. Configuring Ceph version details in ``/etc/kolla/globals.yml``:
+
+   * ``ceph_version`` (default: ``pacific``)