(DOCSP-19963) Adds the option for HELM to get connection string from automatically-created K8s secret (#798)

* (DOCSP-19963) Adds the option for HEML to get connection string from automatically-created K8s secret

* Adds steps file for connecting with secret

* Changes secret name info

* Includes changes from tech review

* Adds changes from copy review

* Fixes build error

Author: sarahsimpers

source/includes/facts/fact-if-create-user-creates-secret.rst

@@ -0,0 +1,10 @@
+When you create a new MongoDB database user, |k8s-op-short| automatically
+creates a new |k8s| |k8s-secret|. The |k8s| |k8s-secret|
+contains the following information about the new database user:
+
+- ``username``: Username for the database user
+- ``password``: Password for the database user
+- ``connectionString.standard``: :manual:`Standard connection string </reference/connection-string/#std-label-connections-standard-connection-string-format>`
+  that can connect you to the database as this database user.
+- ``connectionString.standardSrv``: :manual:`DNS seed list connection string </reference/connection-string/#dns-seed-list-connection-format>` that can
+  connect you to the database as this database user.

source/includes/steps-add-database-user-scram.yaml

@@ -101,6 +101,12 @@ content: |
   .. code-block:: sh
 
      kubectl apply -f <database-user-conf>.yaml
+
+  .. note::
+
+     .. include:: /includes/facts/fact-if-create-user-creates-secret.rst
+     
+     You can use these credentials to :ref:`Connect to a MongoDB Database Resource from Inside Kubernetes <connect-from-inside-k8s>`.
 ---
 title: "View the newly created user in |com|."
 level: 4

source/includes/steps-add-database-user.yaml

@@ -137,6 +137,12 @@ content: |
   .. code-block:: sh
 
      kubectl apply -f <database-user-conf>.yaml
+
+  .. note::
+
+     .. include:: /includes/facts/fact-if-create-user-creates-secret.rst
+     
+     You can use these credentials to :ref:`Connect to a MongoDB Database Resource from Inside Kubernetes <connect-from-inside-k8s>`.
 ---
 title: "View the newly created user in |com|."
 level: 4

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

@@ -0,0 +1,67 @@
+---
+title: "Run the command to view the Kubernetes secret file."
+level: 4
+stepnum: 1
+ref: retrieve-connection-string
+content: |
+  Run the following command in a terminal to view the |k8s-secret|, replacing
+  the variables with the values in the table:
+
+  .. list-table::
+     :widths: 30 70
+     :header-rows: 1
+
+     * - Placeholder
+       - Description
+
+     * - {MongoDB-Resource-Name}
+       - Human-readable label that identifies the MongoDB resource.
+
+     * - {User-Name}
+       - Human-readable label that identifies the MongoDB user.
+
+  .. code-block:: none
+      :copyable: true
+
+      kubectl get secret {MongoDB-Resource-Name}-{User-Name}-admin -o jsonpath='{.data}'
+      
+  If this command returns an error, you can verify the name of the |k8s-secret| by
+  running the following command and retrieving the correct name:
+
+  .. code-block:: none
+      :copyable: true
+
+      kubectl get secrets
+---
+title: "Copy the ``connectionString.standard`` value displayed in the Kubernetes secret file."
+level: 4
+stepnum: 2
+ref: copy-command-secret-file
+---
+title: "Run the connection command."
+level: 4
+stepnum: 3
+ref: run-command
+content: |
+  
+  Use the ``connectionString.standard`` value within a :manual:`connection string </reference/connection-string/#standard-connection-string-format>`
+  to connect to the deployment.
+
+  .. code-block:: none
+    :copyable: true
+
+    mongosh {connectionString.standard}
+            
+---
+title: "(Optional) Mount the Kubernetes secret in your pod."
+level: 4
+stepnum: 4
+ref: mount-k8s-secret-to-connect
+content: |
+
+  You can :k8sdocs:`mount the secret in your pod </concepts/configuration/secret/#using-secrets-as-files-from-a-pod>`
+  to ensure that your applications can access the credentials.
+
+...
+
+

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

@@ -19,16 +19,40 @@ You must be able to connect to the host and port where you deployed your
 Procedure
 ---------
 
-Perform the following steps in the |mms| or
-`Cloud Manager <docs.cloudmanager.com/current/>`__
-application, depending on where your clusters are hosted:
+Retrieve and run the connection command for your deployment. You can retrieve
+the connection command from the |mms| or
+:cloudmgr:`Cloud Manager </>`
+application, depending on where your clusters are hosted. You can also retrieve the connection command from
+the |k8s| |k8s-secret| that the |k8s-op-short| creates automatically when you
+:ref:`add a MongoDB user with SCRAM authentication <create-db-user-scram>` or X509.
 
-.. include:: /includes/steps/connect-from-inside-k8s.rst
+The install procedure varies based on how you want to retrieve your connection string:
 
-When connecting to a resource from inside of |k8s|, the
-hostname to which you connect has the following form:
+.. tabs::
 
-.. code-block:: sh
+   .. tab:: Using the Application
+      :tabid: UsingTheApplication
+
+      Perform the following steps in the |mms| or :cloudmgr:`Cloud Manager </>`
+      application, 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>
+         
+   .. tab:: Using the Kubernetes Secret
+      :tabid: UsingK8sSecret
+
+      .. include:: /includes/facts/fact-if-create-user-creates-secret.rst
+
+      Perform the following steps to view the credentials and
+      use the connection string to connect to MongoDB:
+
+      .. include:: /includes/steps/connect-from-inside-k8s-using-secret.rst
 
-   <k8s-pod-name>.<k8s-internal-service-name>.<k8s-namespace>.<cluster-name>
 

source/tutorial/manage-database-users-scram.txt

@@ -90,6 +90,8 @@ Create User Secret
 
 .. include:: /includes/steps/add-database-user-secret-scram.rst
 
+.. _create-db-user-scram:
+
 Create MongoDBUser
 ~~~~~~~~~~~~~~~~~~