CfnClusterProps
- class aws_cdk.aws_eks_legacy.CfnClusterProps(*, resources_vpc_config, role_arn, encryption_config=None, kubernetes_network_config=None, logging=None, name=None, outpost_config=None, tags=None, version=None)
Bases:
object
Properties for defining a
CfnCluster
.- Parameters:
resources_vpc_config (
Union
[IResolvable
,ResourcesVpcConfigProperty
,Dict
[str
,Any
]]) – The VPC configuration that’s used by the cluster control plane. Amazon EKS VPC resources have specific requirements to work properly with Kubernetes. For more information, see Cluster VPC Considerations and Cluster Security Group Considerations in the Amazon EKS User Guide . You must specify at least two subnets. You can specify up to five security groups, but we recommend that you use a dedicated security group for your cluster control plane. .. epigraph:: Updates require replacement of theSecurityGroupIds
andSubnetIds
sub-properties.role_arn (
str
) – The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf. For more information, see Amazon EKS Service IAM Role in the Amazon EKS User Guide .encryption_config (
Union
[IResolvable
,Sequence
[Union
[IResolvable
,EncryptionConfigProperty
,Dict
[str
,Any
]]],None
]) – The encryption configuration for the cluster.kubernetes_network_config (
Union
[IResolvable
,KubernetesNetworkConfigProperty
,Dict
[str
,Any
],None
]) – The Kubernetes network configuration for the cluster.logging (
Union
[IResolvable
,LoggingProperty
,Dict
[str
,Any
],None
]) – The logging configuration for your cluster.name (
Optional
[str
]) – The unique name to give to your cluster.outpost_config (
Union
[IResolvable
,OutpostConfigProperty
,Dict
[str
,Any
],None
]) – An object representing the configuration of your local Amazon EKS cluster on an AWS Outpost. This object isn’t available for clusters on the AWS cloud.tags (
Optional
[Sequence
[Union
[CfnTag
,Dict
[str
,Any
]]]]) – The metadata that you apply to the cluster to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define. Cluster tags don’t propagate to any other resources associated with the cluster. .. epigraph:: You must have theeks:TagResource
andeks:UntagResource
permissions for your IAM principal to manage the AWS CloudFormation stack. If you don’t have these permissions, there might be unexpected behavior with stack-level tags propagating to the resource during resource creation and update.version (
Optional
[str
]) – The desired Kubernetes version for your cluster. If you don’t specify a value here, the default version available in Amazon EKS is used. .. epigraph:: The default version might not be the latest version available.
- Link:
http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-cluster.html
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. import aws_cdk.aws_eks_legacy as eks_legacy cfn_cluster_props = eks_legacy.CfnClusterProps( resources_vpc_config=eks_legacy.CfnCluster.ResourcesVpcConfigProperty( subnet_ids=["subnetIds"], # the properties below are optional endpoint_private_access=False, endpoint_public_access=False, public_access_cidrs=["publicAccessCidrs"], security_group_ids=["securityGroupIds"] ), role_arn="roleArn", # the properties below are optional encryption_config=[eks_legacy.CfnCluster.EncryptionConfigProperty( provider=eks_legacy.CfnCluster.ProviderProperty( key_arn="keyArn" ), resources=["resources"] )], kubernetes_network_config=eks_legacy.CfnCluster.KubernetesNetworkConfigProperty( ip_family="ipFamily", service_ipv4_cidr="serviceIpv4Cidr", service_ipv6_cidr="serviceIpv6Cidr" ), logging=eks_legacy.CfnCluster.LoggingProperty( cluster_logging=eks_legacy.CfnCluster.ClusterLoggingProperty( enabled_types=[eks_legacy.CfnCluster.LoggingTypeConfigProperty( type="type" )] ) ), name="name", outpost_config=eks_legacy.CfnCluster.OutpostConfigProperty( control_plane_instance_type="controlPlaneInstanceType", outpost_arns=["outpostArns"], # the properties below are optional control_plane_placement=eks_legacy.CfnCluster.ControlPlanePlacementProperty( group_name="groupName" ) ), tags=[CfnTag( key="key", value="value" )], version="version" )
Attributes
- encryption_config
The encryption configuration for the cluster.
- kubernetes_network_config
The Kubernetes network configuration for the cluster.
- logging
The logging configuration for your cluster.
- name
The unique name to give to your cluster.
- outpost_config
An object representing the configuration of your local Amazon EKS cluster on an AWS Outpost.
This object isn’t available for clusters on the AWS cloud.
- resources_vpc_config
The VPC configuration that’s used by the cluster control plane.
Amazon EKS VPC resources have specific requirements to work properly with Kubernetes. For more information, see Cluster VPC Considerations and Cluster Security Group Considerations in the Amazon EKS User Guide . You must specify at least two subnets. You can specify up to five security groups, but we recommend that you use a dedicated security group for your cluster control plane. .. epigraph:
Updates require replacement of the ``SecurityGroupIds`` and ``SubnetIds`` sub-properties.
- role_arn
The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf.
For more information, see Amazon EKS Service IAM Role in the Amazon EKS User Guide .
- tags
The metadata that you apply to the cluster to assist with categorization and organization.
Each tag consists of a key and an optional value, both of which you define. Cluster tags don’t propagate to any other resources associated with the cluster. .. epigraph:
You must have the ``eks:TagResource`` and ``eks:UntagResource`` permissions for your `IAM principal <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html>`_ to manage the AWS CloudFormation stack. If you don't have these permissions, there might be unexpected behavior with stack-level tags propagating to the resource during resource creation and update.
- version
The desired Kubernetes version for your cluster.
If you don’t specify a value here, the default version available in Amazon EKS is used. .. epigraph:
The default version might not be the latest version available.