Preparing to upgrade to OpenShift Container Platform 4.9
Disclaimer: Links contained herein to external website(s) are provided for convenience only. Red Hat has not reviewed the links and is not responsible for the content or its availability. The inclusion of any link to an external website does not imply endorsement by Red Hat of the website or their entities, products or services. You agree that Red Hat is not responsible or liable for any loss or expenses that may result due to your use of (or reliance on) the external site or content.
This article is part of series covering API removals and deprecations. See Navigating Kubernetes API deprecations and removals for more information on evaluating API usage and migrating away from these APIs.
OpenShift Container Platform 4.9 uses Kubernetes 1.22, which removed a significant number of deprecated v1beta1 APIs.
OpenShift Container Platform 4.8.14 introduced a requirement that an administrator must provide a manual acknowledgment before the cluster can be upgraded from OpenShift Container Platform 4.8 to 4.9. This is to help prevent issues after upgrading to OpenShift Container Platform 4.9, where APIs that have been removed are still in use by workloads, tools, or other components running on or interacting with the cluster. Administrators must evaluate their cluster for any APIs in use that will be removed and migrate the affected components to use the appropriate new API version. After this is done, the administrator can provide the administrator acknowledgment.
All clusters require this administrator acknowledgment before they can be upgraded to OpenShift Container Platform 4.9.
Removed Kubernetes APIs
Kubernetes 1.22 removed the following deprecated v1beta1 APIs. If your cluster, or any idle workloads or tools use any of these APIs, you must migrate them to the appropriate new version before upgrading to OpenShift Container Platform 4.9.
| Resource | API | Notable changes |
|---|---|---|
APIService | apiregistration.k8s.io/v1beta1 | No |
CertificateSigningRequest | certificates.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
ClusterRole | rbac.authorization.k8s.io/v1beta1 | No |
ClusterRoleBinding | rbac.authorization.k8s.io/v1beta1 | No |
CSIDriver | storage.k8s.io/v1beta1 | No |
CSINode | storage.k8s.io/v1beta1 | No |
CustomResourceDefinition | apiextensions.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
Ingress | extensions/v1beta1 | Content from kubernetes.io is not included.Yes |
Ingress | networking.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
IngressClass | networking.k8s.io/v1beta1 | No |
Lease | coordination.k8s.io/v1beta1 | No |
LocalSubjectAccessReview | authorization.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
MutatingWebhookConfiguration | admissionregistration.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
PriorityClass | scheduling.k8s.io/v1beta1 | No |
Role | rbac.authorization.k8s.io/v1beta1 | No |
RoleBinding | rbac.authorization.k8s.io/v1beta1 | No |
SelfSubjectAccessReview | authorization.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
SelfSubjectRulesReview | authorization.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
StorageClass | storage.k8s.io/v1beta1 | No |
SubjectAccessReview | authorization.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
TokenReview | authentication.k8s.io/v1beta1 | No |
ValidatingWebhookConfiguration | admissionregistration.k8s.io/v1beta1 | Content from kubernetes.io is not included.Yes |
VolumeAttachment | storage.k8s.io/v1beta1 | No |
Providing the administrator acknowledgement
IMPORTANT: See Navigating Kubernetes API deprecations and removals for information on evaluating API usage and migrating away from these removed APIs.
After you have evaluated your cluster for any removed APIs and have migrated any removed APIs, you can acknowledge that your cluster is ready to upgrade to OpenShift Container Platform 4.9.
Note: This method of acknowledgement does not apply to OpenShift Dedicated (OSD) or Red Hat OpenShift Service on AWS (ROSA). Please refer to the relevant KCS for OSD and for ROSA.
WARNING: Be aware that all responsibility falls on the administrator to ensure that all uses of removed APIs have been resolved and migrated as necessary before providing this administrator acknowledgment. OpenShift Container Platform can assist with the evaluation, but cannot identify all possible uses of removed APIs, especially idle workloads or external tools.
To acknowledge that you have completed the evaluation and your cluster is ready to upgrade to OpenShift Container Platform 4.9, run the following command:
$ oc -n openshift-config patch cm admin-acks --patch '{"data":{"ack-4.8-kube-1.22-api-removals-in-4.9":"true"}}' --type=merge
Note: You must have access to the cluster as a user with the
cluster-adminrole in order to run this command.
Your cluster is now ready to be upgraded to OpenShift Container Platform 4.9.