# KubernetesVersion

Kubernetes cluster version.

- Source: [`aws-eks-v2/lib/cluster.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-eks-v2/lib/cluster.ts#L748)
- Type last changed: v2.263.0 · 31 Jul 2026

## Example

```ts
const cluster = new eks.Cluster(this, 'ManagedNodeCluster', {
  version: eks.KubernetesVersion.V1_36,
  defaultCapacityType: eks.DefaultCapacityType.NODEGROUP,
});

// Add a Fargate Profile for specific workloads (e.g., default namespace)
cluster.addFargateProfile('FargateProfile', {
  selectors: [
    { namespace: 'default' }, // Run pods in 'default' on Fargate
],
});
```

## Properties

- `V1_25`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.25.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV25Layer` from
  `@aws-cdk/lambda-layer-kubectl-v25`.

- `V1_26`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.26.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV26Layer` from
  `@aws-cdk/lambda-layer-kubectl-v26`.

- `V1_27`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.27.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV27Layer` from
  `@aws-cdk/lambda-layer-kubectl-v27`.

- `V1_28`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.28.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV28Layer` from
  `@aws-cdk/lambda-layer-kubectl-v28`.

- `V1_29`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.29.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV29Layer` from
  `@aws-cdk/lambda-layer-kubectl-v29`.

- `V1_30`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.30.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV30Layer` from
  `@aws-cdk/lambda-layer-kubectl-v30`.

- `V1_31`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.31.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV31Layer` from
  `@aws-cdk/lambda-layer-kubectl-v31`.

- `V1_32`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.32.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV32Layer` from
  `@aws-cdk/lambda-layer-kubectl-v32`.

- `V1_33`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.33.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV33Layer` from
  `@aws-cdk/lambda-layer-kubectl-v33`.

- `V1_34`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.34.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV34Layer` from
  `@aws-cdk/lambda-layer-kubectl-v34`.

- `V1_35`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.35.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV35Layer` from
  `@aws-cdk/lambda-layer-kubectl-v35`.

- `V1_36`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks_v2.KubernetesVersion.html) (static) — Kubernetes version 1.36.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV36Layer` from
  `@aws-cdk/lambda-layer-kubectl-v36`.

- `version`: string — cluster version number.

## Methods

- `of(version: string): KubernetesVersion // chainable` (static) — Custom cluster version.

  **Parameters**

  - `version` — custom version number.