mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-06 06:46:26 +01:00
115 lines
5.0 KiB
Plaintext
115 lines
5.0 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * updating/understanding_updates/how-updates-work.adoc
|
|
|
|
:_content-type: CONCEPT
|
|
[id="update-evaluate-availability_{context}"]
|
|
= Evaluation of update availability
|
|
|
|
The Cluster Version Operator (CVO) periodically queries the OpenShift Update Service (OSUS) for the most recent data about update possibilities.
|
|
This data is based on the cluster's subscribed channel.
|
|
The CVO then saves information about update recommendations into either the `availableUpdates` or `conditionalUpdates` field of its `ClusterVersion` resource.
|
|
|
|
The CVO periodically checks the conditional updates for update risks.
|
|
These risks are conveyed through the data served by the OSUS, which contains information for each version about known issues that might affect a cluster updated to that version.
|
|
Most risks are limited to clusters with specific characteristics, such as clusters with a certain size or clusters that are deployed in a particular cloud platform.
|
|
|
|
The CVO continuously evaluates its cluster characteristics against the conditional risk information for each conditional update. If the CVO finds that the cluster matches the criteria, the CVO stores this information in the `conditionalUpdates` field of its `ClusterVersion` resource.
|
|
If the CVO finds that the cluster does not match the risks of an update, or that there are no risks associated with the update, it stores the target version in the `availableUpdates` field of its `ClusterVersion` resource.
|
|
|
|
The user interface, either the web console or the OpenShift CLI (`oc`), presents this information in sectioned headings to the administrator.
|
|
Each *supported but not recommended* update recommendation contains a link to further resources about the risk so that the administrator can make an informed decision about the update.
|
|
|
|
You can inspect all available updates with the following command:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc adm upgrade --include-not-recommended
|
|
----
|
|
|
|
The additional `--include-not-recommended` parameter includes updates that are available but not recommended due to a known risk that applies to the cluster.
|
|
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
Cluster version is 4.10.22
|
|
|
|
Upstream is unset, so the cluster will use an appropriate default.
|
|
Channel: fast-4.11 (available channels: candidate-4.10, candidate-4.11, eus-4.10, fast-4.10, fast-4.11, stable-4.10)
|
|
|
|
Recommended updates:
|
|
|
|
VERSION IMAGE
|
|
4.10.26 quay.io/openshift-release-dev/ocp-release@sha256:e1fa1f513068082d97d78be643c369398b0e6820afab708d26acda2262940954
|
|
4.10.25 quay.io/openshift-release-dev/ocp-release@sha256:ed84fb3fbe026b3bbb4a2637ddd874452ac49c6ead1e15675f257e28664879cc
|
|
4.10.24 quay.io/openshift-release-dev/ocp-release@sha256:aab51636460b5a9757b736a29bc92ada6e6e6282e46b06e6fd483063d590d62a
|
|
4.10.23 quay.io/openshift-release-dev/ocp-release@sha256:e40e49d722cb36a95fa1c03002942b967ccbd7d68de10e003f0baa69abad457b
|
|
|
|
Supported but not recommended updates:
|
|
|
|
Version: 4.11.0
|
|
Image: quay.io/openshift-release-dev/ocp-release@sha256:300bce8246cf880e792e106607925de0a404484637627edf5f517375517d54a4
|
|
Recommended: False
|
|
Reason: RPMOSTreeTimeout
|
|
Message: Nodes with substantial numbers of containers and CPU contention may not reconcile machine configuration https://bugzilla.redhat.com/show_bug.cgi?id=2111817#c22
|
|
----
|
|
|
|
One way to inspect the underlying availability data created by the CVO is by querying the `ClusterVersion` resource with the following command:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion version -o json | jq '.status.availableUpdates'
|
|
----
|
|
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
[
|
|
{
|
|
"channels": [
|
|
"candidate-4.11",
|
|
"candidate-4.12",
|
|
"fast-4.11",
|
|
"fast-4.12"
|
|
],
|
|
"image": "quay.io/openshift-release-dev/ocp-release@sha256:400267c7f4e61c6bfa0a59571467e8bd85c9188e442cbd820cc8263809be3775",
|
|
"url": "https://access.redhat.com/errata/RHBA-2023:3213",
|
|
"version": "4.11.41"
|
|
},
|
|
...
|
|
]
|
|
----
|
|
|
|
A similar command can be used to check conditional updates:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ oc get clusterversion version -o json | jq '.status.conditionalUpdates'
|
|
----
|
|
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
[
|
|
{
|
|
"conditions": [
|
|
{
|
|
"lastTransitionTime": "2023-05-30T16:28:59Z",
|
|
"message": "The 4.11.36 release only resolves an installation issue https://issues.redhat.com//browse/OCPBUGS-11663 , which does not affect already running clusters. 4.11.36 does not include fixes delivered in recent 4.11.z releases and therefore upgrading from these versions would cause fixed bugs to reappear. Red Hat does not recommend upgrading clusters to 4.11.36 version for this reason. https://access.redhat.com/solutions/7007136",
|
|
"reason": "PatchesOlderRelease",
|
|
"status": "False",
|
|
"type": "Recommended"
|
|
}
|
|
],
|
|
"release": {
|
|
"channels": [...],
|
|
"image": "quay.io/openshift-release-dev/ocp-release@sha256:8c04176b771a62abd801fcda3e952633566c8b5ff177b93592e8e8d2d1f8471d",
|
|
"url": "https://access.redhat.com/errata/RHBA-2023:1733",
|
|
"version": "4.11.36"
|
|
},
|
|
"risks": [...]
|
|
},
|
|
...
|
|
]
|
|
----
|