eks-distro

README

EKS Distro Repository

---

Release	Development Build Status
1-28
1-29
1-30
1-31
1-32
1-33

Amazon EKS Distro (EKS-D) is a Kubernetes distribution based on and used by Amazon Elastic Kubernetes Service (EKS) to create reliable and secure Kubernetes clusters. With EKS-D, you can rely on the same versions of Kubernetes and its dependencies deployed by Amazon EKS. This includes the latest upstream updates, as well as extended security patching support. EKS-D follows the same Kubernetes version release cycle as Amazon EKS, and we provide the bits here. EKS-D offers the same software that has enabled tens of thousands of Kubernetes clusters on Amazon EKS.

This GitHub repository has everything required to build the components that make up the EKS Distro from source.

DEPRECATION NOTICE

As part of an effort to streamline the maintenance of EKS-D, we will be deprecating the metrics-server and CSI sidecar projects from EKS-D. Releases for new versions will no longer be created after the dates listed below. EKS-D no longer uses these projects, and it does not make sense to continue building them. The remaining projects in EKS-D will continue to be built for the time being. Additionally, The infrastructure for building EKS-D from source code will no longer be maintained, including project directories and build scripts. However, we will continue to publish all EKS-D images and artifacts to their current repositories and destinations. Users can still access and use all released EKS-D components as before.

metrics-server project deprecation: as of 1/16/2025

csi sidecar projects deprecation: as of 3/31/2025

Find the csi sidecar images at their new location here - https://gallery.ecr.aws/csi-components

Please open an issue if you have any concerns.

Releases

Full documentation for releases can be found on https://distro.eks.amazonaws.com.

To receive notifications about new EKS-D releases, subscribe to the EKS-D updates SNS topic: arn:aws:sns:us-east-1:379412251201:eks-distro-updates

Kubernetes 1-33

Release	Manifest	Kubernetes Version
13	v1-33-eks-13	v1.33.4

Kubernetes 1-32

Release	Manifest	Kubernetes Version
23	v1-32-eks-23	v1.32.8

Kubernetes 1-31

Release	Manifest	Kubernetes Version
30	v1-31-eks-30	v1.31.12

Kubernetes 1-30

Release	Manifest	Kubernetes Version
41	v1-30-eks-41	v1.30.14

Kubernetes 1-29

Release	Manifest	Kubernetes Version
48	v1-29-eks-48	v1.29.15

Kubernetes 1-28

Release	Manifest	Kubernetes Version
59	v1-28-eks-59	v1.28.15

Kubernetes 1.18 - 1.27: DEPRECATED

In alignment with the Amazon EKS release calendar, EKS Distro has discontinued support of Kubernetes v1.18 - v1.27. While there are no plans to remove these versions' images from EKS Distro ECR, there will be no more updates, including security fixes, for them.

Due to the increased security risk this poses, it is HIGHLY recommended that users of v1.18 - v1.27 update to a supported version (v1.28+) as soon as possible.

Development

The EKS Distro is built using Prow, the Kubernetes CI/CD system. EKS operates an installation of Prow, which is visible at https://prow.eks.amazonaws.com/. Please read our CONTRIBUTING guide before making a Pull Request.

For building EKS Distro locally, refer to the building-locally guide.

For updating project dependencies, refer to the update-project-dependency guide.

Security

If you discover a potential security issue in this project, or think you may have discovered a security issue, we ask that you notify AWS Security via our vulnerability reporting page. Please do not create a public GitHub issue.

License

This project is licensed under the Apache-2.0 License.