1. Documentation
×

Understanding upgrade channels and releases

In OKD 4.1, Red Hat introduced the concept of channels for recommending the appropriate release versions for cluster updates. By controlling the pace of updates, these upgrade channels allow you to choose an update strategy. Upgrade channels are tied to a minor version of OKD. For instance, OKD 4.7 upgrade channels recommend updates to 4.7 and updates within 4.7. They also recommend updates within 4.6 and from 4.6 to 4.7, to allow clusters on 4.6 to eventually update to 4.7. They do not recommend updates to 4.8 or later releases. This strategy ensures that administrators explicitly decide to update to the next minor version of OKD.

Upgrade channels control only release selection and do not impact the version of the cluster that you install; the openshift-install binary file for a specific version of OKD always installs that version.

OKD 4.7 offers the following upgrade channel:

  • stable-4

Upgrade channels and release paths

Cluster administrators can configure the upgrade channel from the web console.

candidate-4.7 channel

The candidate-4.7 channel contains candidate builds for a z-stream (4.7.z) and previous minor version releases. Release candidates contain all the features of the product but are not supported. Use release candidate versions to test feature acceptance and assist in qualifying the next version of OKD. A release candidate is any build that is available in the candidate channel, including ones that do not contain a pre-release version such as -rc in their names. After a version is available in the candidate channel, it goes through more quality checks. If it meets the quality standard, it is promoted to the fast-4.7 or stable-4.7 channels. Because of this strategy, if a specific release is available in both the candidate-4.7 channel and in the fast-4.7 or stable-4.7 channels, it is a Red Hat-supported version. The candidate-4.7 channel can include release versions from which there are no recommended updates in any channel.

You can use the candidate-4.7 channel to update from a previous minor version of OKD.

fast-4.7 channel

The fast-4.7 channel is updated with new and previous minor versions of 4.7 as soon as Red Hat declares the given version as a general availability release. As such, these releases are fully supported, are production quality, and have performed well while available as a release candidate in the candidate-4.7 channel from where they were promoted. Some time after a release appears in the fast-4.7 channel, it is added to the stable-4.7 channel. Releases never appear in the stable-4.7 channel before they appear in the fast-4.7 channel.

You can use the fast-4.7 channel to update from a previous minor version of OKD.

stable-4 channel

Releases are added to the stable-4 channel after passing all tests.

You can use the stable-4 channel to update from a previous minor version of OKD.

Upgrade version paths

OKD maintains an upgrade recommendation service that understands the version of OKD you have installed as well as the path to take within the channel you choose to get you to the next release.

You can imagine seeing the following in the stable-4 channel:

  • 4.7.0

  • 4.7.1

  • 4.7.3

  • 4.7.4

The service recommends only update that have been tested and have no serious issues. It will not suggest updating to a version of OKD that contains known vulnerabilities. For example, if your cluster is on 4.7.1 and OKD suggests 4.7.4, then it is safe for you to update from 4.7.1 to 4.7.4. Do not rely on consecutive patch numbers. In this example, 4.7.2 is not and never was available in the channel.

The presence of an update recommendation in the stable-4 channel at any point is a declaration that the update is supported. While releases will never be removed from the channel, update recommendations that exhibit serious issues will be removed from the channel. Updates initiated after the update recommendation has been removed are still supported.