1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00

upgrade hcp cluster through console procedure

added in conditions and attributes

changed attributes

applying statements

applied second :

removed second node drain

added ifeval for hcp-in-rosa

added commented out line to explain new ifeval for hcp-in-rosa

applied peer review suggestions

removed conditions to make ROSA cluster agnostic
This commit is contained in:
Frances_McDonald
2024-11-28 12:56:26 +00:00
committed by openshift-cherrypick-robot
parent ee5c17d313
commit 4b143f67ce
4 changed files with 33 additions and 7 deletions

View File

@@ -3,7 +3,7 @@
// * upgrading/rosa_upgrading/rosa-upgrading-sts.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-deleting-cluster-upgrade-ocm_{context}"]
= Deleting a ROSA cluster upgrade with the {cluster-manager} console
= Deleting an upgrade with the {cluster-manager} console
You can use the {cluster-manager} console to delete a scheduled upgrade.

View File

@@ -31,6 +31,11 @@ When your hosted control plane upgrade is complete, you can upgrade one or more
endif::[]
//END WHOLE CLUSTER condition
[NOTE]
====
Machine pool configurations such as node drain timeout, max-unavailable, and max-surge can affect the timing and success of upgrades.
====
.Procedure
. Verify the current version of your cluster by running the following command:
+
@@ -85,7 +90,7 @@ Do not upgrade your machine pool to a version higher than your control plane. If
+
[source,terminal]
----
$ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>
$ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>
----
+
.Example output

View File

@@ -3,6 +3,14 @@
// * rosa_upgrading/rosa-upgrading.adoc
// * rosa_upgrading/rosa-upgrading-sts.adoc
// adding this ifeval hcp-in-rosa when a hcp procedure appears in the rosa distro as well as the hcp distro
ifdef::openshift-rosa[]
ifeval::["{context}" == "rosa-hcp-upgrading"]
:hcp-in-rosa:
endif::[]
endif::openshift-rosa[]
ifeval::["{context}" == "rosa-upgrading-sts"]
:sts:
endif::[]
@@ -11,7 +19,7 @@ endif::[]
[id="rosa-upgrade-ocm_{context}"]
= Upgrading with the {cluster-manager} console
You can schedule upgrades for a ROSA (classic architecture) cluster manually either one time or on a recurring schedule by using {cluster-manager} console.
You can schedule upgrades for a ROSA cluster manually either one time or on a recurring schedule by using {cluster-manager} console.
.Procedure
@@ -20,20 +28,20 @@ You can schedule upgrades for a ROSA (classic architecture) cluster manually eit
. Click the *Settings* tab.
. In the *Update strategy* pane, select which type of update you want:
** For individual updates, you can request the upgrade either immediately (to start within an hour) or at a future time.
** For recurring updates, choose a recurring date and time to start the upgrade automatically to the latest x.y.Z (z-stream) version available.
** For recurring updates, select a recurring date and time to start the upgrade automatically to the latest x.y.Z (z-stream) version available.
+
[IMPORTANT]
====
Recurring updates are applicable only for z-stream updates. Minor version or y-stream updates need to be done manually. You will be notified when a new y-stream update is available.
====
+
ifndef::hcp-in-rosa,openshift-rosa-hcp[]
. Optional: In the *Node draining* pane, select a grace period interval from the list. The grace period enables the nodes to gracefully drain before forcing the pod eviction. The default is *1 hour*.
+
[IMPORTANT]
====
You cannot change the node drain grace period after you start the upgrade process.
====
+
endif::[]
. In the *Update strategy* pane, click *Save* to apply your update strategy.
. In the *Update status* pane, review the *Update available* information and click *Update*.
+
@@ -60,4 +68,12 @@ The cluster is scheduled for an upgrade to the target version. This action can t
The status is displayed in the *Update status* pane.
.Troubleshooting
* Sometimes a scheduled upgrade does not trigger. See link:https://access.redhat.com/solutions/6648291[Upgrade maintenance cancelled] for more information.
* Sometimes a scheduled upgrade does not trigger. See link:https://access.redhat.com/solutions/6648291[Upgrade maintenance cancelled] for more information.
ifeval::["{context}" == "rosa-upgrading-sts"]
:!sts:
endif::[]
ifeval::["{context}" == "rosa-hcp-upgrading"]
:!hcp-in-rosa:
endif::[]

View File

@@ -65,3 +65,8 @@ ifndef::prevcontext[:!context:]
//LB: Remove until here if we don't want the "whole cluster" upgrade section
include::modules/rosa-hcp-upgrading-cli-tutorial.adoc[leveloffset=+1]
include::modules/rosa-upgrading-manual-ocm.adoc[leveloffset=+1]
include::modules/rosa-deleting-cluster-upgrade-ocm.adoc[leveloffset=+1]