4.17 version information and update actions
Review information about version 4.17 of Red Hat OpenShift on IBM Cloud. This version is based on Kubernetes version 1.30.
Looking for general information about updating clusters, or information on a different version? See Red Hat Red Hat OpenShift on IBM Cloud version information and the version 4.17 release notes.
Red Hat OpenShift on IBM Cloud is a Certified Kubernetes product for version 1.30 under the CNCF Kubernetes Software Conformance Certification program. Kubernetes® is a registered trademark of The Linux Foundation in the United States and other countries, and is used pursuant to a license from The Linux Foundation.
Release timeline
The following table includes the expected release timeline for version 4.17. You can use this information for planning purposes, such as to estimate the general time that the version might become unsupported.
Dates that are marked with a dagger (†
) are tentative and subject to change.
Supported? | Red Hat OpenShift / Kubernetes version | Release date | Unsupported date |
---|---|---|---|
Supported | 4.17 / 1.30 | 20 November 2024 | 26 August 2026† |
Preparing to update
Review changes that you might need to make when you update a cluster to version 4.17. This information summarizes updates that are likely to have an impact on deployed apps when you update.
Update before master
The following table shows the actions that you must take before you update the cluster master.
For clusters that run version 4.17 or later, you can use the oc adm upgrade status
command to check the update status of your cluster master during a master version update. For more information, see Viewing cluster upgrade status with the oc adm upgrade status
command.
Type | Description |
---|---|
Preparing to update OpenShift | For more information, review the Preparing to update to OpenShift Container Platform 4.17 for possible actions required. The etcd backup and version selection upgrade preparation actions do not apply to Red Hat OpenShift on IBM Cloud clusters since both of these actions are handled for you. |
Deprecated and removed OpenShift features | For more information, review the OpenShift Container Platform version 4.17 deprecated and removed features for possible actions required. |
Known OpenShift issues | For more information, review the OpenShift Container Platform version 4.17 known issues for possible actions required. |
Upgrade requires OpenShift cluster version currency | A cluster master upgrade will be cancelled if the OpenShift cluster version status indicates that an update is already in progress. See Why does OpenShift show the cluster version is not up to date? for details. |
Upgrade requires resolution to OpenShift cluster version upgradeable conditions | A cluster master upgrade will be cancelled if the OpenShift cluster version Upgradeable status condition indicates that the cluster is not upgradeable. To determine if the cluster is upgradeable, see Checking the Upgradeable status of your cluster. |
RHEL 9.2 micro-architecture requirement | Red Hat OpenShift on IBM Cloud version 4.17 is based on the RHEL 9.2 host operating system thus increasing the micro-architecture requirements to x86-64-v2. As a result, host machines for IBM Cloud Satellite must support x86-64-v2 architecture for any location that contains a Red Hat OpenShift on IBM Cloud
version 4.17 cluster. See Host system requirements for details. In addition, client machines used to run oc client version 4.17 must also support x86-64-v2 architecture.
Client machines, such as Ubuntu 20, that do not meet this micro-architecture requirement must use a RHEL 8 based oc version 4.17 client. Review the list of available oc version 4.17 clients |
RHEL 9 is the default operating system | RHEL 9 is now the default operating system for Red Hat OpenShift on IBM Cloud version 4.17 Classic or VPC clusters. Upgrading a cluster to version 4.17 does not change the operating system for an existing worker pool. For more information and possible migration actions related to RHEL 9, see Migrating to a new Red Hat Enterprise Linux version. |
Node label node-role.kubernetes.io/master removed |
VPC clusters with CoreOS enabled no longer set the node-role.kubernetes.io/master node label for version 4.17 worker nodes. If your apps rely on this node label, update them accordingly. |
Checking the Upgradeable
status of your cluster
Run the following command to check the Upgradeable
status of your cluster.
oc get clusterversion version -o json | jq '.status.conditions[] | select(.type == "Upgradeable")'
Example output where the Upgradeable
status is False
.
{
"lastTransitionTime": "2024-11-17T19:29:34Z",
"message": "Cluster operator operator-lifecycle-manager should not be upgraded between minor versions: ClusterServiceVersions blocking cluster upgrade: default/test is incompatible with OpenShift minor versions greater than 4.16",
"reason": "IncompatibleOperatorsInstalled",
"status": "False",
"type": "Upgradeable"
}
If the Upgradeable
status is False
, the condition information provides instructions that must be followed before upgrading.
RHEL 9
RHEL 9 is available for Classic or VPC clusters that run version 4.17.
You can provision a new cluster with RHEL 9 in the console by specifying the RHEL operating system for your worker node flavor or in the CLI by
including the --operating-system REDHAT_9_64
option when you run the ibmcloud oc cluster create
command.
If you upgrade an existing cluster to version 4.17 and want your worker nodes to run RHEL 9, you must follow the steps to migrate your worker nodes.
For more information on RHEL 9, see the Red Hat OpenShift release notes.