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

Show file tree
Hide file tree
Changes from 2 commits
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
3 changes: 2 additions & 1 deletion content/en/references/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -177,8 +177,9 @@ This section covers configuration options that are specific to certain AWS servi
| Variable | Example Values | Description |
| - | - | - |
| `EKS_LOADBALANCER_PORT` | `8081` (default) | Local port on which the Kubernetes load balancer is exposed on the host. |
| `EKS_K3S_IMAGE_TAG` | `v1.22.6-k3s1` (default) | Custom tag of the `k8s/rancher` image used to spin up Kubernetes clusters locally. |
| `EKS_K3S_IMAGE_TAG` | `v1.31.5-k3s1` (default) | Custom tag of the `k8s/rancher` image used to spin up Kubernetes clusters locally. |
| `EKS_K8S_PROVIDER` | `k3s` (default)\|`local` | The k8s provider which should be used to start the k8s cluster backing EKS. For more information on the providers, please see [Elastic Kubernetes Service (EKS)]({{< ref "user-guide/aws/eks" >}}) |
| `EKS_K3S_IMAGE_REPOSITORY` | `rancher/k3s` (default) | Custom repository of the `k8s/rancher` image used to spin up Kubernetes clusters locally. |

### ElastiCache

Expand Down
21 changes: 19 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,25 @@ 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.31`.

| Kubernetes Version | k3s Version | EKS Platform Version |
|-------------------|-------------------|---------------------|
| 1.32 | v1.32.1-k3s1 | eks.3 |
| 1.31 | v1.31.5-k3s1 | eks.19 |
| 1.30 | v1.30.9-k3s1 | eks.27 |
| 1.29 | v1.29.13-k3s1 | eks.30 |
| 1.28 | v1.28.15-k3s1 | eks.36 |
| 1.27 | v1.27.16-k3s1 | eks.40 |
| 1.26 | v1.26.15-k3s1 | eks.42 |
| 1.25 | v1.25.16-k3s4 | eks.42 |

Users can specify the desired version when creating an EKS cluster in LocalStack using the `EKS_K3S_IMAGE_TAG` configuration variable when starting LocalStack.

## Resource Browser

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