mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 21:46:22 +01:00
198 lines
5.1 KiB
Plaintext
198 lines
5.1 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * updating/updating-cluster-cli.adoc
|
|
// * updating/updating-cluster-rhel-compute.adoc
|
|
|
|
:_content-type: PROCEDURE
|
|
[id="update-upgrading-cli_{context}"]
|
|
= Updating a cluster by using the CLI
|
|
|
|
If updates are available, you can update your cluster by using the
|
|
OpenShift CLI (`oc`).
|
|
|
|
You can find information about available {product-title} advisories and updates
|
|
link:https://access.redhat.com/downloads/content/290[in the errata section]
|
|
of the Customer Portal.
|
|
|
|
.Prerequisites
|
|
|
|
* Install the OpenShift CLI (`oc`) that matches the version for your updated version.
|
|
* Log in to the cluster as user with `cluster-admin` privileges.
|
|
* Install the `jq` package.
|
|
* Pause all `MachineHealthCheck` resources.
|
|
|
|
.Procedure
|
|
|
|
. Ensure that your cluster is available:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
NAME VERSION AVAILABLE PROGRESSING SINCE STATUS
|
|
version 4.8.13 True False 158m Cluster version is 4.8.13
|
|
----
|
|
|
|
. Review the current update channel information and confirm that your channel
|
|
is set to `stable-4.9`:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion -o json|jq ".items[0].spec"
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
{
|
|
"channel": "stable-4.9",
|
|
"clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff"
|
|
}
|
|
----
|
|
+
|
|
[IMPORTANT]
|
|
====
|
|
For production clusters, you must subscribe to a `stable-\*` or `fast-*` channel.
|
|
====
|
|
|
|
. View the available updates and note the version number of the update that
|
|
you want to apply:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc adm upgrade
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
Cluster version is 4.8.13
|
|
|
|
Updates:
|
|
|
|
VERSION IMAGE
|
|
4.9.0 quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b
|
|
----
|
|
|
|
. Apply an update:
|
|
** To update to the latest version:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc adm upgrade --to-latest=true <1>
|
|
----
|
|
|
|
** To update to a specific version:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc adm upgrade --to=<version> <1>
|
|
----
|
|
<1> `<version>` is the update version that you obtained from the output of the
|
|
previous command.
|
|
|
|
. Review the status of the Cluster Version Operator:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion -o json|jq ".items[0].spec"
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
{
|
|
"channel": "stable-4.9",
|
|
"clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff",
|
|
"desiredUpdate": {
|
|
"force": false,
|
|
"image": "quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b",
|
|
"version": "4.9.0" <1>
|
|
}
|
|
}
|
|
----
|
|
<1> If the `version` number in the `desiredUpdate` stanza matches the value that
|
|
you specified, the update is in progress.
|
|
|
|
. Review the cluster version status history to monitor the status of the update.
|
|
It might take some time for all the objects to finish updating.
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion -o json|jq ".items[0].status.history"
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
[
|
|
{
|
|
"completionTime": null,
|
|
"image": "quay.io/openshift-release-dev/ocp-release@sha256:b8fa13e09d869089fc5957c32b02b7d3792a0b6f36693432acc0409615ab23b7",
|
|
"startedTime": "2021-01-28T20:30:50Z",
|
|
"state": "Partial",
|
|
"verified": true,
|
|
"version": "4.9.0"
|
|
},
|
|
{
|
|
"completionTime": "2021-01-28T20:30:50Z",
|
|
"image": "quay.io/openshift-release-dev/ocp-release@sha256:b8fa13e09d869089fc5957c32b02b7d3792a0b6f36693432acc0409615ab23b7",
|
|
"startedTime": "2021-01-28T17:38:10Z",
|
|
"state": "Completed",
|
|
"verified": false,
|
|
"version": "4.8.13"
|
|
}
|
|
]
|
|
----
|
|
+
|
|
The history contains a list of the most recent versions applied to the cluster.
|
|
This value is updated when the CVO applies an update. The list is ordered by
|
|
date, where the newest update is first in the list. Updates in the history have
|
|
state `Completed` if the rollout completed and `Partial` if the update failed
|
|
or did not complete.
|
|
+
|
|
[IMPORTANT]
|
|
====
|
|
If an upgrade fails, the Operator stops and reports the status of the failing
|
|
component. Rolling your cluster back to a previous version is not supported.
|
|
If your upgrade fails, contact Red Hat support.
|
|
====
|
|
|
|
. After the update completes, you can confirm that the cluster version has
|
|
updated to the new version:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
NAME VERSION AVAILABLE PROGRESSING SINCE STATUS
|
|
version 4.9.0 True False 2m Cluster version is 4.9.0
|
|
----
|
|
|
|
. If you are upgrading your cluster to the next minor version, like version 4.y to 4.(y+1), it is recommended to confirm your nodes are upgraded before deploying workloads that rely on a new feature:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get nodes
|
|
----
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
NAME STATUS ROLES AGE VERSION
|
|
ip-10-0-168-251.ec2.internal Ready master 82m v1.23.0
|
|
ip-10-0-170-223.ec2.internal Ready master 82m v1.23.0
|
|
ip-10-0-179-95.ec2.internal Ready worker 70m v1.23.0
|
|
ip-10-0-182-134.ec2.internal Ready worker 70m v1.23.0
|
|
ip-10-0-211-16.ec2.internal Ready master 82m v1.23.0
|
|
ip-10-0-250-100.ec2.internal Ready worker 69m v1.23.0
|
|
----
|