Skip to content
This repository was archived by the owner on Aug 7, 2025. It is now read-only.

document available eks versions #1597

Merged
HarshCasper merged 3 commits into from
Feb 24, 2025
Merged

document available eks versions #1597

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3cd37dd
document available eks versions
HarshCasper Dec 15, 2024
9693a22
fix the docs
HarshCasper Feb 24, 2025
1a85d7f
Apply suggestions from code review
HarshCasper Feb 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 21 additions & 2 deletions content/en/user-guide/aws/eks/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,6 @@ The default approach for creating Kubernetes clusters using the local EKS API is
LocalStack seamlessly manages the download and installation process, making it hassle-free for users.
In most cases, the installation is automatic, eliminating the need for any manual customizations.

A new cluster can be created using the following command:

You can create a new cluster using the [`CreateCluster`](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateCluster.html) API.
Run the following command:

Expand Down Expand Up @@ -551,6 +549,27 @@ spec:
restartPolicy: Always
```

## Supported Versions

LocalStack uses [k3s](https://github.com/k3s-io/k3s) under the hood for creating EKS clusters.
Below is the list of supported Kubernetes versions and their corresponding k3s versions.
The default version is `1.22`.

| Kubernetes Version | k3s Version |
Copy link
Contributor

@simonrw simonrw Dec 16, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I presume this list of supported versions comes from the source code? My concern is keeping this list up to date with the supported versions.

We are already 2 releases behind the current release in both the source code and this table. Is there any way we can keep these two up to date?

Copy link
Member

@dfangl dfangl Feb 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree. I added a script which is able to automatically keep the available versions up to date in our codebase, that can also be used to keep this table up to date. I am however a bit reluctant to add this functionality, as it might be superseded soon. I think we can do another manual update, and automate this in the future!

|---------------------|-------------------|
| 1.30 | v1.30.4-k3s1 |
| 1.29 | v1.29.0-k3s1 |
| 1.28 | v1.28.5-k3s1 |
| 1.27 | v1.26.9-k3s1 |
| 1.26 | v1.26.12-k3s1 |
| 1.25 | v1.25.9-k3s1 |
| 1.24 | v1.24.13-k3s1 |
| 1.23 | v1.23.17-k3s1 |
| 1.22 (Default) | v1.22.6-k3s1 |

Users can specify the desired version when creating an EKS cluster in LocalStack.
If no version is specified, the default version `1.22` will be used.

## Resource Browser

The LocalStack Web Application provides a Resource Browser for managing EKS clusters.
Expand Down
Loading