software.amazon.awscdk.services.eks

Interface ICluster.Jsii$Default

All Superinterfaces:

ICluster, IConnectable, IConnectable.Jsii$Default, software.constructs.IConstruct, software.constructs.IConstruct.Jsii$Default, IDependable, IDependable.Jsii$Default, IResource, IResource.Jsii$Default, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ICluster.Jsii$Proxy

Enclosing interface:

ICluster

@Internal
public static interface ICluster.Jsii$Default
extends ICluster, IResource.Jsii$Default, IConnectable.Jsii$Default

Internal default implementation for ICluster.

Nested Class Summary

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.eks.ICluster

ICluster.Jsii$Default, ICluster.Jsii$Proxy

Method Summary

Modifier and Type	Method and Description
default KubernetesManifest	addCdk8sChart(String id, software.constructs.Construct chart) Defines a CDK8s chart in this cluster.
default HelmChart	addHelmChart(String id, HelmChartOptions options) Defines a Helm chart in this cluster.
default KubernetesManifest	addManifest(String id, Map<String,Object>... manifest) Defines a Kubernetes resource in this cluster.
default ServiceAccount	addServiceAccount(String id, ServiceAccountOptions options) Creates a new service account with corresponding IAM Role (IRSA).
default String	getClusterArn() The unique ARN assigned to the service by AWS in the form of arn:aws:eks:.
default String	getClusterCertificateAuthorityData() The certificate-authority-data for your cluster.
default String	getClusterEncryptionConfigKeyArn() Amazon Resource Name (ARN) or alias of the customer master key (CMK).
default String	getClusterEndpoint() The API Server endpoint URL.
default String	getClusterName() The physical name of the Cluster.
default ISecurityGroup	getClusterSecurityGroup() The cluster security group that was created by Amazon EKS for the cluster.
default String	getClusterSecurityGroupId() The id of the cluster security group that was created by Amazon EKS for the cluster.
default Connections	getConnections()
default ResourceEnvironment	getEnv() The environment this resource belongs to.
default Map<String,String>	getKubectlEnvironment() Custom environment variables when running `kubectl` against this cluster.
default ILayerVersion	getKubectlLayer() An AWS Lambda layer that includes `kubectl`, `helm` and the `aws` CLI.
default Size	getKubectlMemory() Amount of memory to allocate to the provider's lambda function.
default List<ISubnet>	getKubectlPrivateSubnets() Subnets to host the `kubectl` compute resources.
default IRole	getKubectlRole() An IAM role that can perform kubectl operations against this cluster.
default ISecurityGroup	getKubectlSecurityGroup() A security group to use for `kubectl` execution.
default ConstructNode	getNode() The construct tree node for this construct.
default IOpenIdConnectProvider	getOpenIdConnectProvider() The Open ID Connect Provider of the cluster used to configure Service Accounts.
default Boolean	getPrune() Indicates whether Kubernetes resources can be automatically pruned.
default Stack	getStack() The stack in which this resource is defined.
default IVpc	getVpc() The VPC in which this Cluster was created.

Methods inherited from interface software.amazon.awscdk.services.eks.ICluster

addServiceAccount

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getNode

@Stability(value=Stable)
 @NotNull
default ConstructNode getNode()

The construct tree node for this construct.

Specified by:

getNode in interface IResource.Jsii$Default

getEnv

@Stability(value=Stable)
 @NotNull
default ResourceEnvironment getEnv()

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

Specified by:

getEnv in interface IResource

Specified by:

getEnv in interface IResource.Jsii$Default

getStack

@Stability(value=Stable)
 @NotNull
default Stack getStack()

The stack in which this resource is defined.

Specified by:

getStack in interface IResource

Specified by:

getStack in interface IResource.Jsii$Default

getConnections

@Stability(value=Stable)
 @NotNull
default Connections getConnections()

Specified by:

getConnections in interface IConnectable

Specified by:

getConnections in interface IConnectable.Jsii$Default

getClusterArn

@Stability(value=Stable)
 @NotNull
default String getClusterArn()

The unique ARN assigned to the service by AWS in the form of arn:aws:eks:.

Specified by:

getClusterArn in interface ICluster

getClusterCertificateAuthorityData

@Stability(value=Stable)
 @NotNull
default String getClusterCertificateAuthorityData()

The certificate-authority-data for your cluster.

Specified by:

getClusterCertificateAuthorityData in interface ICluster

getClusterEncryptionConfigKeyArn

@Stability(value=Stable)
 @NotNull
default String getClusterEncryptionConfigKeyArn()

Amazon Resource Name (ARN) or alias of the customer master key (CMK).

Specified by:

getClusterEncryptionConfigKeyArn in interface ICluster

getClusterEndpoint

@Stability(value=Stable)
 @NotNull
default String getClusterEndpoint()

The API Server endpoint URL.

Specified by:

getClusterEndpoint in interface ICluster

getClusterName

@Stability(value=Stable)
 @NotNull
default String getClusterName()

The physical name of the Cluster.

Specified by:

getClusterName in interface ICluster

getClusterSecurityGroup

@Stability(value=Stable)
 @NotNull
default ISecurityGroup getClusterSecurityGroup()

The cluster security group that was created by Amazon EKS for the cluster.

Specified by:

getClusterSecurityGroup in interface ICluster

getClusterSecurityGroupId

@Stability(value=Stable)
 @NotNull
default String getClusterSecurityGroupId()

The id of the cluster security group that was created by Amazon EKS for the cluster.

Specified by:

getClusterSecurityGroupId in interface ICluster

getOpenIdConnectProvider

@Stability(value=Stable)
 @NotNull
default IOpenIdConnectProvider getOpenIdConnectProvider()

The Open ID Connect Provider of the cluster used to configure Service Accounts.

Specified by:

getOpenIdConnectProvider in interface ICluster

getPrune

@Stability(value=Stable)
 @NotNull
default Boolean getPrune()

Indicates whether Kubernetes resources can be automatically pruned.

When this is enabled (default), prune labels will be allocated and injected to each resource. These labels will then be used when issuing the kubectl apply operation with the --prune switch.

Specified by:

getPrune in interface ICluster

getVpc

@Stability(value=Stable)
 @NotNull
default IVpc getVpc()

The VPC in which this Cluster was created.

Specified by:

getVpc in interface ICluster

getKubectlEnvironment

@Stability(value=Stable)
 @Nullable
default Map<String,String> getKubectlEnvironment()

Custom environment variables when running `kubectl` against this cluster.

Specified by:

getKubectlEnvironment in interface ICluster

getKubectlLayer

@Stability(value=Stable)
 @Nullable
default ILayerVersion getKubectlLayer()

An AWS Lambda layer that includes `kubectl`, `helm` and the `aws` CLI.

If not defined, a default layer will be used.

Specified by:

getKubectlLayer in interface ICluster

getKubectlMemory

@Stability(value=Stable)
 @Nullable
default Size getKubectlMemory()

Amount of memory to allocate to the provider's lambda function.

Specified by:

getKubectlMemory in interface ICluster

getKubectlPrivateSubnets

@Stability(value=Stable)
 @Nullable
default List<ISubnet> getKubectlPrivateSubnets()

Subnets to host the `kubectl` compute resources.

If this is undefined, the k8s endpoint is expected to be accessible publicly.

Specified by:

getKubectlPrivateSubnets in interface ICluster

getKubectlRole

@Stability(value=Stable)
 @Nullable
default IRole getKubectlRole()

An IAM role that can perform kubectl operations against this cluster.

The role should be mapped to the system:masters Kubernetes RBAC role.

Specified by:

getKubectlRole in interface ICluster

getKubectlSecurityGroup

@Stability(value=Stable)
 @Nullable
default ISecurityGroup getKubectlSecurityGroup()

A security group to use for `kubectl` execution.

If this is undefined, the k8s endpoint is expected to be accessible publicly.

Specified by:

getKubectlSecurityGroup in interface ICluster

addCdk8sChart

@Stability(value=Stable)
 @NotNull
default KubernetesManifest addCdk8sChart(@NotNull
                                                                            String id,
                                                                            @NotNull
                                                                            software.constructs.Construct chart)

Defines a CDK8s chart in this cluster.

Specified by:

addCdk8sChart in interface ICluster

Parameters:

id - logical id of this chart. This parameter is required.

chart - the cdk8s chart. This parameter is required.

Returns:

a `KubernetesManifest` construct representing the chart.

addHelmChart

@Stability(value=Stable)
 @NotNull
default HelmChart addHelmChart(@NotNull
                                                                  String id,
                                                                  @NotNull
                                                                  HelmChartOptions options)

Defines a Helm chart in this cluster.

Specified by:

addHelmChart in interface ICluster

Parameters:

id - logical id of this chart. This parameter is required.

options - options of this chart. This parameter is required.

Returns:

a `HelmChart` construct

addManifest

@Stability(value=Stable)
 @NotNull
default KubernetesManifest addManifest(@NotNull
                                                                          String id,
                                                                          @NotNull
                                                                          Map<String,Object>... manifest)

Defines a Kubernetes resource in this cluster.

The manifest will be applied/deleted using kubectl as needed.

Specified by:

addManifest in interface ICluster

Parameters:

id - logical id of this manifest. This parameter is required.

manifest - a list of Kubernetes resource specifications. This parameter is required.

Returns:

a `KubernetesManifest` object.

addServiceAccount

@Stability(value=Stable)
 @NotNull
default ServiceAccount addServiceAccount(@NotNull
                                                                            String id,
                                                                            @Nullable
                                                                            ServiceAccountOptions options)

Creates a new service account with corresponding IAM Role (IRSA).

Specified by:

addServiceAccount in interface ICluster

Parameters:

id - logical id of service account. This parameter is required.

options - service account options.