DOCSP-25301: Add a note for deprecation of Ubuntu images to test this with users (#1058)

jwilliams-mongo · kyuan-mongodb · jwilliams-mongo · commit ec33fbdd1102 · 2025-04-14T17:11:20.000-05:00
* DOCSP-25301: remove ubuntu image support * DOCSP-25301: add note * DOCSP-25301: add note * fix warning * Apply suggestions from code review Co-authored-by: kyuan-mongodb <78768401+kyuan-mongodb@users.noreply.github.com> Co-authored-by: kyuan-mongodb <78768401+kyuan-mongodb@users.noreply.github.com>
diff --git a/source/includes/list-tables/compatibility-mdb.rst b/source/includes/list-tables/compatibility-mdb.rst
@@ -1,3 +1,13 @@
+.. important::
+
+   Starting with the |k8s-op-short| 1.17 release, Ubuntu base images 
+   are deprecated and will be removed in a future release.
+
+   MongoDB will continue to support the Red Hat UBI 8 base images.
+
+   To provide feedback about this change, use the `MongoDB Feedback Engine 
+   <https://feedback.mongodb.com/forums/924355-ops-tools?category_id=370990>`__.
+
 .. list-table::
    :header-rows: 1
    :widths: 50 50
@@ -6,16 +16,14 @@
      - Base Image
 
    * - 1.17.x
-     - Ubuntu 20.04, Red Hat UBI 8 Base Image [1]_
+     - Ubuntu 20.04 (deprecated), Red Hat UBI 8 Base Image
 
    * - 1.16.x
-     - Ubuntu 20.04, Red Hat UBI 8 Base Image [1]_
+     - Ubuntu 20.04, Red Hat UBI 8 Base Image
 
    * - 1.15.x
-     - Ubuntu 20.04, Red Hat UBI 8 Base Image [1]_
+     - Ubuntu 20.04, Red Hat UBI 8 Base Image
 
    * - 1.14.x
-     - Ubuntu 20.04, Red Hat UBI 8 Base Image [1]_
-
+     - Ubuntu 20.04, Red Hat UBI 8 Base Image
 
-.. [1] Most commonly used for OpenShift deployments
diff --git a/source/includes/steps-deploy-k8s-opsmgr-local-mode.yaml b/source/includes/steps-deploy-k8s-opsmgr-local-mode.yaml
@@ -258,37 +258,18 @@ content: |
   .. note::
 
      The examples below provide you with a link to quickly download the
-     specified versions of MongoDB Community edition and the MongoDB
-     Database tools.
+     specified versions of MongoDB Community edition.
 
      To download MongoDB Enterprise Edition, or any other version of 
      MongoDB Community Edition, visit the :dl:`MongoDB Download Center`.
 
-  .. tabs::
-
-     .. tab:: Vanilla Kubernetes
-        :tabid: k8s
-
-        a. Download the Ubuntu 20.04 installation tarball for the
-           MongoDB Server version you want the |k8s-op-short| to
-           deploy. For example, to download the ``4.4.0`` release:
-
-           .. code-block:: sh
-
-              curl -OL https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1604-4.4.0.tgz
-
-
-     .. tab:: OpenShift
-        :tabid: os
-
-        a. Download the RHEL installation tarball for the MongoDB
-           database version you want the |k8s-op-short| to deploy. For
-           example, to download the ``4.4.0`` release:
+  Download the RHEL installation tarball for the MongoDB Server version 
+  you want the |k8s-op-short| to deploy. For example, to download the 
+  ``6.0.1`` release:
 
-           .. code-block:: sh
-
-              curl -OL https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel<version>-4.4.0.tgz
+  .. code-block:: sh
 
+     curl -OL https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
 
 ---
 
@@ -319,49 +300,45 @@ content: |
         To copy the MongoDB installation archive to the 
         |onprem| PersistentVolume:
 
-        a. Copy the MongoDB Server installation tarball to the
-           |onprem| PersistentVolume. For example, to copy the ``5.0.0``
-           release:
+        Copy the MongoDB Server installation tarball to the
+        |onprem| PersistentVolume. For example, to copy the ``6.0.1``
+        release:
 
-           | Replica 0:
+        | Replica 0:
 
-           .. code-block:: sh
+        .. code-block:: sh
 
-              kubectl cp mongodb-linux-x86_64-ubuntu1604-5.0.0.tgz \ 
-              "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-ubuntu1604-5.0.0.tgz"
+           kubectl cp mongodb-linux-x86_64-rhel80-6.0.1.tgz \ 
+           "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel80-6.0.1.tgz"
 
-           | Replica 1:
-
-           .. code-block:: sh
-
-              kubectl cp mongodb-linux-x86_64-ubuntu1604-5.0.0.tgz \ 
-              "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-ubuntu1604-5.0.0.tgz"
+        | Replica 1:
 
+        .. code-block:: sh
 
+           kubectl cp mongodb-linux-x86_64-rhel80-6.0.1.tgz \ 
+           "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel80-6.0.1.tgz"
 
      .. tab:: OpenShift
         :tabid: os
 
         To copy the MongoDB installation archive to the 
-        |onprem| PersistentVolume:
-
-        a. Copy the MongoDB Server installation ``tarball`` to the 
-           |onprem| PersistentVolume. For example, to copy the ``5.0.0``
-           release:
+        |onprem| PersistentVolume, copy the MongoDB Server installation ``tarball`` to the 
+        |onprem| PersistentVolume. For example, to copy the ``6.0.1``
+        release:
 
-           | Replica 0:
+        | Replica 0:
 
-           .. code-block:: sh
+        .. code-block:: sh
 
-              oc rsync  "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel<version>-5.0.0.tgz" \ 
-              mongodb-linux-x86_64-rhel<version>-5.0.0.tgz
+           oc rsync  "ops-manager-localmode-0:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel80-6.0.1.tgz" \ 
+           mongodb-linux-x86_64-rhel80-6.0.1.tgz
 
-           | Replica 1:
+        | Replica 1:
 
-           .. code-block:: sh
+        .. code-block:: sh
 
-              oc rsync  "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel<version>-5.0.0.tgz" \ 
-              mongodb-linux-x86_64-rhel<version>-5.0.0.tgz
+           oc rsync  "ops-manager-localmode-1:/mongodb-ops-manager/mongodb-releases/mongodb-linux-x86_64-rhel80-6.0.1.tgz" \ 
+           mongodb-linux-x86_64-rhel80-6.0.1.tgz
 
 ---
 title: "Deploy a MongoDB Database Resource."
diff --git a/source/includes/steps-deploy-k8s-opsmgr-remote-mode.yaml b/source/includes/steps-deploy-k8s-opsmgr-remote-mode.yaml
@@ -87,27 +87,27 @@ content: |
             to the appropriate initContainer for each version you want
             Nginx to serve. 
 
-            For example, to configure Nginx to serve MongoDB ``4.2.0``
-            and ``4.4.0``:
+            For example, to configure Nginx to serve MongoDB ``5.0.12``
+            and ``6.0.1``:
 
             .. code-block:: yaml
                :emphasize-lines: 9-14
                :copyable: false
 
-               - name: setting-up-ubuntu-mongodb
+               - name: setting-up-rhel-mongodb
                  image: curlimages/curl:latest
                  command:
                    - curl
                    - -L
-                   - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1604-4.2.0.tgz
+                   - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-5.0.12.tgz
                    - -o
-                   - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-ubuntu1604-4.2.0.tgz
+                   - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel80-5.0.12.tgz
                    - &&
                    - curl
                    - -L
-                   - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1604-4.4.0.tgz
+                   - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
                    - -o
-                   - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-ubuntu1604-4.4.0.tgz
+                   - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
 
         #. Save this file with a ``.yaml`` file extension.
 
@@ -156,24 +156,23 @@ content: |
            and ``4.4.0``:
 
            .. code-block:: yaml
-              :emphasize-lines: 10-15
+              :emphasize-lines: 10-14
               :copyable: false
 
-              initContainers:
-                - name: setting-up-rhel-mongodb
-                  image: curlimages/curl:latest
-                  command:
-                    - curl
-                    - -L
-                    - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel<version>-4.2.0.tgz
-                    - -o
-                    - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel<version>-4.2.0.tgz
-                    - &&
-                    - curl
-                    - -L
-                    - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel<version>-4.4.0.tgz
-                    - -o
-                    - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel<version>-4.4.0.tgz
+              - name: setting-up-rhel-mongodb
+                image: curlimages/curl:latest
+                command:
+                  - curl
+                  - -L
+                  - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-5.0.12.tgz
+                  - -o
+                  - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel80-5.0.12.tgz
+                  - &&
+                  - curl
+                  - -L
+                  - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
+                  - -o
+                  - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
 
         #. Save this file with a ``.yaml`` file extension.
 
diff --git a/source/includes/steps-install-prereqs.yaml b/source/includes/steps-install-prereqs.yaml
@@ -69,9 +69,7 @@ content: |
      communicate with the |k8s-op-short|. 
 
      To learn how to check your |ntp| service for your |onprem|
-     host, see the documentation for
-     `Ubuntu <https://help.ubuntu.com/lts/serverguide/NTP.html>`__ or
-     `RHEL
+     host, see the documentation for `RHEL
      <https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/s1-checking_the_status_of_ntp>`__.
 
 ---
diff --git a/source/reference/k8s/example-nginx-deployment-k8s.yaml b/source/reference/k8s/example-nginx-deployment-k8s.yaml
@@ -28,25 +28,25 @@ spec:
               mountPath: /etc/nginx/nginx.conf
               subPath: nginx.conf
       initContainers:
-        - name: setting-up-ubuntu-mongodb
+        - name: setting-up-rhel-mongodb
           image: curlimages/curl:latest
           command:
             - curl
             - -L
-            - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1604-4.2.0.tgz
+            - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
             - -o
-            - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-ubuntu1604-4.2.0.tgz
+            - /mongodb-ops-manager/mongodb-releases/linux/mongodb-linux-x86_64-rhel80-6.0.1.tgz
           volumeMounts:
             - name: mongodb-versions
               mountPath: /mongodb-ops-manager/mongodb-releases/linux
-        - name: setting-up-ubuntu-mongodb-tools
+        - name: setting-up-rhel-mongodb-tools
           image: curlimages/curl:latest
           command:
             - curl
             - -L
-            - https://fastdl.mongodb.org/tools/db/mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz
+            - https://fastdl.mongodb.org/tools/db/mongodb-database-tools-rhel80-x86_64-100.6.0.tgz
             - -o
-            - /tools/db/mongodb-database-tools-ubuntu1604-x86_64-100.1.0.tgz
+            - /tools/db/mongodb-database-tools-rhel80-x86_64-100.6.0.tgz
           volumeMounts:
             - name: mongodb-tools
               mountPath: /tools/db/
diff --git a/source/tutorial/modify-resource-image.txt b/source/tutorial/modify-resource-image.txt
@@ -83,8 +83,8 @@ To create a volume mount for a MongoDB database resource:
 Tune MongoDB Kubernetes Resource Docker Images with an InitContainer
 --------------------------------------------------------------------
 
-|k8s-mdbrsc| Docker images run on Ubuntu and use Ubuntu's default
-system configuration. To tune the underlying Ubuntu system
+|k8s-mdbrsc| Docker images run on RHEL and use RHEL's default
+system configuration. To tune the underlying RHEL system
 configuration in the |k8s-mdbrsc| containers, add a privileged
 InitContainer
 :k8sdocs:`init container </concepts/workloads/pods/init-containers/>`
@@ -98,7 +98,7 @@ using one of the following settings:
 
 .. example::
 
-   MongoDB database resource Docker images use the Ubuntu default
+   MongoDB database resource Docker images use the RHEL default
    ``keepalive`` time of ``7200``. MongoDB recommends a shorter
    ``keepalive`` time of ``120`` for database deployments.
 
diff --git a/source/tutorial/plan-k8s-op-container-images.txt b/source/tutorial/plan-k8s-op-container-images.txt
@@ -32,9 +32,7 @@ following operating systems:
      - Image OS
 
    * - Quay.io 
-     - `Ubuntu 20.04 <https://www.ubuntu.com/containers>`__
-     
-       `Red Hat UBI 8 <https://www.redhat.com/en/topics/containers>`__
+     - `Red Hat UBI 8 <https://www.redhat.com/en/topics/containers>`__
 
    * - Red Hat Catalog
      - `Red Hat UBI 8 <https://www.redhat.com/en/topics/containers>`__
@@ -75,9 +73,3 @@ a container registry:
    * - ``mongodb-enterprise-init-ops-manager``
      - ``initContainer`` image that contains the Ops Manager start-up 
        scripts and the readiness probe.
-
-.. note::
-
-   Images from Quay.io use Ubuntu 20.04 by default. Append 
-   ``-ubi`` to an image name to retrieve a version that uses 
-   Red Hat UBI 8.
