Supported Versions of Kubernetes

When Container Engine for Kubernetes support for a new version of Kubernetes is announced, an older Kubernetes version ceases to be supported.

This topic lists:

Currently Supported Kubernetes Versions

Container Engine for Kubernetes supports three versions of Kubernetes for new clusters. For a minimum of 30 days after the release of a new Kubernetes version, Container Engine for Kubernetes continues to support the fourth, oldest available version.

Release Calendar

Container Engine for Kubernetes (OKE) supports the following versions of Kubernetes for new clusters:

Kubernetes Version Patch release supported by OKE Upstream Release Date Upstream End-of-life date OKE Release Date OKE End-of-life Date
1.24 1.24.1 2022-04-15 2023-09-29 2022-08-02 30 days after 1.27 OKE Release Date (planned)
1.23 1.23.4 2021-12-07 2023-02-28 2022-05-18 30 days after 1.26 OKE Release Date (planned)
1.22 1.22.5 2021-08-04 2022-10-28 2022-03-21 30 days after 1.25 OKE Release Date (planned)
1.21 1.21.5 2021-04-08 2022-06-28 2021-12-09 2022-10-13

Legal Disclaimer: The table is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, timing, and pricing of any features or functionality described for Oracle’s products may change and remains at the sole discretion of Oracle Corporation.

Notes about Container Engine for Kubernetes Support for Kubernetes Version 1.22

Note that Kubernetes version 1.22 stopped serving a number of deprecated Kubernetes APIs, including:

  • Webhook resources
  • CustomResourceDefinition
  • APIService
  • TokenReview
  • SubjectAccessReview resources
  • CertificateSigningRequest
  • Lease
  • Ingress
  • IngressClass
  • RBAC resources
  • PriorityClass
  • Storage resources

For more information about migrating from the deprecated APIs, see the Kubernetes Deprecated API Migration Guide.

Notes about Container Engine for Kubernetes Support for Kubernetes Version 1.20

With the announcement of support for Kubernetes version 1.20.8, the container runtime used by Container Engine for Kubernetes changes from Docker to CRI-O. However, you don't have to change any of your existing Docker images because Docker images are Open Container Initiative (OCI) compliant. As far as Kubernetes is concerned, all OCI-compliant images look the same.

Note the following:

  • CRI-O is an implementation of the Kubernetes Container Runtime Interface (CRI), which enables the use of OCI-compatible runtimes. CRI-O can pull your existing Docker images and run them on your Kubernetes version 1.20.8 clusters.
  • When using the Docker runtime, the default configuration captures the standard output and standard error streams of containers using the JSON format. In contrast, CRI-O uses the Logrus format. If you use a logging tool such as Fluentd or Fluent Bit, update the tool's configuration to use a new parser to parse CRI logs. For example:
  • You might have a workflow in a cluster that relies on the underlying docker socket /var/run/docker.sock (a pattern often referred to as Docker in Docker). Starting with Kubernetes version 1.20.8, such a workflow no longer functions.
  • If you previously used the Docker CLI to run commands on a host, you have to use crictl (a CLI for CRI-compatible container runtimes) instead.
  • The upstream Kubernetes project is deprecating Docker as a container runtime after Kubernetes version 1.20.

To find out more:

  • See the Kubernetes 1.20.8 Changelog for more information about Kubernetes 1.20.8
  • See the Dockershim Deprecation FAQ for more information about the deprecation of the dockershim adapter (which previously enabled the kubelet to interact with Docker as if Docker were a CRI-compatible runtime)

Planned Support for Future Kubernetes Versions

Container Engine for Kubernetes support is currently planned for the following future versions of Kubernetes. Note that future dates are subject to change without notice. In addition, note the Legal Disclaimer following the table.

Kubernetes Version Patch release supported by OKE Upstream Release Date Upstream End-of-life date OKE Release Date
1.25 To Be Confirmed 2022-08-23 To Be Confirmed November 2022 (planned)

Legal Disclaimer: The table is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, timing, and pricing of any features or functionality described for Oracle’s products may change and remains at the sole discretion of Oracle Corporation.

Previously Supported Kubernetes Versions

Container Engine for Kubernetes previously supported the following versions of Kubernetes:

Kubernetes Version Support Ended
1.20.11 July 19, 2022
1.20.8 November 7, 2021
1.19.15 April 22, 2022
1.19.12 November 7, 2021
1.19.7 August 13, 2021
1.18.10 February 9, 2022
1.17.13 September 8, 2021
1.17.9 April 17, 2021
1.16.15 April 17, 2021
1.15.12 February 2, 2021
1.15.7 February 2, 2021
1.14.8 December 15, 2020
1.13.x March 21, 2020
1.12.7 January 29, 2020
1.12.6 April 15, 2019
1.11.9 September 9, 2019
1.11.8 April 15, 2019
1.11.x versions prior to 1.11.8 March 13, 2019
1.10.x April 12, 2019
1.9.x December 11, 2019
1.8.x September 7, 2018