aws-cdk-lib 2.161.0__py3-none-any.whl → 2.162.0__py3-none-any.whl

aws_cdk/aws_eks/__init__.py

@@ -78,13 +78,13 @@ This example defines an Amazon EKS cluster with the following configuration:
 * A Kubernetes pod with a container based on the [paulbouwer/hello-kubernetes](https://github.com/paulbouwer/hello-kubernetes) image.
 
 ```python
-from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
 
 
 # provisioning a cluster
 cluster = eks.Cluster(self, "hello-eks",
-    version=eks.KubernetesVersion.V1_30,
-    kubectl_layer=KubectlV30Layer(self, "kubectl")
+    version=eks.KubernetesVersion.V1_31,
+    kubectl_layer=KubectlV31Layer(self, "kubectl")
 )
 
 # apply a kubernetes manifest to the cluster
@@ -149,7 +149,7 @@ Creating a new cluster is done using the `Cluster` or `FargateCluster` construct
 
 ```python
 eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 ```
 
@@ -157,7 +157,7 @@ You can also use `FargateCluster` to provision a cluster that uses only fargate
 
 ```python
 eks.FargateCluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 ```
 
@@ -181,7 +181,7 @@ At cluster instantiation time, you can customize the number of instances and the
 
 ```python
 eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     default_capacity=5,
     default_capacity_instance=ec2.InstanceType.of(ec2.InstanceClass.M5, ec2.InstanceSize.SMALL)
 )
@@ -193,7 +193,7 @@ Additional customizations are available post instantiation. To apply them, set t
 
 ```python
 cluster = eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     default_capacity=0
 )
 
@@ -295,7 +295,7 @@ eks_cluster_node_group_role = iam.Role(self, "eksClusterNodeGroupRole",
 )
 
 cluster = eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     default_capacity=0
 )
 
@@ -407,7 +407,7 @@ successful replacement. Consider this example if you are renaming the cluster fr
 ```python
 cluster = eks.Cluster(self, "cluster-to-rename",
     cluster_name="foo",  # rename this to 'bar'
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 
 # allow the cluster admin role to delete the cluster 'foo'
@@ -461,7 +461,7 @@ The following code defines an Amazon EKS cluster with a default Fargate Profile
 
 ```python
 cluster = eks.FargateCluster(self, "MyCluster",
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 ```
 
@@ -542,7 +542,7 @@ You can also configure the cluster to use an auto-scaling group as the default c
 
 ```python
 cluster = eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     default_capacity_type=eks.DefaultCapacityType.EC2
 )
 ```
@@ -651,7 +651,7 @@ You can configure the [cluster endpoint access](https://docs.aws.amazon.com/eks/
 
 ```python
 cluster = eks.Cluster(self, "hello-eks",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     endpoint_access=eks.EndpointAccess.PRIVATE
 )
 ```
@@ -673,7 +673,7 @@ To deploy the controller on your EKS cluster, configure the `albController` prop
 
 ```python
 eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     alb_controller=eks.AlbControllerOptions(
         version=eks.AlbControllerVersion.V2_8_2
     )
@@ -717,7 +717,7 @@ You can specify the VPC of the cluster using the `vpc` and `vpcSubnets` properti
 
 
 eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     vpc=vpc,
     vpc_subnets=[ec2.SubnetSelection(subnet_type=ec2.SubnetType.PRIVATE_WITH_EGRESS)]
 )
@@ -766,7 +766,7 @@ You can configure the environment of the Cluster Handler functions by specifying
 # proxy_instance_security_group: ec2.SecurityGroup
 
 cluster = eks.Cluster(self, "hello-eks",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     cluster_handler_environment={
         "https_proxy": "http://proxy.myproxy.com"
     },
@@ -807,7 +807,7 @@ for subnet in subnets:
     subnetcount = subnetcount + 1
 
 cluster = eks.Cluster(self, "hello-eks",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     vpc=vpc,
     ip_family=eks.IpFamily.IP_V6,
     vpc_subnets=[ec2.SubnetSelection(subnets=vpc.public_subnets)]
@@ -842,7 +842,7 @@ You can configure the environment of this function by specifying it at cluster i
 
 ```python
 cluster = eks.Cluster(self, "hello-eks",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     kubectl_environment={
         "http_proxy": "http://proxy.myproxy.com"
     }
@@ -862,12 +862,12 @@ Depending on which version of kubernetes you're targeting, you will need to use
 the `@aws-cdk/lambda-layer-kubectl-vXY` packages.
 
 ```python
-from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
 
 
 cluster = eks.Cluster(self, "hello-eks",
-    version=eks.KubernetesVersion.V1_30,
-    kubectl_layer=KubectlV30Layer(self, "kubectl")
+    version=eks.KubernetesVersion.V1_31,
+    kubectl_layer=KubectlV31Layer(self, "kubectl")
 )
 ```
 
@@ -903,7 +903,7 @@ cluster1 = eks.Cluster(self, "MyCluster",
     kubectl_layer=layer,
     vpc=vpc,
     cluster_name="cluster-name",
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 
 # or
@@ -923,7 +923,7 @@ By default, the kubectl provider is configured with 1024MiB of memory. You can u
 # vpc: ec2.Vpc
 eks.Cluster(self, "MyCluster",
     kubectl_memory=Size.gibibytes(4),
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 eks.Cluster.from_cluster_attributes(self, "MyCluster",
     kubectl_memory=Size.gibibytes(4),
@@ -961,7 +961,7 @@ When you create a cluster, you can specify a `mastersRole`. The `Cluster` constr
 # role: iam.Role
 
 eks.Cluster(self, "HelloEKS",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     masters_role=role
 )
 ```
@@ -1011,7 +1011,7 @@ You can use the `secretsEncryptionKey` to configure which key the cluster will u
 secrets_key = kms.Key(self, "SecretsKey")
 cluster = eks.Cluster(self, "MyCluster",
     secrets_encryption_key=secrets_key,
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 ```
 
@@ -1021,7 +1021,7 @@ You can also use a similar configuration for running a cluster built using the F
 secrets_key = kms.Key(self, "SecretsKey")
 cluster = eks.FargateCluster(self, "MyFargateCluster",
     secrets_encryption_key=secrets_key,
-    version=eks.KubernetesVersion.V1_30
+    version=eks.KubernetesVersion.V1_31
 )
 ```
 
@@ -1068,7 +1068,7 @@ To access the Kubernetes resources from the console, make sure your viewing prin
 in the `aws-auth` ConfigMap. Some options to consider:
 
 ```python
-from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
 # cluster: eks.Cluster
 # your_current_role: iam.Role
 # vpc: ec2.Vpc
@@ -1086,7 +1086,7 @@ your_current_role.add_to_policy(iam.PolicyStatement(
 
 ```python
 # Option 2: create your custom mastersRole with scoped assumeBy arn as the Cluster prop. Switch to this role from the AWS console.
-from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
 # vpc: ec2.Vpc
 
 
@@ -1096,8 +1096,8 @@ masters_role = iam.Role(self, "MastersRole",
 
 cluster = eks.Cluster(self, "EksCluster",
     vpc=vpc,
-    version=eks.KubernetesVersion.V1_30,
-    kubectl_layer=KubectlV30Layer(self, "KubectlLayer"),
+    version=eks.KubernetesVersion.V1_31,
+    kubectl_layer=KubectlV31Layer(self, "KubectlLayer"),
     masters_role=masters_role
 )
 
@@ -1136,14 +1136,14 @@ AWS IAM principals from both Amazon EKS access entry APIs and the aws-auth confi
 To specify the `authenticationMode`:
 
 ```python
-from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
 # vpc: ec2.Vpc
 
 
 eks.Cluster(self, "Cluster",
     vpc=vpc,
-    version=eks.KubernetesVersion.V1_30,
-    kubectl_layer=KubectlV30Layer(self, "KubectlLayer"),
+    version=eks.KubernetesVersion.V1_31,
+    kubectl_layer=KubectlV31Layer(self, "KubectlLayer"),
     authentication_mode=eks.AuthenticationMode.API_AND_CONFIG_MAP
 )
 ```
@@ -1188,7 +1188,7 @@ eks.AccessPolicy.from_access_policy_name("AmazonEKSAdminPolicy",
 Use `grantAccess()` to grant the AccessPolicy to an IAM principal:
 
 ```python
-from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
 # vpc: ec2.Vpc
 
 
@@ -1207,8 +1207,8 @@ eks_admin_view_role = iam.Role(self, "EKSAdminViewRole",
 cluster = eks.Cluster(self, "Cluster",
     vpc=vpc,
     masters_role=cluster_admin_role,
-    version=eks.KubernetesVersion.V1_30,
-    kubectl_layer=KubectlV30Layer(self, "KubectlLayer"),
+    version=eks.KubernetesVersion.V1_31,
+    kubectl_layer=KubectlV31Layer(self, "KubectlLayer"),
     authentication_mode=eks.AuthenticationMode.API_AND_CONFIG_MAP
 )
 
@@ -1540,7 +1540,7 @@ when a cluster is defined:
 
 ```python
 eks.Cluster(self, "MyCluster",
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     prune=False
 )
 ```
@@ -1939,7 +1939,7 @@ property. For example:
 ```python
 cluster = eks.Cluster(self, "Cluster",
     # ...
-    version=eks.KubernetesVersion.V1_30,
+    version=eks.KubernetesVersion.V1_31,
     cluster_logging=[eks.ClusterLoggingTypes.API, eks.ClusterLoggingTypes.AUTHENTICATOR, eks.ClusterLoggingTypes.SCHEDULER
     ]
 )
@@ -2892,7 +2892,7 @@ class AlbControllerOptions:
         Example::
 
             eks.Cluster(self, "HelloEKS",
-                version=eks.KubernetesVersion.V1_30,
+                version=eks.KubernetesVersion.V1_31,
                 alb_controller=eks.AlbControllerOptions(
                     version=eks.AlbControllerVersion.V2_8_2
                 )
@@ -3085,7 +3085,7 @@ class AlbControllerVersion(
     Example::
 
         eks.Cluster(self, "HelloEKS",
-            version=eks.KubernetesVersion.V1_30,
+            version=eks.KubernetesVersion.V1_31,
             alb_controller=eks.AlbControllerOptions(
                 version=eks.AlbControllerVersion.V2_8_2
             )
@@ -3364,14 +3364,14 @@ class AuthenticationMode(enum.Enum):
 
     Example::
 
-        from aws_cdk.lambda_layer_kubectl_v30 import KubectlV30Layer
+        from aws_cdk.lambda_layer_kubectl_v31 import KubectlV31Layer
         # vpc: ec2.Vpc
         
         
         eks.Cluster(self, "Cluster",
             vpc=vpc,
-            version=eks.KubernetesVersion.V1_30,
-            kubectl_layer=KubectlV30Layer(self, "KubectlLayer"),
+            version=eks.KubernetesVersion.V1_31,
+            kubectl_layer=KubectlV31Layer(self, "KubectlLayer"),
             authentication_mode=eks.AuthenticationMode.API_AND_CONFIG_MAP
         )
     '''
@@ -10707,7 +10707,7 @@ class ClusterLoggingTypes(enum.Enum):
 
         cluster = eks.Cluster(self, "Cluster",
             # ...
-            version=eks.KubernetesVersion.V1_30,
+            version=eks.KubernetesVersion.V1_31,
             cluster_logging=[eks.ClusterLoggingTypes.API, eks.ClusterLoggingTypes.AUTHENTICATOR, eks.ClusterLoggingTypes.SCHEDULER
             ]
         )
@@ -10946,7 +10946,7 @@ class DefaultCapacityType(enum.Enum):
     Example::
 
         cluster = eks.Cluster(self, "HelloEKS",
-            version=eks.KubernetesVersion.V1_30,
+            version=eks.KubernetesVersion.V1_31,
             default_capacity_type=eks.DefaultCapacityType.EC2
         )
     '''
@@ -11115,7 +11115,7 @@ class EndpointAccess(
     Example::
 
         cluster = eks.Cluster(self, "hello-eks",
-            version=eks.KubernetesVersion.V1_30,
+            version=eks.KubernetesVersion.V1_31,
             endpoint_access=eks.EndpointAccess.PRIVATE
         )
     '''
@@ -13320,7 +13320,7 @@ class IpFamily(enum.Enum):
             subnetcount = subnetcount + 1
         
         cluster = eks.Cluster(self, "hello-eks",
-            version=eks.KubernetesVersion.V1_30,
+            version=eks.KubernetesVersion.V1_31,
             vpc=vpc,
             ip_family=eks.IpFamily.IP_V6,
             vpc_subnets=[ec2.SubnetSelection(subnets=vpc.public_subnets)]
@@ -14448,7 +14448,7 @@ class KubernetesVersion(
         # vpc: ec2.Vpc
         eks.Cluster(self, "MyCluster",
             kubectl_memory=Size.gibibytes(4),
-            version=eks.KubernetesVersion.V1_30
+            version=eks.KubernetesVersion.V1_31
         )
         eks.Cluster.from_cluster_attributes(self, "MyCluster",
             kubectl_memory=Size.gibibytes(4),
@@ -14656,6 +14656,17 @@ class KubernetesVersion(
         '''
         return typing.cast("KubernetesVersion", jsii.sget(cls, "V1_30"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V1_31")
+    def V1_31(cls) -> "KubernetesVersion":
+        '''Kubernetes version 1.31.
+
+        When creating a ``Cluster`` with this version, you need to also specify the
+        ``kubectlLayer`` property with a ``KubectlV31Layer`` from
+        ``@aws-cdk/lambda-layer-kubectl-v31``.
+        '''
+        return typing.cast("KubernetesVersion", jsii.sget(cls, "V1_31"))
+
     @builtins.property
     @jsii.member(jsii_name="version")
     def version(self) -> builtins.str:
@@ -17099,7 +17110,7 @@ class Cluster(
         # vpc: ec2.Vpc
         eks.Cluster(self, "MyCluster",
             kubectl_memory=Size.gibibytes(4),
-            version=eks.KubernetesVersion.V1_30
+            version=eks.KubernetesVersion.V1_31
         )
         eks.Cluster.from_cluster_attributes(self, "MyCluster",
             kubectl_memory=Size.gibibytes(4),
@@ -18817,7 +18828,7 @@ class ClusterProps(ClusterOptions):
             # vpc: ec2.Vpc
             eks.Cluster(self, "MyCluster",
                 kubectl_memory=Size.gibibytes(4),
-                version=eks.KubernetesVersion.V1_30
+                version=eks.KubernetesVersion.V1_31
             )
             eks.Cluster.from_cluster_attributes(self, "MyCluster",
                 kubectl_memory=Size.gibibytes(4),
@@ -19335,7 +19346,7 @@ class FargateCluster(
     Example::
 
         cluster = eks.FargateCluster(self, "MyCluster",
-            version=eks.KubernetesVersion.V1_30
+            version=eks.KubernetesVersion.V1_31
         )
     '''
 
@@ -19552,7 +19563,7 @@ class FargateClusterProps(ClusterOptions):
         Example::
 
             cluster = eks.FargateCluster(self, "MyCluster",
-                version=eks.KubernetesVersion.V1_30
+                version=eks.KubernetesVersion.V1_31
             )
         '''
         if isinstance(alb_controller, dict):