software.amazon.awscdk.services.eks

Interface ICluster

All Superinterfaces:

IConnectable, software.constructs.IConstruct, IDependable, IResource, software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

ICluster.Jsii$Default

All Known Implementing Classes:

Cluster, FargateCluster, ICluster.Jsii$Proxy, LegacyCluster

@Generated(value="jsii-pacmak/1.14.1 (build 828de8a)",
           date="2020-11-24T22:28:23.727Z")
 @Stability(value=Experimental)
public interface ICluster
extends software.amazon.jsii.JsiiSerializable, IResource, IConnectable

(experimental) An EKS cluster.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ICluster.Jsii$Default Internal default implementation for ICluster.
static class	ICluster.Jsii$Proxy A proxy class which represents a concrete javascript instance of this type.

Method Summary

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

Methods inherited from interface software.amazon.awscdk.core.IResource

getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Methods inherited from interface software.amazon.awscdk.services.ec2.IConnectable

getConnections

Method Detail

getClusterArn

@Stability(value=Experimental)
 @NotNull
String getClusterArn()

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

getClusterCertificateAuthorityData

@Stability(value=Experimental)
 @NotNull
String getClusterCertificateAuthorityData()

(experimental) The certificate-authority-data for your cluster.

getClusterEncryptionConfigKeyArn

@Stability(value=Experimental)
 @NotNull
String getClusterEncryptionConfigKeyArn()

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

getClusterEndpoint

@Stability(value=Experimental)
 @NotNull
String getClusterEndpoint()

(experimental) The API Server endpoint URL.

getClusterName

@Stability(value=Experimental)
 @NotNull
String getClusterName()

(experimental) The physical name of the Cluster.

getClusterSecurityGroupId

@Stability(value=Experimental)
 @NotNull
String getClusterSecurityGroupId()

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

getOpenIdConnectProvider

@Stability(value=Experimental)
 @NotNull
IOpenIdConnectProvider getOpenIdConnectProvider()

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

getVpc

@Stability(value=Experimental)
 @NotNull
IVpc getVpc()

(experimental) The VPC in which this Cluster was created.

getKubectlEnvironment

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

(experimental) Custom environment variables when running `kubectl` against this cluster.

Default: - no additional environment variables

getKubectlLayer

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

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

If not defined, a default layer will be used.

getKubectlPrivateSubnets

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

(experimental) Subnets to host the `kubectl` compute resources.

Default: - If not specified, the k8s endpoint is expected to be accessible publicly.

getKubectlRole

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

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

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

getKubectlSecurityGroup

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

(experimental) A security group to use for `kubectl` execution.

Default: - If not specified, the k8s endpoint is expected to be accessible publicly.

addCdk8sChart

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

(experimental) Defines a CDK8s chart in this cluster.

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=Experimental)
 @NotNull
HelmChart addHelmChart(@NotNull
                                                                String id,
                                                                @NotNull
                                                                HelmChartOptions options)

(experimental) Defines a Helm chart in this cluster.

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=Experimental)
 @NotNull
KubernetesManifest addManifest(@NotNull
                                                                        String id,
                                                                        @NotNull
                                                                        Object... manifest)

(experimental) Defines a Kubernetes resource in this cluster.

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

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=Experimental)
 @NotNull
ServiceAccount addServiceAccount(@NotNull
                                                                          String id,
                                                                          @Nullable
                                                                          ServiceAccountOptions options)

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

Parameters:

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

options - service account options.

addServiceAccount

@Stability(value=Experimental)
 @NotNull
ServiceAccount addServiceAccount(@NotNull
                                                                          String id)

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

Parameters:

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