(DOCSP-14707): Drafted MEKO OpenShift Quick Start. (#595)

* (DOCSP-14707): Drafted MEKO OpenShift Quick Start.

* (DOCSP-14707): Incorporated Nate's feedback.

* (DOCSP-14707): Incorporated Rodrigo's feedback.

Author: corryroot

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

@@ -110,7 +110,7 @@ content: |
 
   You can view the newly-created user in |com|:
 
-  1. From the Project's :guilabel:`Deployment` view, click
+  a. From the Project's :guilabel:`Deployment` view, click
      the :guilabel:`Security` tab.
 
   #. Click the :guilabel:`MongoDB Users` nested tab.

source/includes/steps-install-prereqs.yaml

@@ -95,17 +95,16 @@ content: |
      ``registry.connect.redhat.com``, then save the file:
 
      .. code-block:: json
-        :emphasize-lines: 5-9
+        :emphasize-lines: 6-8
 
         {
           "auths": {
-          "registry.redhat.io": {
-            "auth": "<encoded-string>"
-          },
-          "auths": {
-          "registry.connect.redhat.com": {
-            "auth": "<encoded-string>"
-          }            
+            "registry.redhat.io": {
+              "auth": "<encoded-string>"
+            },
+            "registry.connect.redhat.com": {
+              "auth": "<encoded-string>"
+            }            
           }
         }
 

source/includes/steps-kind-quick-start.yaml

@@ -45,7 +45,7 @@ title: "Install the |k8s-op-full|"
 ref: install-kubectl-kind
 content: |
 
-  1. Change to the directory in which you cloned the repository.
+  a. Change to the directory in which you cloned the repository.
 
   #. Install the |k8s-crds| for MongoDB deployments using the 
      following |kubectl| command:
@@ -249,7 +249,7 @@ content: |
   `Cloud Manager <docs.cloudmanager.com/current/>`__
   application, depending on where your clusters are hosted:
 
-  1. Click :guilabel:`Deployment` in the left navigation.
+  a. Click :guilabel:`Deployment` in the left navigation.
 
   #. Click :icon-mms:`ellipsis` for the deployment to which you want
      to connect.

source/includes/steps-openshift-quick-start.yaml

@@ -0,0 +1,118 @@
+---
+stepnum: 1
+level: 4
+ref: clone-k8s-repo-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: clone-k8s-repo-kind
+
+---
+stepnum: 2
+level: 4
+ref: create-k8s-ns-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: create-k8s-ns-kind
+
+---
+stepnum: 3
+level: 4
+ref: configure-kubectl-configmap-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: configure-kubectl-configmap-kind
+
+---
+stepnum: 4
+level: 4
+ref: create-k8s-secret-openshift
+title: "Create a |k8s-secret| that contains credentials authorized to pull images from the ``registry.connect.redhat.com`` repository."
+source:
+  file: steps-install-prereqs.yaml
+  ref: create-k8s-secret
+
+---
+stepnum: 5
+level: 4
+title: "Install the |k8s-op-full|"
+ref: install-k8s-openshift
+content: |
+
+  a. Invoke the following |oc| command to install the |k8s-crds| for 
+     MongoDB deployments:
+
+     .. code-block:: sh
+
+        oc apply -f crds.yaml
+  
+  #. Add your ``<openshift-pull-secret>`` to the ``ServiceAccount`` 
+     definitions in the |k8s-op-full| |yaml| file:
+
+     .. literalinclude:: /includes/openshift-service-accounts.yaml
+        :language: yaml
+        :emphasize-lines: 11-12, 22-23, 33-34
+
+  #. Invoke the following |oc| command to install |k8s-op-short|:
+
+     .. code-block:: sh
+
+        oc apply -f mongodb-enterprise-openshift.yaml
+
+---
+stepnum: 6
+level: 4
+ref: create-k8s-credentials-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: create-k8s-credentials-kind
+  
+---
+stepnum: 7
+level: 4
+ref: copy-k8s-configmap-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: copy-k8s-configmap-kind
+
+---
+stepnum: 8
+level: 4
+ref: deploy-replica-set-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: deploy-replica-set-kind
+
+---
+stepnum: 9
+level: 4
+ref: create-k8s-user-secret-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: create-k8s-user-secret-kind
+
+---
+stepnum: 10
+level: 4
+ref: add-k8s-user-configmap-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: add-k8s-user-configmap-kind
+
+---
+stepnum: 11
+level: 4
+ref: view-k8s-user-openshift
+optional: true
+source:
+  file: steps-add-database-user-scram.yaml
+  ref: view-k8s-user
+
+---
+stepnum: 12
+level: 4
+ref: connect-k8s-rs-openshift
+source:
+  file: steps-kind-quick-start.yaml
+  ref: connect-k8s-rs-kind
+
+...

source/index.txt

@@ -48,6 +48,7 @@ optimal performance.
    :titlesonly:
 
    Kind Quick Start </kind-quick-start>
+   OpenShift Quick Start </openshift-quick-start>
    Install the Operator </installation>
    Deploy Ops Manager Resources </om-resources>
    Deploy MongoDB Database Resources </mdb-resources>

source/kind-quick-start.txt

@@ -13,9 +13,9 @@ Kind Quick Start
    :class: singlecol
 
 |k8s-op-full| uses the |k8s| API and tools to manage MongoDB
-clusters. |k8s-op-full| works together with MongoDB |com|. This 
+clusters. |k8s-op-short| works together with MongoDB |com|. This 
 tutorial demonstrates how to deploy and connect to your first replica 
-set in |com| from |kind| with |k8s-op-full|.
+set in |com| from |kind| with |k8s-op-short|.
 
 
 Prerequisites

source/openshift-quick-start.txt

@@ -0,0 +1,31 @@
+.. _openshift-quick-start-ref:
+
+=====================
+OpenShift Quick Start
+=====================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+|k8s-op-full| uses the |k8s| API and tools to manage MongoDB
+clusters. |k8s-op-short| works together with MongoDB |com|. This 
+tutorial demonstrates how to deploy and connect to your first replica 
+set in |com| from OpenShift with |k8s-op-short|.
+
+
+Prerequisites
+-------------
+
+This tutorial requires:
+
+- A running |com| cluster.
+
+Procedure
+---------
+
+.. include:: /includes/steps/openshift-quick-start.rst