Support openstack with ceph-backed ROOK deployment (r10,osdsR10)

Add rook-ceph back to openstack documentation.

Changes made in https://review.opendev.org/c/starlingx/docs/+/945526 were reverted.

Change-Id: Id9a4fe0c10164963ec5d68a03ef0a0881c4b641d
Signed-off-by: Elisamara Aoki Gonçalves <elisamaraaoki.goncalves@windriver.com>

doc/source/deploy_install_guides/release/bare_metal/aio_duplex_install_kubernetes.rst

@@ -934,8 +934,6 @@ A persistent storage backend is required if your application requires |PVCs|.
 
        The StarlingX OpenStack application **requires** |PVCs|.
 
-.. only:: starlingx or platform
-
 There are two options for persistent storage backend: the host-based Ceph
 solution and the Rook container-based Ceph solution.
 
@@ -944,11 +942,6 @@ A persistent storage backend is required if your application requires |PVCs|.
    Host-based Ceph will be deprecated and removed in an upcoming release.
    Adoption of Rook-Ceph is recommended for new deployments.
 
-.. warning::
-
-   Currently |prod-os| does not support rook-ceph. If you plan on using
-   |prod-os|, choose host-based Ceph.
-
 For host-based Ceph:
 
 #. Initialize with add ceph backend:
@@ -971,7 +964,6 @@ For host-based Ceph:
       # List OSD storage devices
       ~(keystone_admin)$ system host-stor-list controller-0
 
-.. only:: starlingx or platform
 
 For Rook-Ceph:
 
@@ -1468,7 +1460,6 @@ For host-based Ceph:
       # List OSD storage devices
       ~(keystone_admin)$ system host-stor-list controller-1
 
-.. only:: starlingx or platform
 
 For Rook-Ceph:
 
@@ -1492,7 +1483,6 @@ Controller-1 will reboot in order to apply configuration changes and come into
 service. This can take 5-10 minutes, depending on the performance of the host
 machine.
 
-.. only:: starlingx or platform
 
 -------------------------------------------------------------------
 If configuring Rook Ceph Storage Backend, configure the environment

doc/source/deploy_install_guides/release/bare_metal/aio_simplex_install_kubernetes.rst

@@ -855,8 +855,6 @@ A persistent storage backend is required if your application requires
 
       The StarlingX OpenStack application **requires** |PVCs|.
 
-.. only:: starlingx or platform
-
 There are two options for persistent storage backend: the host-based Ceph
 solution and the Rook container-based Ceph solution.
 
@@ -865,10 +863,6 @@ A persistent storage backend is required if your application requires
    Host-based Ceph will be deprecated and removed in an upcoming release.
    Adoption of Rook-Ceph is recommended for new deployments.
 
-.. warning::
-
-   Currently |prod-os| does not support rook-ceph. If you plan on using
-   |prod-os|, choose host-based Ceph.
 
 For host-based Ceph:
 
@@ -892,7 +886,6 @@ For host-based Ceph:
       # List OSD storage devices
       ~(keystone_admin)$ system host-stor-list controller-0
 
-.. only:: starlingx or platform
 
 For Rook-Ceph:
 
@@ -989,7 +982,6 @@ Controller-0 will reboot in order to apply configuration changes and come into
 service. This can take 5-10 minutes, depending on the performance of the host
 machine.
 
-.. only:: starlingx or platform
 
 For Rook-Ceph:
 

doc/source/deploy_install_guides/release/bare_metal/controller_storage_install_kubernetes.rst

@@ -758,11 +758,6 @@ host machine.
 If configuring host based Ceph Storage Backend, Add Ceph OSDs to controllers
 ----------------------------------------------------------------------------
 
-.. warning::
-
-   Currently |prod-os| does not support rook-ceph. If you plan on using
-   |prod-os|, choose host-based Ceph.
-
 .. only:: starlingx and html
 
    .. tabs::
@@ -834,17 +829,11 @@ Complete system configuration by reviewing procedures in:
 - |index-sysconf-kub-78f0e1e9ca5a|
 - |index-admintasks-kub-ebc55fefc368|
 
-.. only:: starlingx or platform
 
 *******************************************************************
 If configuring Rook Ceph Storage Backend, configure the environment
 *******************************************************************
 
-   .. warning::
-
-      Currently |prod-os| does not support rook-ceph. If you plan on using
-      |prod-os|, choose host-based Ceph.
-
 .. note::
 
    Each deployment model enforces a different structure for the Rook Ceph
@@ -962,6 +951,7 @@ Complete system configuration by reviewing procedures in:
       $ system host-stor-add controller-0 osd fdaf3f71-a2df-4b40-9e70-335900f953a3
       $ system host-stor-add controller-1 osd 03cbb10e-fdc1-4d84-a0d8-6e02c22e3251
       $ system host-stor-add compute-0 osd c9b4ed65-da32-4770-b901-60b56fd68c35
+
 #. Apply the rook-ceph application.
 
    .. code-block:: none

doc/source/deploy_install_guides/release/openstack/install.rst

@@ -67,6 +67,39 @@ Install application manifest and helm-charts
      the current state of the underlying StarlingX Kubernetes platform and the
      recommended StarlingX configuration of OpenStack services.
 
+   By default, |prefix|-openstack is configured to support Rook-Ceph
+   deployments. For host-based Ceph deployments, the following script needs to
+   be executed to override the ``ceph-config-helper`` image used by
+   |prefix|-openstack helm charts:
+
+   .. code-block:: none
+
+      NAMESPACE=openstack
+      APP_NAME=|prefix|-openstack
+      DOCKER_REGISTRY_URL=<your docker registry url> # e.g., myprivateregistry.abc.com:9001/docker.io
+      HOST_CEPH_IMAGE=${DOCKER_REGISTRY_URL}/openstackhelm/ceph-config-helper:ubuntu_bionic-20201223
+      OVERRIDE_CHARTS=(
+         "cinder" "cinder"
+         "glance"
+         "libvirt"
+         "nova" "nova"
+      )
+
+      OVERRIDE_IMAGES=(
+         "cinder_backup_storage_init" "cinder_storage_init"  # Cinder images
+         "glance_storage_init"                               # Glance image
+         "ceph_config_helper"                                # libvirt image 
+         "nova_service_cleaner" "nova_storage_init"          # Nova images
+      )
+
+      for ((i=0; i<${#OVERRIDE_CHARTS[@]}; i++)); do
+         CHART=${OVERRIDE_CHARTS[$i]}
+         IMAGE=${OVERRIDE_IMAGES[$i]}
+         echo "Overriding ${IMAGE} image of ${CHART} chart"
+         system helm-override-update ${APP_NAME} ${CHART} ${NAMESPACE} \
+            --reuse-values --set images.tags.${IMAGE}=${HOST_CEPH_IMAGE}
+      done 
+
 #. Apply the |prefix|-openstack application in order to bring |prod-os| into
    service. If your environment is preconfigured with a proxy server, then make
    sure HTTPS proxy is set before applying |prefix|-openstack.