(DOSP-17749) (DOCSP-14906) update the upgrade instructions with "removal of spec.project", remove obsolete note from om reconciliation (#764)

* Added an upgrade step about removal of spec.project

* Make all step IDs unique to fix the build

* Fix the build, missed space

* Fixing the build

* Build

* Build, still

* Trying to fix the build still

* Added a link to relnotes

* Removed a note for the om reconcilliation that is no longer accurate

Author: JuliaMongo

source/images/multi-cluster-arch.svg

@@ -96,5 +96,18 @@ content: |
   definition:
 
   {{command}}
+---
+title: "If you are upgrading the Operator to version 1.13.0 or later, specify the :setting:`spec.opsManager.configMapRef.name` or the :setting:`spec.cloudManager.configMapRef.name` settings:"
+level: 4
+ref: remove-project-spec
+content: |
+
+  1. Open the :ref:`k8s-specification` in the editor of your choice.
+  #. Search for the deprecated :setting:`spec.project` setting and remove it.
+  #. Add the value to the :setting:`spec.opsManager.configMapRef.name`
+     setting or the
+     :setting:`spec.cloudManager.configMapRef.name` setting and save
+     the specification.
 
+  To learn more, see :ref:`Changes to the MongoDB Resource <ent_op-1.13.0-mdb-resource>`.
 ...

source/includes/steps-install-master.yaml

@@ -30,17 +30,23 @@ replacement:
            --patch '{"spec": {"security": {"tls": {"ca": "<ca-configmap>"}}}}' \ 
            --type merge
 ---
+ref: remove-project-spec-k8s-offline-helm
+stepnum: 4
+inherit:
+  file: steps-install-master.yaml
+  ref: remove-project-spec
+---
 ref: upgrade-customize-chart
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-customize-chart
-stepnum: 4
+stepnum: 5
 ---
 ref: helm-k8s-offline-host
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-install
-stepnum: 5
+stepnum: 6
 replacement:
   method: "Upgrade to the latest version of the |k8s-op-short|."
 content: |

source/includes/steps-upgrade-k8s-offline-helm-host.yaml

@@ -30,17 +30,23 @@ replacement:
            --patch '{"spec": {"security": {"tls": {"ca": "<ca-configmap>"}}}}' \ 
            --type merge
 ---
+ref: remove-project-spec-k8s-online-helm
+stepnum: 4
+inherit:
+  file: steps-install-master.yaml
+  ref: remove-project-spec
+---
 ref: upgrade-customize-chart
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-customize-chart
-stepnum: 4
+stepnum: 5
 ---
 ref: helm-k8s-online-ug
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-install
-stepnum: 5
+stepnum: 6
 replacement:
   method: "Upgrade the |k8s-op-short|."
 content: |

source/includes/steps-upgrade-k8s-online-helm.yaml

@@ -40,13 +40,18 @@ replacement:
        kubectl patch opsmanagers/<opsmgr-resource-metadata.name> \
            --patch '{"spec": {"security": {"tls": {"ca": "<ca-configmap>"}}}}' \ 
            --type merge
-
+---
+ref: remove-project-spec-kubectl
+stepnum: 5
+inherit:
+  file: steps-install-master.yaml
+  ref: remove-project-spec
 ---
 ref: upgrade-kubectl-upgrade
 inherit:
   file: steps-install-master.yaml
   ref: install-master-install
-stepnum: 5
+stepnum: 6
 replacement:
   method: "Upgrade to the new version of the |k8s-op-short|."
 content: |

source/includes/steps-upgrade-kubectl.yaml

@@ -47,11 +47,17 @@ replacement:
            --patch '{"spec": {"security": {"tls": {"ca": "<ca-configmap>"}}}}' \ 
            --type merge
 ---
+ref: remove-project-spec-oc-generic
+stepnum: 5
+inherit:
+  file: steps-install-master.yaml
+  ref: remove-project-spec
+---
 ref: upgrade-oc-upgrade
 inherit:
   file: steps-install-master.yaml
   ref: install-master-install
-stepnum: 5
+stepnum: 6
 replacement:
   method: "Upgrade to the new version of the |k8s-op-short|."
 

source/includes/steps-upgrade-oc.yaml

@@ -30,17 +30,23 @@ replacement:
            --patch '{"spec": {"security": {"tls": {"ca": "<ca-configmap>"}}}}' \ 
            --type merge
 ---
+ref: remove-project-spec-oc-offline
+stepnum: 4
+inherit:
+  file: steps-install-master.yaml
+  ref: remove-project-spec
+---
 ref: upgrade-customize-chart
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-customize-chart
-stepnum: 4
+stepnum: 5
 ---
 ref: helm-os-offline-host
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-install
-stepnum: 5
+stepnum: 6
 replacement:
   method: "Upgrade to the latest version of the |k8s-op-short|."
 content: |

source/includes/steps-upgrade-os-offline-helm-host.yaml

@@ -30,17 +30,23 @@ replacement:
            --patch '{"spec": {"security": {"tls": {"ca": "<ca-configmap>"}}}}' \ 
            --type merge
 ---
+ref: remove-proj-spec-oc
+stepnum: 4
+inherit:
+  file: steps-install-master.yaml
+  ref: remove-project-spec
+---
 ref: upgrade-customize-chart
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-customize-chart
-stepnum: 4
+stepnum: 5
 ---
 ref: helm-os-online-ug
 inherit:
   file: steps-helm-master.yaml
   ref: helm-master-install
-stepnum: 5
+stepnum: 6
 replacement:
   method: "Upgrade the |k8s-op-short|."
 content: |

source/includes/steps-upgrade-os-online-helm.yaml

@@ -71,6 +71,8 @@ Changes
   certificates. Changes to these ConfigMaps and secrets now trigger a 
   reconciliation of the related resource.
 
+.. _ent_op-1.13.0-mdb-resource:
+
 ``MongoDB`` Resource
 ````````````````````
 

source/release-notes.txt

@@ -160,7 +160,7 @@ changes to the ``MongoDBOpsManager`` |k8s-crd|.
    least three |k8s-pods|.
 
    - Each Pod runs one {+mdbagent+} instance. Each {+mdbagent+} starts a
-     |mongod| instance on its pod.
+     |mongod| instance on its Pod.
    - The |k8s-op-short| mounts the ``<om_resource_name>-db-config``
      Secret to each Pod. The {+mdbagent+} uses this secret to
      configure the Application Database replica set.
@@ -179,11 +179,9 @@ changes to the ``MongoDBOpsManager`` |k8s-crd|.
       restart because the connection string to the Application Database
       changes.
 
-      Changes to the following ``MongoDBOpsManager``
-      |k8s-custom-resource| collections don't trigger a rolling upgrade:
-
-      - :opsmgrkube:`spec.backup <spec.backup.enabled>`
-      - :opsmgrkube:`spec.applicationDatabase`
+      Changes to the :opsmgrkube:`spec.backup <spec.backup.enabled>`
+      ``MongoDBOpsManager`` |k8s-custom-resource| collection don't
+      trigger a rolling upgrade.
 
 4. The |k8s-op-short| invokes |onprem| APIs to create an admin user.
    The |k8s-op-short| saves this admin user's credentials in the