(DOCSP-6854): Tutorial to connect to k8s deployment from inside k8s (#83)

* (DOCSP-6854): Tutorial to connect to k8s deployment from inside k8s

* Updates per Tony's feedback

* Updates per Tony's feedback

* small tweak per Cian's feedback

* reformatting

Author: jeff-allen-mongo

source/connect.txt

@@ -0,0 +1,21 @@
+:noprevnext:
+
+=================
+Deployment Access
+=================
+
+.. default-domain:: mongodb
+
+The following pages describe how to connect to your MongoDB
+resource deployed by |k8s|:
+
+.. include:: /includes/toc/dfn-list-connect.rst
+
+.. include:: /includes/toc/connect.rst
+
+.. class:: hidden
+
+   .. toctree::
+      :titlesonly:
+
+      /tutorial/connect-from-inside-k8s

source/includes/steps-connect-from-inside-k8s.yaml

@@ -0,0 +1,41 @@
+---
+title: "Open the :guilabel:`Topology` view for your deployment."
+level: 4
+stepnum: 1
+ref: open-processes-view
+content: |
+  Click :guilabel:`Deployment` in the left navigation.
+---
+title: "Click :icon-mms:`ellipsis` for the deployment to which you want
+  to connect."
+level: 4
+stepnum: 2
+ref: click-ellipses
+---
+title: "Click :guilabel:`Connect to this instance`."
+level: 4
+stepnum: 3
+ref: click-connect
+---
+title: "Copy the connection command displayed in the
+  :guilabel:`Connect to your Deployment` dialog."
+level: 4
+stepnum: 4
+ref: copy-command
+---
+title: "Run the connection command in a terminal to connect to the
+  deployment."
+level: 4
+stepnum: 5
+ref: run-command
+content: |
+  .. example::
+
+        To connect to a sharded cluster resource named
+        ``shardedcluster``, you might use the following connection
+        string:
+
+        .. code-block:: none
+            :copyable: false
+
+            mongo --host shardedcluster-mongos-0.shardedcluster-svc.mongodb.svc.cluster.local --port 27017

source/includes/toc-connect.yaml

@@ -0,0 +1,5 @@
+file: /tutorial/connect-from-inside-k8s
+description: |
+  Connect to a MongoDB resource deployed by |k8s| from inside of
+  the |k8s| cluster.
+...

source/index.txt

@@ -52,6 +52,7 @@ optimal performance.
       Installation </installation>
       Database Deployment </deploy>
       User Management </tutorial/manage-database-users-x509>
+      /connect
       /reference
       /specification
       Release Notes </release-notes>

source/tutorial/connect-from-inside-k8s.txt

@@ -0,0 +1,35 @@
+.. _connect-from-outside-k8s:
+
+====================================================
+Connect to a MongoDB Resource from Inside Kubernetes
+====================================================
+
+.. default-domain:: mongodb
+
+The following procedure describes how to connect to a MongoDB resource
+deployed by |k8s| from inside of the |k8s| cluster.
+
+Considerations
+--------------
+
+You must be able to connect to the host and port where you deployed your
+|k8s| resource. To learn more about connecting to your deployment, see
+:opsmgr:`Connect to a MongoDB Process </tutorial/connect-to-mongodb/>`.
+
+Procedure
+---------
+
+Perform the following steps in the |mms| or
+`Cloud Manager <docs.cloudmanager.com/current/>`__
+:abbr:`UI (User Interface)`, depending on where your clusters are 
+hosted:
+
+.. include:: /includes/steps/connect-from-inside-k8s.rst
+
+When connecting to a resource from inside of |k8s|, the
+hostname to which you connect has the following form:
+
+.. code-block:: sh
+
+   <k8s-pod-name>.<k8s-internal-service-name>.<k8s-namespace>.<cluster-name>
+