2.185.0

interface ClusterAttributes 🔹

LanguageType name
.NETAmazon.CDK.AWS.Eks.V2.Alpha.ClusterAttributes
Gogithub.com/aws/aws-cdk-go/awscdkeks-v2alpha/v2#ClusterAttributes
Javasoftware.amazon.awscdk.services.eks.v2.alpha.ClusterAttributes
Pythonaws_cdk.aws_eks_v2_alpha.ClusterAttributes
TypeScript (source)@aws-cdk/aws-eks-v2-alpha » ClusterAttributes

Attributes for EKS clusters.

Example

import { KubectlV32Layer } from '@aws-cdk/lambda-layer-kubectl-v32';

const handlerRole = iam.Role.fromRoleArn(this, 'HandlerRole', 'arn:aws:iam::123456789012:role/lambda-role');
// get the serivceToken from the custom resource provider
const functionArn = lambda.Function.fromFunctionName(this, 'ProviderOnEventFunc', 'ProviderframeworkonEvent-XXX').functionArn;
const kubectlProvider = eks.KubectlProvider.fromKubectlProviderAttributes(this, 'KubectlProvider', {
  serviceToken: functionArn,
  role: handlerRole,
});

const cluster = eks.Cluster.fromClusterAttributes(this, 'Cluster', {
  clusterName: 'cluster',
  kubectlProvider,
});

Properties

NameTypeDescription
clusterName🔹stringThe physical name of the Cluster.
clusterCertificateAuthorityData?🔹stringThe certificate-authority-data for your cluster.
clusterEncryptionConfigKeyArn?🔹stringAmazon Resource Name (ARN) or alias of the customer master key (CMK).
clusterEndpoint?🔹stringThe API Server endpoint URL.
clusterSecurityGroupId?🔹stringThe cluster security group that was created by Amazon EKS for the cluster.
ipFamily?🔹IpFamilySpecify which IP family is used to assign Kubernetes pod and service IP addresses.
kubectlProvider?🔹IKubectlProviderKubectlProvider for issuing kubectl commands.
kubectlProviderOptions?🔹KubectlProviderOptionsOptions for creating the kubectl provider - a lambda function that executes kubectl and helm against the cluster.
openIdConnectProvider?🔹IOpenIdConnectProviderAn Open ID Connect provider for this cluster that can be used to configure service accounts.
prune?🔹booleanIndicates whether Kubernetes resources added through addManifest() can be automatically pruned.
securityGroupIds?🔹string[]Additional security groups associated with this cluster.
vpc?🔹IVpcThe VPC in which this Cluster was created.

clusterName🔹

Type: string

The physical name of the Cluster.

clusterCertificateAuthorityData?🔹

Type: string (optional, default: if not specified cluster.clusterCertificateAuthorityData will throw an error)

The certificate-authority-data for your cluster.

clusterEncryptionConfigKeyArn?🔹

Type: string (optional, default: if not specified cluster.clusterEncryptionConfigKeyArn will throw an error)

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

clusterEndpoint?🔹

Type: string (optional, default: if not specified cluster.clusterEndpoint will throw an error.)

The API Server endpoint URL.

clusterSecurityGroupId?🔹

Type: string (optional, default: if not specified cluster.clusterSecurityGroupId will throw an error)

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

ipFamily?🔹

Type: IpFamily (optional, default: IpFamily.IP_V4)

Specify which IP family is used to assign Kubernetes pod and service IP addresses.

See also: https://docs.aws.amazon.com/eks/latest/APIReference/API_KubernetesNetworkConfigRequest.html#AmazonEKS-Type-KubernetesNetworkConfigRequest-ipFamily

kubectlProvider?🔹

Type: IKubectlProvider (optional, default: Default CDK provider)

KubectlProvider for issuing kubectl commands.

kubectlProviderOptions?🔹

Type: KubectlProviderOptions (optional)

Options for creating the kubectl provider - a lambda function that executes kubectl and helm against the cluster.

If defined, kubectlLayer is a required property.

If not defined, kubectl provider will not be created by default.

openIdConnectProvider?🔹

Type: IOpenIdConnectProvider (optional, default: if not specified cluster.openIdConnectProvider and cluster.addServiceAccount will throw an error.)

An Open ID Connect provider for this cluster that can be used to configure service accounts.

You can either import an existing provider using iam.OpenIdConnectProvider.fromProviderArn, or create a new provider using new eks.OpenIdConnectProvider

prune?🔹

Type: boolean (optional, default: true)

Indicates whether Kubernetes resources added through addManifest() 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.

securityGroupIds?🔹

Type: string[] (optional, default: if not specified, no additional security groups will be considered in cluster.connections.)

Additional security groups associated with this cluster.

vpc?🔹

Type: IVpc (optional, default: if not specified cluster.vpc will throw an error)

The VPC in which this Cluster was created.

← PreviousNext →