Merge pull request #61201 from skopacz1/OSDOCS-5791

OSDOCS#5791: Creating a "Performing a cluster update" section

Author: bergerhoffer

_topic_maps/_topic_map.yml

@@ -602,47 +602,50 @@ Topics:
 - Name: Preparing to update to OKD 4.13
   File: updating-cluster-prepare
   Distros: openshift-origin
-- Name: Preparing to perform an EUS-to-EUS update
-  File: preparing-eus-eus-upgrade
-  Distros: openshift-enterprise
-- Name: Preparing to update a cluster with manually maintained credentials
-  File: preparing-manual-creds-update
-- Name: Updating a cluster using the web console
-  File: updating-cluster-within-minor
-- Name: Updating a cluster using the CLI
-  File: updating-cluster-cli
-- Name: Migrating to a cluster with multi-architecture compute machines
-  File: migrating-to-multi-payload
-- Name: Performing update using canary rollout strategy
-  File: update-using-custom-machine-config-pools
-- Name: Updating a cluster that includes RHEL compute machines
-  File: updating-cluster-rhel-compute
-  Distros: openshift-enterprise
-- Name: Updating a cluster in a disconnected environment
-  Dir: updating-restricted-network-cluster
-  Topics:
-  - Name: About cluster updates in a disconnected environment
-    File: index
-  - Name: Mirroring the OpenShift Container Platform image repository
-    File: mirroring-image-repository
-  - Name: Updating a cluster in a disconnected environment using OSUS
-    File: restricted-network-update-osus
+- Name: Performing a cluster update
+  Dir: updating_a_cluster
+  Topics:
+  - Name: Updating a cluster using the CLI
+    File: updating-cluster-cli
+  - Name: Updating a cluster using the web console
+    File: updating-cluster-web-console
+  - Name: Performing an EUS-to-EUS update
+    File: eus-eus-update
     Distros: openshift-enterprise
-  - Name: Updating a cluster in a disconnected environment without OSUS
-    File: restricted-network-update
-    Distros: openshift-enterprise
-  - Name: Updating a cluster in a disconnected environment by using the CLI
-    File: restricted-network-update
-    Distros: openshift-origin
-  - Name: Uninstalling OSUS from a cluster
-    File: uninstalling-osus
+  - Name: Performing a canary rollout update
+    File: update-using-custom-machine-config-pools
+  - Name: Updating a cluster that includes RHEL compute machines
+    File: updating-cluster-rhel-compute
     Distros: openshift-enterprise
-- Name: Updating hardware on nodes running on vSphere
-  File: updating-hardware-on-nodes-running-on-vsphere
+  - Name: Updating a cluster in a disconnected environment
+    Dir: updating_disconnected_cluster
+    Topics:
+    - Name: About cluster updates in a disconnected environment
+      File: index
+    - Name: Mirroring OpenShift Container Platform images
+      File: mirroring-image-repository
+    - Name: Updating a cluster in a disconnected environment using OSUS
+      File: disconnected-update-osus
+      Distros: openshift-enterprise
+    - Name: Updating a cluster in a disconnected environment without OSUS
+      File: disconnected-update
+      Distros: openshift-enterprise
+    - Name: Updating a cluster in a disconnected environment by using the CLI
+      File: disconnected-update
+      Distros: openshift-origin
+    - Name: Uninstalling OSUS from a cluster
+      File: uninstalling-osus
+      Distros: openshift-enterprise
+  - Name: Updating hardware on nodes running on vSphere
+    File: updating-hardware-on-nodes-running-on-vsphere
+  - Name: Migrating to a cluster with multi-architecture compute machines
+    File: migrating-to-multi-payload
+  - Name: Updating hosted control planes
+    File: updating-hosted-control-planes
+- Name: Preparing to update a cluster with manually maintained credentials
+  File: preparing-manual-creds-update
 - Name: Preflight validation for Kernel Module Management (KMM) Modules
   File: kmm-preflight-validation
-- Name: Updating hosted control planes
-  File: updating-hosted-control-planes
 # - Name: Troubleshooting an update
 #  File: updating-troubleshooting
 ---

getting_started/openshift-overview.adoc

@@ -104,7 +104,7 @@ be reviewed by cluster administrators and xref:../operators/admin/olm-adding-ope
 
 * **xref:../scalability_and_performance/recommended-performance-scale-practices/recommended-infrastructure-practices.adoc#scaling-cluster-monitoring-operator[Scale] and xref:../scalability_and_performance/using-node-tuning-operator.adoc#using-node-tuning-operator[tune] clusters**: Set cluster limits, tune nodes, scale cluster monitoring, and optimize networking, storage, and routes for your environment.
 
-* **xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Understanding the OpenShift Update Service]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
+* **xref:../updating/updating_a_cluster/updating_disconnected_cluster/disconnected-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Using the OpenShift Update Service in a disconnected environement]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
 
 * **xref:../monitoring/monitoring-overview.adoc#monitoring-overview[Monitor clusters]**:
 Learn to  xref:../monitoring/configuring-the-monitoring-stack.adoc#configuring-the-monitoring-stack[configure the monitoring stack].

installing/disconnected_install/installing-mirroring-disconnected.adoc

@@ -69,7 +69,7 @@ include::modules/oc-mirror-creating-image-set-config.adoc[leveloffset=+1]
 
 * xref:../../installing/disconnected_install/installing-mirroring-disconnected.adoc#oc-mirror-imageset-config-params_installing-mirroring-disconnected[Image set configuration parameters]
 * xref:../../installing/disconnected_install/installing-mirroring-disconnected.adoc#oc-mirror-image-set-examples_installing-mirroring-disconnected[Image set configuration examples]
-* xref:../../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Using the OpenShift Update Service in a disconnected environment]
+* xref:../../updating/updating_a_cluster/updating_disconnected_cluster/disconnected-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Using the OpenShift Update Service in a disconnected environment]
 
 [id="mirroring-image-set"]
 == Mirroring an image set to a mirror registry
@@ -146,4 +146,4 @@ include::modules/oc-mirror-command-reference.adoc[leveloffset=+1]
 [id="additional-resources_installing-mirroring-disconnected"]
 == Additional resources
 
-* xref:../../updating/updating-restricted-network-cluster/index.adoc#about-restricted-network-updates[About cluster updates in a disconnected environment]
+* xref:../../updating/updating_a_cluster/updating_disconnected_cluster/index.adoc#about-restricted-network-updates[About cluster updates in a disconnected environment]

installing/installing_aws/manually-creating-iam.adoc

@@ -27,8 +27,7 @@ include::modules/manually-create-identity-access-management.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* xref:../../updating/updating-cluster-within-minor.adoc#manually-maintained-credentials-upgrade_updating-cluster-within-minor[Updating a cluster using the web console]
-* xref:../../updating/updating-cluster-cli.adoc#manually-maintained-credentials-upgrade_updating-cluster-cli[Updating a cluster using the CLI]
+* xref:../../updating/preparing-manual-creds-update.adoc#preparing-manual-creds-update[Preparing to update a cluster with manually maintained credentials]
 
 include::modules/mint-mode.adoc[leveloffset=+1]
 

installing/installing_azure/manually-creating-iam-azure.adoc

@@ -18,8 +18,7 @@ include::modules/manually-create-identity-access-management.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* xref:../../updating/updating-cluster-within-minor.adoc#manually-maintained-credentials-upgrade_updating-cluster-within-minor[Updating a cluster using the web console]
-* xref:../../updating/updating-cluster-cli.adoc#manually-maintained-credentials-upgrade_updating-cluster-cli[Updating a cluster using the CLI]
+* xref:../../updating/preparing-manual-creds-update.adoc#preparing-manual-creds-update[Preparing to update a cluster with manually maintained credentials]
 
 [id="manually-creating-iam-azure-next-steps"]
 == Next steps

installing/installing_azure_stack_hub/installing-azure-stack-hub-network-customizations.adoc

@@ -38,8 +38,8 @@ include::modules/manually-create-identity-access-management.adoc[leveloffset=+1]
 [role="_additional-resources"]
 [id="additional-resources_installing-azure-stack-hub-network-customizations-cco"]
 .Additional resources
-* xref:../../updating/updating-cluster-within-minor.adoc#manually-maintained-credentials-upgrade_updating-cluster-within-minor[Updating a cluster using the web console]
-* xref:../../updating/updating-cluster-cli.adoc#manually-maintained-credentials-upgrade_updating-cluster-cli[Updating a cluster using the CLI]
+* xref:../../updating/updating_a_cluster/updating-cluster-web-console.adoc#manually-maintained-credentials-upgrade_updating-cluster-web-console[Updating a cluster using the web console]
+* xref:../../updating/updating_a_cluster/updating-cluster-cli.adoc#manually-maintained-credentials-upgrade_updating-cluster-cli[Updating a cluster using the CLI]
 
 include::modules/azure-stack-hub-internal-ca.adoc[leveloffset=+1]
 

installing/installing_gcp/manually-creating-iam-gcp.adoc

@@ -22,8 +22,7 @@ include::modules/manually-create-identity-access-management.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* xref:../../updating/updating-cluster-within-minor.adoc#manually-maintained-credentials-upgrade_updating-cluster-within-minor[Updating a cluster using the web console]
-* xref:../../updating/updating-cluster-cli.adoc#manually-maintained-credentials-upgrade_updating-cluster-cli[Updating a cluster using the CLI]
+* xref:../../updating/preparing-manual-creds-update.adoc#preparing-manual-creds-update[Preparing to update a cluster with manually maintained credentials]
 
 include::modules/mint-mode.adoc[leveloffset=+1]
 

installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc

@@ -46,7 +46,7 @@ include::modules/vmware-csi-driver-reqs.adoc[leveloffset=+1]
 .Additional resources
 
 * To remove a third-party CSI driver, see xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.adoc#persistent-storage-csi-vsphere-install-issues_persistent-storage-csi-vsphere[Removing a third-party vSphere CSI Driver].
-* To update the hardware version for your vSphere nodes, see xref:../../updating/updating-hardware-on-nodes-running-on-vsphere.adoc#updating-hardware-on-nodes-running-on-vsphere[Updating hardware on nodes running in vSphere].
+* To update the hardware version for your vSphere nodes, see xref:../../updating/updating_a_cluster/updating-hardware-on-nodes-running-on-vsphere.adoc#updating-hardware-on-nodes-running-on-vsphere[Updating hardware on nodes running in vSphere].
 
 [id="installation-requirements-user-infra_{context}"]
 == Requirements for a cluster with user-provisioned infrastructure

installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc

@@ -34,7 +34,7 @@ include::modules/vmware-csi-driver-reqs.adoc[leveloffset=+1]
 .Additional resources
 
 * To remove a third-party CSI driver, see xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.adoc#persistent-storage-csi-vsphere-install-issues_persistent-storage-csi-vsphere[Removing a third-party vSphere CSI Driver].
-* To update the hardware version for your vSphere nodes, see xref:../../updating/updating-hardware-on-nodes-running-on-vsphere.adoc#updating-hardware-on-nodes-running-on-vsphere[Updating hardware on nodes running in vSphere].
+* To update the hardware version for your vSphere nodes, see xref:../../updating/updating_a_cluster/updating-hardware-on-nodes-running-on-vsphere.adoc#updating-hardware-on-nodes-running-on-vsphere[Updating hardware on nodes running in vSphere].
 
 [id="installation-requirements-user-infra_{context}"]
 == Requirements for a cluster with user-provisioned infrastructure

installing/installing_vmc/installing-vmc-user-infra.adoc

@@ -38,7 +38,7 @@ include::modules/vmware-csi-driver-reqs.adoc[leveloffset=+1]
 .Additional resources
 
 * To remove a third-party CSI driver, see xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.adoc#persistent-storage-csi-vsphere-install-issues_persistent-storage-csi-vsphere[Removing a third-party vSphere CSI Driver].
-* To update the hardware version for your vSphere nodes, see xref:../../updating/updating-hardware-on-nodes-running-on-vsphere.adoc#updating-hardware-on-nodes-running-on-vsphere[Updating hardware on nodes running in vSphere].
+* To update the hardware version for your vSphere nodes, see xref:../../updating/updating_a_cluster/updating-hardware-on-nodes-running-on-vsphere.adoc#updating-hardware-on-nodes-running-on-vsphere[Updating hardware on nodes running in vSphere].
 
 [id="installation-requirements-user-infra_{context}"]
 == Requirements for a cluster with user-provisioned infrastructure