(DOCSP-15540) Custom version of AppDB in Operator (#597)

* resolving conflicts

* Continued work. Removed obsolete procedure from unsupported v1.3, added scaffolding steps for migrating to specified AppDB versions. To be continued.

* Continued updates

* Include tech draft review from Cian and Nikolas

* Included copy review from Melissa

* Fix build errors

* Include tech review

* Adding a redirect for a removed topic /tutorial/migrate-to-single-resource

* Final nits, plus DOCSP-16377 link fix

Author: JuliaMongo

config/redirects

@@ -12,6 +12,12 @@ symlink: stable -> v1.10
 # Base URL
 raw: kubernetes-operator/ -> ${base}/stable/
 
+# Add redirects related to the removal of
+# /tutorial/migrate-to-single-resource. This topic was added initially
+# for v1.3 that is now EOL.
+[v1.11-*]: kubernetes-operator/${version}/tutorial/migrate-to-single-resource -> ${base}/stable/release-notes/#k8s-op-full-1-11-0
+
+
 # Fix problematic redirects that omitted /stable (DOCSP-4989)
 raw: kubernetes-operator/tutorial/install-k8s-operator -> ${base}/stable/tutorial/install-k8s-operator/
 raw: kubernetes-operator/reference/k8s-operator-specification -> ${base}/stable/reference/k8s-operator-specification/

source/includes/admonitions/fact-migrate-to-single-resource.rst

@@ -14,7 +14,6 @@ spec:
   applicationDatabase:
     members: 3
     version: "4.2.11-ent"
-    persistent: true
     security:
       tls:
         ca: "appdb-ca" # Optional. Name of the ConfigMap file

source/includes/admonitions/fact-one-cluster-per-proj.rst

@@ -0,0 +1,3 @@
+Starting in |k8s-op-short| version 1.11.0, you must
+:ref:`migrate <migrate-to-ent-appdb-version>` all deployed
+``MongoDBOpsManager`` custom resources to a specified MongoDB version.

source/includes/admonitions/note-deploy-om-offline.rst

@@ -0,0 +1,21 @@
+Before upgrading your |k8s-op| to v1.11.0 or later,
+:ref:`Migrate the Application Database <migrate-to-ent-appdb-version>`
+of any deployed ``MongoDBOpsManager`` custom resources
+to one of the supported enterprise MongoDB editions. You specify the
+MongoDB version for the :opsmgr:`Application Database
+</core/system-overview/#application-database>` in the
+:opsmgrkube:`spec.applicationDatabase.version` setting.
+The :opsmgrkube:`spec.applicationDatabase.version` setting
+is a required field. For the list of supported MongoDB versions, see the
+:qr-mdb:`container registry </mongodb-enterprise-appdb-database?tab=tags>`.
+
+You must migrate the Application Database to the latest available
+enterprise edition of MongoDB if your ``MongoDBOpsManager`` custom
+resource uses:
+
+- A bundled version of MongoDB for the Application Database. In this case,
+  the :opsmgrkube:`spec.applicationDatabase.version` setting is not
+  specified, or its value is empty.
+- Any other enterprise MongoDB version specified in the :opsmgrkube:`spec.applicationDatabase.version` setting.
+- Any community edition of MongoDB specified in the :opsmgrkube:`spec.applicationDatabase.version` setting.
+

source/includes/code-examples/yaml-files/example-opsmgr.yaml

@@ -0,0 +1,4 @@
+For best results, use the
+:qr-mdb:`latest available enterprise MongoDB version </mongodb-enterprise-appdb-database?tab=tags>`
+that is :ref:`compatible <k8s-onprem-version-compatibility>` with your
+|onprem| version.

source/includes/facts/fact-appdb-version-specified.rst

@@ -6,13 +6,13 @@
      - Description
 
    * - ``mongodb``
-     - Install the CustomResourceDefinitions for the database resources and also
-       watch those resources.
+     - Install the CustomResourceDefinitions for database resources
+       and watch those resources.
 
    * - ``mongodbusers``
-     - Install the CustomResourceDefinitions for the MongoDB user resources and
-       also watch those resources.
+     - Install the CustomResourceDefinitions for MongoDB user resources
+       and watch those resources.
 
    * - ``opsmanagers``
-     - Install the CustomResourceDefinitions for the |onprem| resources and also
-       watch those resources.
+     - Install the CustomResourceDefinitions for |onprem| resources
+       and watch those resources.

source/includes/facts/fact-must-migrate-specified-appdb.rst

@@ -1341,4 +1341,5 @@ description: |
     deployed with the |k8s-op-short|. 
 
   {{example}}
+
 ...