mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 21:46:22 +01:00
62 lines
2.1 KiB
Plaintext
62 lines
2.1 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * rosa_upgrading/rosa-upgrading.adoc
|
|
// * rosa_upgrading/rosa-upgrading-sts.adoc
|
|
|
|
ifeval::["{context}" == "rosa-upgrading-sts"]
|
|
:sts:
|
|
endif::[]
|
|
|
|
:_content-type: PROCEDURE
|
|
[id="rosa-upgrading-cli_{context}"]
|
|
= Upgrading with the rosa CLI
|
|
|
|
You can upgrade a {product-title} cluster
|
|
ifdef::sts[]
|
|
that uses the AWS Security Token Service (STS)
|
|
endif::sts[]
|
|
manually by using the `rosa` CLI.
|
|
|
|
This method schedules the cluster for an immediate upgrade, if a more recent version is available.
|
|
|
|
.Prerequisites
|
|
|
|
* You have installed and configured the latest ROSA CLI on your installation host.
|
|
ifdef::sts[]
|
|
* If you are upgrading your cluster from 4.7 to 4.8, you have upgraded the AWS Identity and Access Management (IAM) account-wide roles and policies to version 4.8. You have also updated the `cloudcredential.openshift.io/upgradeable-to` annotation in the `CloudCredential` custom resource.
|
|
endif::sts[]
|
|
|
|
.Procedure
|
|
|
|
. To verify the current version of your cluster, enter the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe cluster --cluster=<cluster_name|cluster_id> <1>
|
|
----
|
|
<1> Replace `<cluster_name|cluster_id>` with the cluster name or the ID of the cluster.
|
|
|
|
. To verify that an upgrade is available, enter the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ rosa list upgrade --cluster=<cluster_name|cluster_id>
|
|
----
|
|
+
|
|
The command returns a list of versions to which the cluster can be upgraded, including a recommended version.
|
|
|
|
. To upgrade a cluster to the latest available version, enter the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ rosa upgrade cluster --cluster=<cluster_name|cluster_id>
|
|
----
|
|
+
|
|
The cluster is scheduled for an immediate upgrade. This action can take an hour or longer, depending on your workload configuration, such as pod disruption budgets.
|
|
+
|
|
You will receive an email when the upgrade is complete. You can also check the status by running `rosa describe cluster` again from the `rosa` CLI or view the status in the OpenShift Cluster Manager (OCM) console.
|
|
|
|
ifeval::["{context}" == "rosa-upgrading-sts"]
|
|
:!sts:
|
|
endif::[]
|