Interface IFargateProfileOptions

(experimental) Options for defining EKS Fargate Profiles.

Namespace: Amazon.CDK.AWS.Eks.V2.Alpha

Assembly: Amazon.CDK.AWS.Eks.V2.Alpha.dll

Syntax (csharp)

public interface IFargateProfileOptions

Syntax (vb)

Public Interface IFargateProfileOptions

Remarks

Stability: Experimental

ExampleMetadata: infused

Examples

var cluster = new Cluster(this, "ManagedNodeCluster", new ClusterProps {
                 Version = KubernetesVersion.V1_34,
                 DefaultCapacityType = DefaultCapacityType.NODEGROUP
             });

             // Add a Fargate Profile for specific workloads (e.g., default namespace)
             cluster.AddFargateProfile("FargateProfile", new FargateProfileOptions {
                 Selectors = new [] { new Selector { Namespace = "default" } }
             });

Synopsis

Properties

FargateProfileName	(experimental) The name of the Fargate profile.
PodExecutionRole	(experimental) The pod execution role to use for pods that match the selectors in the Fargate profile.
Selectors	(experimental) The selectors to match for pods to use this Fargate profile.
SubnetSelection	(experimental) Select which subnets to launch your pods into.
Vpc	(experimental) The VPC from which to select subnets to launch your pods into.

Properties

FargateProfileName

(experimental) The name of the Fargate profile.

string? FargateProfileName { get; }

Property Value

string

Remarks

Default: - generated

Stability: Experimental

PodExecutionRole

(experimental) The pod execution role to use for pods that match the selectors in the Fargate profile.

IRole? PodExecutionRole { get; }

Property Value

IRole

Remarks

The pod execution role allows Fargate infrastructure to register with your cluster as a node, and it provides read access to Amazon ECR image repositories.

Default: - a role will be automatically created

Stability: Experimental

See: https://docs.aws.amazon.com/eks/latest/userguide/pod-execution-role.html

Selectors

(experimental) The selectors to match for pods to use this Fargate profile.

ISelector[] Selectors { get; }

Property Value

ISelector[]

Remarks

Each selector must have an associated namespace. Optionally, you can also specify labels for a namespace.

At least one selector is required and you may specify up to five selectors.

Stability: Experimental

SubnetSelection

(experimental) Select which subnets to launch your pods into.

ISubnetSelection? SubnetSelection { get; }

Property Value

ISubnetSelection

Remarks

At this time, pods running on Fargate are not assigned public IP addresses, so only private subnets (with no direct route to an Internet Gateway) are allowed.

You must specify the VPC to customize the subnet selection

Default: - all private subnets of the VPC are selected.

Stability: Experimental

Vpc

(experimental) The VPC from which to select subnets to launch your pods into.

IVpc? Vpc { get; }

Property Value

IVpc

Remarks

By default, all private subnets are selected. You can customize this using subnetSelection.

Default: - all private subnets used by the EKS cluster

Stability: Experimental