# AddonProps

Properties for creating an Amazon EKS Add-On.

Used as props by: [Addon](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_eks.Addon.html)

- Source: [`aws-eks/lib/addon.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-eks/lib/addon.ts#L30)
- Type last changed: v2.238.0 · 9 Feb 2026

## Example

TypeScript:

```ts
declare const cluster: eks.Cluster;

new eks.Addon(this, 'Addon', {
  cluster,
  addonName: 'coredns',
  addonVersion: 'v1.11.4-eksbuild.2',
  // whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
  preserveOnDelete: false,
  configurationValues: {
    replicaCount: 2,
  },
});
```

Python:

```python
# cluster: eks.Cluster

eks.Addon(self, "Addon",
    cluster=cluster,
    addon_name="coredns",
    addon_version="v1.11.4-eksbuild.2",
    # whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
    preserve_on_delete=False,
    configuration_values={
        "replica_count": 2
    }
)
```

Java:

```java
Cluster cluster;

Addon.Builder.create(this, "Addon")
        .cluster(cluster)
        .addonName("coredns")
        .addonVersion("v1.11.4-eksbuild.2")
        // whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
        .preserveOnDelete(false)
        .configurationValues(Map.of(
                "replicaCount", 2))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
Cluster cluster;

new Addon(this, "Addon", new AddonProps {
    Cluster = cluster,
    AddonName = "coredns",
    AddonVersion = "v1.11.4-eksbuild.2",
    // whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
    PreserveOnDelete = false,
    ConfigurationValues = new Dictionary<string, object> {
        { "replicaCount", 2 }
    }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var cluster Cluster

eks.NewAddon(this, jsii.String("Addon"), &AddonProps{
	Cluster: Cluster,
	AddonName: jsii.String("coredns"),
	AddonVersion: jsii.String("v1.11.4-eksbuild.2"),
	// whether to preserve the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.
	PreserveOnDelete: jsii.Boolean(false),
	ConfigurationValues: map[string]interface{}{
		"replicaCount": jsii.Number(2),
	},
})
```

## Properties

- `addonName`: string (required) — Name of the Add-On.

- `addonVersion`: string — Version of the Add-On.

  **Default:** the latest version.

  You can check all available versions with describe-addon-versions.
  For example, this lists all available versions for the `eks-pod-identity-agent` addon:
  $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent \
  --query 'addons[*].addonVersions[*].addonVersion'

- `cluster`: [ICluster](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_eks.ICluster.html) (required) — The EKS cluster the Add-On is associated with.

- `configurationValues`: { [key: string]: any } — The configuration values for the Add-on.

  **Default:** Use default configuration.

- `preserveOnDelete`: boolean = true — Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on.

  If an IAM account is associated with the add-on, it isn't removed.

- `removalPolicy`: [RemovalPolicy](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.RemovalPolicy.html) = RemovalPolicy.DESTROY — The removal policy applied to the EKS add-on.

  The removal policy controls what happens to the resource if it stops being managed by CloudFormation.
  This can happen in one of three situations:

  - The resource is removed from the template, so CloudFormation stops managing it
  - A change to the resource is made that requires it to be replaced, so CloudFormation stops managing it
  - The stack is deleted, so CloudFormation stops managing all resources in it
