Menu Close

Chapter 1. Updating clusters overview

You can update a OpenShift Container Platform cluster with a single operation by using the web console or the OpenShift CLI (oc) with OpenShift Container Platform 4.

1.1. Understanding OpenShift Container Platform updates

About the OpenShift Update Service: For clusters with internet accessibility, Red Hat provides over-the-air updates through an OpenShift Container Platform update service as a hosted service located behind public APIs.

1.2. Understanding upgrade channels and releases

Upgrade channels and releases: Upgrade channels allow you to choose an upgrade strategy. Upgrade channels are connected to a minor version of OpenShift Container Platform. 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 OpenShift Container Platform always installs that version. For more information, see the following:

1.3. Preparing to perform an EUS-to-EUS update

Preparing to perform an EUS-to-EUS update: Due to fundamental Kubernetes design, all OpenShift Container Platform updates between minor versions must be serialized. You must update from OpenShift Container Platform 4.8 to 4.9, and then to 4.10. You cannot update from OpenShift Container Platform 4.8 to 4.10 directly. However, if you want to update between two Extended Update Support (EUS) versions, you can do so by incurring only a single reboot of non-master hosts. For more information, see the following item:

1.4. Updating a cluster using the web console

Updating a cluster within a minor version using the web console: You can update an OpenShift Container Platform cluster by using the web console. You can the update a cluster between minor versions. For more information, see the following items:

1.5. Updating a cluster within a minor version using the command-line interface (CLI)

Updating a cluster within a minor version using the CLI: You can update an OpenShift Container Platform cluster by using the oc. You can the update a cluster between minor versions. For more information, see the following actions:

1.6. Performing a canary rollout update

Performing a canary rollout update: By controlling rollout of an update to the worker nodes, you can ensure that mission-critical applications stay available during the whole update, even if the update process causes your applications to fail. Depending on your organizational needs, you might want to update a small subset of worker nodes, evaluate cluster and workload health over a period of time, and then update the remaining nodes. This is referred to as a canary update. Alternatively, you might also want to fit worker node updates, which often requires a host reboot, into smaller defined maintenance windows when it is not possible to take a large maintenance window to update the entire cluster at one time. You can perform the following actions:

1.7. Updating a cluster that includes RHEL compute machines

Updating a cluster that includes RHEL compute machines: You can update an OpenShift Container Platform cluster. If your cluster contains Red Hat Enterprise Linux (RHEL) machines, you must update those machines. You can perform the following actions:

1.8. Updating a restricted network cluster

Updating a restricted network cluster: A restricted network environment is one in which your cluster nodes cannot access the internet. You can update a restricted network OpenShift Container Platform cluster by using the oc. You can also update a restricted network OpenShift Container Platform cluster by using the OpenShift Update Service. For more information, see the following items:

1.9. Updating hardware on nodes running on vSphere

Updating hardware on vSphere: You must ensure that your nodes running in vSphere are running on the hardware version supported by OpenShift Container Platform. Currently, hardware version 13 or later is supported for vSphere virtual machines in a cluster. For more information, see the following information:

Important

Using hardware version 13 for your cluster nodes running on vSphere is now deprecated. This version is still fully supported, but support will be removed in a future version of OpenShift Container Platform. Hardware version 15 is now the default for vSphere virtual machines in OpenShift Container Platform.