(DOCSP-8007): adding notes for using ops manager with mdb outside of k8s (#188)

* (DOCSP-8007): adding notes for using ops manager with mdb outside of k8s

* (DOCSP-8007): copy review feedback

* (DOCSP-8007): added tutorial per tech review feedback

* (DOCSP-8007): tech review feedback

Author: jwilliams-mongo

source/includes/admonitions/data-url-config-map-external-dbs.rst

@@ -0,0 +1,10 @@
+.. important::
+
+    If you deploy |onprem| with the |k8s-op-short| and |onprem| will 
+    manage MongoDB database resources deployed outside of the |k8s| 
+    cluster it's deployed to, you must set ``data.baseUrl`` to the same 
+    value of the 
+    :opsmgrkube:`spec.configuration.mms.centralUrl <spec.configuration>`
+    setting in the |onprem| resource specification.
+
+    .. seealso:: :ref:`mdb-resource-deployment-locations`

source/includes/admonitions/mms-centralurl-external-mdb.rst

@@ -0,0 +1,10 @@
+.. important::
+
+   If |onprem| will manage MongoDB resources deployed outside of the 
+   |k8s| cluster it's deployed to, you must add the ``mms.centralUrl`` 
+   setting to ``spec.configuration``.
+
+   Set the value to the URL by which |onprem| is exposed outside of the 
+   |k8s| cluster.
+
+   .. seealso:: :ref:`mdb-resource-deployment-locations`

source/includes/list-tables/configmap-keys.rst

@@ -86,8 +86,11 @@
      - |url| to your |application| including the |fqdn| and port
        number.
 
+       .. include:: /includes/admonitions/data-url-config-map-external-dbs.rst
+
        .. note::
 
-          You may use |cloud-short| for the ``data.baseUrl`` value.
+          If you're using |cloud-short|, set the ``data.baseUrl`` value
+          to ``https://cloud.mongodb.com``.
 
      - ``https://ops.example.com:8443``

source/includes/steps-deploy-k8s-opsmgr.yaml

@@ -257,6 +257,9 @@ content: |
 
   - ``spec.``:opsmgrkube:`~spec.clusterDomain`
   - ``spec.``:opsmgrkube:`~spec.configuration`
+
+    .. include:: /includes/admonitions/mms-centralurl-external-mdb.rst
+
   - ``spec.applicationDatabase.``:setting:`~spec.logLevel`
   - ``spec.applicationDatabase.``:setting:`~spec.featureCompatibilityVersion`
   - ``spec.applicationDatabase.podSpec.``:setting:`~spec.podSpec.cpu`
@@ -470,6 +473,8 @@ content: |
           url: http://om-svc.dev.svc.cluster.local:8080
           version: ""
 
+  .. include:: /includes/admonitions/data-url-config-map-external-dbs.rst
+
 ---
 title: "Deploy MongoDB database resources to complete the Backup configuration."
 stepnum: 12

source/reference/k8s-operator-om-specification.txt

@@ -401,6 +401,8 @@ Optional |onprem| Resource Settings
    </reference/configuration/>` for property names and descriptions.
    Each property takes a value of type ``string``.
 
+   .. include:: /includes/admonitions/mms-centralurl-external-mdb.rst
+
 .. opsmgrkube:: spec.externalConnectivity
 
    *Type*: collection

source/tutorial/plan-om-resource.txt

@@ -224,6 +224,46 @@ to create a service:
 - ``spec.``:opsmgrkube:`~spec.externalConnectivity`
 - ``spec.externalConnectivity.``:opsmgrkube:`~spec.externalConnectivity.type`
 
+.. _mdb-resource-deployment-locations:
+
+Managing External MongoDB Deployments
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you deploy |onprem| with the |k8s-op-short|, |onprem| can manage
+MongoDB database resources deployed:
+
+- To the same |k8s| cluster as |onprem|.
+- Outside of |k8s| clusters.
+
+If |onprem| will manage MongoDB database resources deployed to different 
+|k8s| clusters than |onprem| or outside of |k8s| clusters, you must:
+
+1. Add the ``mms.centralUrl`` setting to ``spec.configuration`` in the 
+   |onprem| resource specification.
+
+   Set the value to the URL by which |onprem| is exposed outside of the 
+   |k8s| cluster:
+
+   .. code-block:: yaml
+
+      spec:
+        configuration:
+          mms.centralUrl: https://a9a8f8566e0094380b5c257746627b82-1037623671.us-east-1.elb.example.com:8080/
+
+#. :ref:`Update the ConfigMaps <example-k8s-configmap>` referenced by 
+   all MongoDB database resources inside the |k8s| cluster that you 
+   deployed with the |k8s-op-short|.
+   
+   Set ``data.baseUrl`` to the same value of the 
+   :opsmgrkube:`spec.configuration.mms.centralUrl <spec.configuration>`
+   setting in the |onprem| resource specification.
+
+   .. important::
+
+      This includes the ConfigMaps that the `MongoDB database resources 
+      for the oplog and snapshot stores reference 
+      <../tutorial/deploy-om-container.html#deploy-mongodb-database-resources-to-complete-the-backup-configuration>`__.
+
 .. _om-rsrc-prereqs:
 
 Prerequisites