/eks-distro

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.

Primary LanguageShellApache License 2.0Apache-2.0

EKS Distro Repository

🚨🚨🚨 IMPORTANT INFORMATION ABOUT 1.20 SUPPORT 🚨🚨🚨

EKS-D has discontinued support of Kubernetes v1.20. While there are no plans to removed EKS-D v1.20 images from the ECR, there will be no more updates to v1.20. Due to the increased security risk this poses, it is HIGHLY recommended that users of v1.20 update to a supported version (v1.21+) as soon as possible.


Release Development Build Status
1-21 1-21
1-22 1-22
1-23 1-23
1-24 1-24

CII Best Practices

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.

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-24

Release Manifest Kubernetes Version
5 v1-24-eks-5 v1.24.8

Kubernetes 1-23

Release Manifest Kubernetes Version
10 v1-23-eks-10 v1.23.14

Kubernetes 1-22

Release Manifest Kubernetes Version
15 v1-22-eks-15 v1.22.16

Kubernetes 1-21

Release Manifest Kubernetes Version
22 v1-21-eks-22 v1.21.14

Kubernetes 1.18, 1.19, and 1.20: DEPRECATED

EKS Distro has discontinued support of Kubernetes v1.18 - v1.20. 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.20 update to a supported version (v1.21+) 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.