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

Commit 8bb50de

Browse files
HarshCasperdfangl
andauthored
document available eks versions (#1597)
Co-authored-by: Daniel Fangl <daniel.fangl@gmail.com>
1 parent d02fc98 commit 8bb50de

File tree

2 files changed

+21
-3
lines changed

2 files changed

+21
-3
lines changed

content/en/references/configuration.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -178,8 +178,9 @@ This section covers configuration options that are specific to certain AWS servi
178178
| Variable | Example Values | Description |
179179
| - | - | - |
180180
| `EKS_LOADBALANCER_PORT` | `8081` (default) | Local port on which the Kubernetes load balancer is exposed on the host. |
181-
| `EKS_K3S_IMAGE_TAG` | `v1.22.6-k3s1` (default) | Custom tag of the `k8s/rancher` image used to spin up Kubernetes clusters locally. |
181+
| `EKS_K3S_IMAGE_TAG` | `v1.31.5-k3s1` (default) | Custom tag of the `rancher/k3s` image used to spin up Kubernetes clusters locally. |
182182
| `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" >}}) |
183+
| `EKS_K3S_IMAGE_REPOSITORY` | `rancher/k3s` (default) | Custom repository of the `rancher/k3s` image used to spin up Kubernetes clusters locally. |
183184

184185
### ElastiCache
185186

content/en/user-guide/aws/eks/index.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,6 @@ The default approach for creating Kubernetes clusters using the local EKS API is
2929
LocalStack seamlessly manages the download and installation process, making it hassle-free for users.
3030
In most cases, the installation is automatic, eliminating the need for any manual customizations.
3131

32-
A new cluster can be created using the following command:
33-
3432
You can create a new cluster using the [`CreateCluster`](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateCluster.html) API.
3533
Run the following command:
3634

@@ -551,6 +549,25 @@ spec:
551549
restartPolicy: Always
552550
```
553551

552+
## Supported Versions
553+
554+
LocalStack uses [k3s](https://github.com/k3s-io/k3s) under the hood for creating EKS clusters.
555+
Below is the list of supported Kubernetes versions and their corresponding k3s versions.
556+
The default version is `1.31`.
557+
558+
| Kubernetes Version | k3s Version | EKS Platform Version |
559+
|-------------------|-------------------|---------------------|
560+
| 1.32 | v1.32.1-k3s1 | eks.3 |
561+
| 1.31 | v1.31.5-k3s1 | eks.19 |
562+
| 1.30 | v1.30.9-k3s1 | eks.27 |
563+
| 1.29 | v1.29.13-k3s1 | eks.30 |
564+
| 1.28 | v1.28.15-k3s1 | eks.36 |
565+
| 1.27 | v1.27.16-k3s1 | eks.40 |
566+
| 1.26 | v1.26.15-k3s1 | eks.42 |
567+
| 1.25 | v1.25.16-k3s4 | eks.42 |
568+
569+
Users can specify the desired version when creating an EKS cluster in LocalStack using the `EKS_K3S_IMAGE_TAG` configuration variable when starting LocalStack.
570+
554571
## Resource Browser
555572

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

0 commit comments

Comments
 (0)