Skip to content

Commit 3ef6e26

Browse files
committed
OSDOCS-6618: Update availability FAQ
1 parent 608c9f6 commit 3ef6e26

File tree

2 files changed

+72
-0
lines changed

2 files changed

+72
-0
lines changed

modules/update-availability-faq.adoc

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * updating/understanding-openshift-updates.adoc
4+
5+
:_content-type: CONCEPT
6+
[id="update-availability_{context}"]
7+
= Common questions about update availability
8+
9+
There are several factors that affect if and when an update is made available to an {product-title} cluster. The following list provides common questions regarding the availability of an update:
10+
11+
[id="channel-differences_{context}"]
12+
*What are the differences between each of the update channels?*
13+
14+
* A new release is initially added to the `candidate` channel.
15+
16+
* After successful final testing, a release on the `candidate` channel is promoted to the `fast` channel, an errata is published, and the release is now fully supported.
17+
18+
* After a delay, a release on the `fast` channel is finally promoted to the `stable` channel. This delay represents the only difference between the `fast` and `stable` channels.
19+
+
20+
[NOTE]
21+
====
22+
For the latest z-stream releases, this delay may generally be a week or two. However, the delay for initial updates to the latest minor version may take much longer, generally 45-90 days.
23+
====
24+
25+
* Releases promoted to the `stable` channel are simultaneously promoted to the `eus` channel.
26+
The primary purpose of the `eus` channel is to serve as a convenience for clusters performing an EUS-to-EUS update.
27+
28+
[id="channel-safety_{context}"]
29+
*Is a release on the `stable` channel safer or more supported than a release on the `fast` channel?*
30+
31+
* If a regression is identified for a release on a `fast` channel, it will be resolved and managed to the same extent as if that regression was identified for a release on the `stable` channel.
32+
33+
* The only difference between releases on the `fast` and `stable` channels is that a release only appears on the `stable` channel after it has been on the `fast` channel for some time, which provides more time for new update risks to be discovered.
34+
35+
[id="supported-updates_{context}"]
36+
*What does it mean if an update is supported but not recommended?*
37+
38+
* Red Hat continuously evaluates data from multiple sources to determine whether updates from one version to another lead to issues.
39+
If an issue is identified, an update path may no longer be recommended to users.
40+
However, even if the update path is not recommended, customers are still supported if they perform the update.
41+
42+
* Red Hat does not block users from updating to a certain version.
43+
Red Hat may declare conditional update risks, which may or may not apply to a particular cluster.
44+
45+
** Declared risks provide cluster administrators more context about a supported update.
46+
Cluster administrators can still accept the risk and update to that particular target version.
47+
This update is always supported despite not being recommended in the context of the conditional risk.
48+
49+
[id="removed-recommendation_{context}"]
50+
*What if I see that an update to a particular release is no longer recommended?*
51+
52+
* If Red Hat removes update recommendations from any supported release due to a regression, a superseding update recommendation will be provided to a future version that corrects the regression.
53+
There may be a delay while the defect is corrected, tested, and promoted to your selected channel.
54+
55+
[id="z-stream-release-cadence_{context}"]
56+
*How long until the next z-stream release is made available on the fast and stable channels?*
57+
58+
* While the specific cadence can vary based on a number of factors, new z-stream releases for the latest minor version are typically made available about every week. Older minor versions, which have become more stable over time, may take much longer for new z-stream releases to be made available.
59+
+
60+
[IMPORTANT]
61+
====
62+
These are only estimates based on past data about z-stream releases. Red Hat reserves the right to change the release frequency as needed. Any number of issues could cause irregularities and delays in this release cadence.
63+
====
64+
65+
* Once a z-stream release is published, it also appears in the `fast` channel for that minor version. After a delay, the z-stream release may then appear in that minor version's `stable` channel.

updating/understanding_updates/intro-to-updates.adoc

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,13 @@ As the CVO applies a manifest to a cluster Operator, the Operator might perform
2828
The CVO monitors the state of each applied resource and the states reported by all cluster Operators. The CVO only proceeds with the update when all manifests and cluster Operators in the active Runlevel reach a stable condition.
2929
After the CVO updates the entire control plane through this process, the Machine Config Operator (MCO) updates the operating system and configuration of every node in the cluster.
3030

31+
include::modules/update-availability-faq.adoc[leveloffset=+1]
32+
33+
[role="_additional-resources"]
34+
.Additional resources
35+
36+
* xref:../../updating/understanding-upgrade-channels-release.adoc#understanding-upgrade-channels-releases[Understanding update channels and releases]
37+
3138
include::modules/update-service-overview.adoc[leveloffset=+1]
3239

3340
include::modules/update-common-terms.adoc[leveloffset=+1]

0 commit comments

Comments
 (0)