mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 21:46:22 +01:00
140 lines
6.9 KiB
Plaintext
140 lines
6.9 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * updating/understanding_updates/how-updates-work.adoc
|
|
|
|
:_mod-docs-content-type: CONCEPT
|
|
[id="update-cluster-version-object_{context}"]
|
|
= The ClusterVersion object
|
|
|
|
One of the resources that the Cluster Version Operator (CVO) monitors is the `ClusterVersion` resource.
|
|
|
|
Administrators and OpenShift components can communicate or interact with the CVO through the `ClusterVersion` object.
|
|
The desired CVO state is declared through the `ClusterVersion` object and the current CVO state is reflected in the object's status.
|
|
|
|
[NOTE]
|
|
====
|
|
Do not directly modify the `ClusterVersion` object. Instead, use interfaces such as the `oc` CLI or the web console to declare your update target.
|
|
====
|
|
|
|
The CVO continually reconciles the cluster with the target state declared in the `spec` property of the `ClusterVersion` resource.
|
|
When the desired release differs from the actual release, that reconciliation updates the cluster.
|
|
|
|
//to-do: this might be heading overload, consider deleting this heading if the context switch from the previous paragraph to this content is smooth enough to not require one.
|
|
|
|
== Update availability data
|
|
|
|
The `ClusterVersion` resource also contains information about updates that are available to the cluster.
|
|
This includes updates that are available, but not recommended due to a known risk that applies to the cluster.
|
|
These updates are known as conditional updates.
|
|
To learn how the CVO maintains this information about available updates in the `ClusterVersion` resource, see the "Evaluation of update availability" section.
|
|
|
|
* You can inspect all available updates with the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc adm upgrade --include-not-recommended
|
|
----
|
|
+
|
|
[NOTE]
|
|
====
|
|
The additional `--include-not-recommended` parameter includes updates that are available with known issues that apply to the cluster.
|
|
====
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
Cluster version is 4.13.40
|
|
|
|
Upstream is unset, so the cluster will use an appropriate default.
|
|
Channel: stable-4.14 (available channels: candidate-4.13, candidate-4.14, eus-4.14, fast-4.13, fast-4.14, stable-4.13, stable-4.14)
|
|
|
|
Recommended updates:
|
|
|
|
VERSION IMAGE
|
|
4.14.27 quay.io/openshift-release-dev/ocp-release@sha256:4d30b359aa6600a89ed49ce6a9a5fdab54092bcb821a25480fdfbc47e66af9ec
|
|
4.14.26 quay.io/openshift-release-dev/ocp-release@sha256:4fe7d4ccf4d967a309f83118f1a380a656a733d7fcee1dbaf4d51752a6372890
|
|
4.14.25 quay.io/openshift-release-dev/ocp-release@sha256:a0ef946ef8ae75aef726af1d9bbaad278559ad8cab2c1ed1088928a0087990b6
|
|
4.14.24 quay.io/openshift-release-dev/ocp-release@sha256:0a34eac4b834e67f1bca94493c237e307be2c0eae7b8956d4d8ef1c0c462c7b0
|
|
4.14.23 quay.io/openshift-release-dev/ocp-release@sha256:f8465817382128ec7c0bc676174bad0fb43204c353e49c146ddd83a5b3d58d92
|
|
4.13.42 quay.io/openshift-release-dev/ocp-release@sha256:dcf5c3ad7384f8bee3c275da8f886b0bc9aea7611d166d695d0cf0fff40a0b55
|
|
4.13.41 quay.io/openshift-release-dev/ocp-release@sha256:dbb8aa0cf53dc5ac663514e259ad2768d8c82fd1fe7181a4cfb484e3ffdbd3ba
|
|
|
|
Updates with known issues:
|
|
|
|
Version: 4.14.22
|
|
Image: quay.io/openshift-release-dev/ocp-release@sha256:7093fa606debe63820671cc92a1384e14d0b70058d4b4719d666571e1fc62190
|
|
Reason: MultipleReasons
|
|
Message: Exposure to AzureRegistryImageMigrationUserProvisioned is unknown due to an evaluation failure: client-side throttling: only 18.061µs has elapsed since the last match call completed for this cluster condition backend; this cached cluster condition request has been queued for later execution
|
|
In Azure clusters with the user-provisioned registry storage, the in-cluster image registry component may struggle to complete the cluster update. https://issues.redhat.com/browse/IR-468
|
|
|
|
Incoming HTTP requests to services exposed by Routes may fail while routers reload their configuration, especially when made with Apache HTTPClient versions before 5.0. The problem is more likely to occur in clusters with higher number of Routes and corresponding endpoints. https://issues.redhat.com/browse/NE-1689
|
|
|
|
Version: 4.14.21
|
|
Image: quay.io/openshift-release-dev/ocp-release@sha256:6e3fba19a1453e61f8846c6b0ad3abf41436a3550092cbfd364ad4ce194582b7
|
|
Reason: MultipleReasons
|
|
Message: Exposure to AzureRegistryImageMigrationUserProvisioned is unknown due to an evaluation failure: client-side throttling: only 33.991µs has elapsed since the last match call completed for this cluster condition backend; this cached cluster condition request has been queued for later execution
|
|
In Azure clusters with the user-provisioned registry storage, the in-cluster image registry component may struggle to complete the cluster update. https://issues.redhat.com/browse/IR-468
|
|
|
|
Incoming HTTP requests to services exposed by Routes may fail while routers reload their configuration, especially when made with Apache HTTPClient versions before 5.0. The problem is more likely to occur in clusters with higher number of Routes and corresponding endpoints. https://issues.redhat.com/browse/NE-1689
|
|
----
|
|
+
|
|
The `oc adm upgrade` command queries the `ClusterVersion` resource for information about available updates and presents it in a human-readable format.
|
|
|
|
* One way to directly 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": [...]
|
|
},
|
|
...
|
|
]
|
|
---- |