aws-cdk-lib 2.155.0__py3-none-any.whl → 2.156.0__py3-none-any.whl

aws_cdk/aws_ecs_patterns/__init__.py

@@ -1124,7 +1124,46 @@ queue_processing_fargate_service = ecs_patterns.NetworkLoadBalancedFargateServic
 )
 ```
 
-### Use dualstack NLB
+### Use dualstack Load Balancer
+
+You can use dualstack IP address type for Application Load Balancer and Network Load Balancer.
+
+To use dualstack IP address type, you must have associated IPv6 CIDR blocks with the VPC and subnets and set the `ipAddressType` to `IpAddressType.DUAL_STACK` when creating the load balancer.
+
+### Application Load Balancer
+
+You can use dualstack Application Load Balancer for Fargate and EC2 services.
+
+```python
+import aws_cdk.aws_elasticloadbalancingv2 as elbv2
+
+
+# The VPC and subnet must have associated IPv6 CIDR blocks.
+vpc = ec2.Vpc(self, "Vpc",
+    ip_protocol=ec2.IpProtocol.DUAL_STACK
+)
+cluster = ecs.Cluster(self, "EcsCluster", vpc=vpc)
+
+service = ecs_patterns.ApplicationLoadBalancedFargateService(self, "myService",
+    cluster=cluster,
+    task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+        image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+    ),
+    ip_address_type=elbv2.IpAddressType.DUAL_STACK
+)
+
+application_load_balanced_ec2_service = ecs_patterns.ApplicationLoadBalancedEc2Service(self, "myService",
+    cluster=cluster,
+    task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+        image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+    ),
+    ip_address_type=elbv2.IpAddressType.DUAL_STACK
+)
+```
+
+### Network Load Balancer
+
+You can use dualstack Network Load Balancer for Fargate and EC2 services.
 
 ```python
 import aws_cdk.aws_elasticloadbalancingv2 as elbv2
@@ -1391,6 +1430,7 @@ class ApplicationLoadBalancedServiceBase(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -1426,6 +1466,7 @@ class ApplicationLoadBalancedServiceBase(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -1462,6 +1503,7 @@ class ApplicationLoadBalancedServiceBase(
             enable_execute_command=enable_execute_command,
             health_check_grace_period=health_check_grace_period,
             idle_timeout=idle_timeout,
+            ip_address_type=ip_address_type,
             listener_port=listener_port,
             load_balancer=load_balancer,
             load_balancer_name=load_balancer_name,
@@ -1592,6 +1634,7 @@ typing.cast(typing.Any, ApplicationLoadBalancedServiceBase).__jsii_proxy_class__
         "enable_execute_command": "enableExecuteCommand",
         "health_check_grace_period": "healthCheckGracePeriod",
         "idle_timeout": "idleTimeout",
+        "ip_address_type": "ipAddressType",
         "listener_port": "listenerPort",
         "load_balancer": "loadBalancer",
         "load_balancer_name": "loadBalancerName",
@@ -1628,6 +1671,7 @@ class ApplicationLoadBalancedServiceBaseProps:
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -1661,6 +1705,7 @@ class ApplicationLoadBalancedServiceBaseProps:
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -1740,6 +1785,7 @@ class ApplicationLoadBalancedServiceBaseProps:
                 enable_execute_command=False,
                 health_check_grace_period=cdk.Duration.minutes(30),
                 idle_timeout=cdk.Duration.minutes(30),
+                ip_address_type=elbv2.IpAddressType.IPV4,
                 listener_port=123,
                 load_balancer=application_load_balancer,
                 load_balancer_name="loadBalancerName",
@@ -1804,6 +1850,7 @@ class ApplicationLoadBalancedServiceBaseProps:
             check_type(argname="argument enable_execute_command", value=enable_execute_command, expected_type=type_hints["enable_execute_command"])
             check_type(argname="argument health_check_grace_period", value=health_check_grace_period, expected_type=type_hints["health_check_grace_period"])
             check_type(argname="argument idle_timeout", value=idle_timeout, expected_type=type_hints["idle_timeout"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument listener_port", value=listener_port, expected_type=type_hints["listener_port"])
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
@@ -1848,6 +1895,8 @@ class ApplicationLoadBalancedServiceBaseProps:
             self._values["health_check_grace_period"] = health_check_grace_period
         if idle_timeout is not None:
             self._values["idle_timeout"] = idle_timeout
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if listener_port is not None:
             self._values["listener_port"] = listener_port
         if load_balancer is not None:
@@ -2027,6 +2076,15 @@ class ApplicationLoadBalancedServiceBaseProps:
         result = self._values.get("idle_timeout")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[_IpAddressType_c43b240e]:
+        '''The type of IP address to use.
+
+        :default: - IpAddressType.IPV4
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[_IpAddressType_c43b240e], result)
+
     @builtins.property
     def listener_port(self) -> typing.Optional[jsii.Number]:
         '''Listener port of the application load balancer that will serve traffic to the service.
@@ -7346,6 +7404,7 @@ class ApplicationLoadBalancedEc2Service(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -7387,6 +7446,7 @@ class ApplicationLoadBalancedEc2Service(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -7429,6 +7489,7 @@ class ApplicationLoadBalancedEc2Service(
             enable_execute_command=enable_execute_command,
             health_check_grace_period=health_check_grace_period,
             idle_timeout=idle_timeout,
+            ip_address_type=ip_address_type,
             listener_port=listener_port,
             load_balancer=load_balancer,
             load_balancer_name=load_balancer_name,
@@ -7480,6 +7541,7 @@ class ApplicationLoadBalancedEc2Service(
         "enable_execute_command": "enableExecuteCommand",
         "health_check_grace_period": "healthCheckGracePeriod",
         "idle_timeout": "idleTimeout",
+        "ip_address_type": "ipAddressType",
         "listener_port": "listenerPort",
         "load_balancer": "loadBalancer",
         "load_balancer_name": "loadBalancerName",
@@ -7522,6 +7584,7 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -7561,6 +7624,7 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -7629,6 +7693,7 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
             check_type(argname="argument enable_execute_command", value=enable_execute_command, expected_type=type_hints["enable_execute_command"])
             check_type(argname="argument health_check_grace_period", value=health_check_grace_period, expected_type=type_hints["health_check_grace_period"])
             check_type(argname="argument idle_timeout", value=idle_timeout, expected_type=type_hints["idle_timeout"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument listener_port", value=listener_port, expected_type=type_hints["listener_port"])
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
@@ -7679,6 +7744,8 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
             self._values["health_check_grace_period"] = health_check_grace_period
         if idle_timeout is not None:
             self._values["idle_timeout"] = idle_timeout
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if listener_port is not None:
             self._values["listener_port"] = listener_port
         if load_balancer is not None:
@@ -7870,6 +7937,15 @@ class ApplicationLoadBalancedEc2ServiceProps(ApplicationLoadBalancedServiceBaseP
         result = self._values.get("idle_timeout")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[_IpAddressType_c43b240e]:
+        '''The type of IP address to use.
+
+        :default: - IpAddressType.IPV4
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[_IpAddressType_c43b240e], result)
+
     @builtins.property
     def listener_port(self) -> typing.Optional[jsii.Number]:
         '''Listener port of the application load balancer that will serve traffic to the service.
@@ -8175,11 +8251,20 @@ class ApplicationLoadBalancedFargateService(
             cpu=512,
             task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
                 image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
-            ),
-            task_subnets=ec2.SubnetSelection(
-                subnets=[ec2.Subnet.from_subnet_id(self, "subnet", "VpcISOLATEDSubnet1Subnet80F07FA0")]
-            ),
-            load_balancer_name="application-lb-name"
+            )
+        )
+        
+        scalable_target = load_balanced_fargate_service.service.auto_scale_task_count(
+            min_capacity=1,
+            max_capacity=20
+        )
+        
+        scalable_target.scale_on_cpu_utilization("CpuScaling",
+            target_utilization_percent=50
+        )
+        
+        scalable_target.scale_on_memory_utilization("MemoryScaling",
+            target_utilization_percent=50
         )
     '''
 
@@ -8205,6 +8290,7 @@ class ApplicationLoadBalancedFargateService(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -8250,6 +8336,7 @@ class ApplicationLoadBalancedFargateService(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -8296,6 +8383,7 @@ class ApplicationLoadBalancedFargateService(
             enable_execute_command=enable_execute_command,
             health_check_grace_period=health_check_grace_period,
             idle_timeout=idle_timeout,
+            ip_address_type=ip_address_type,
             listener_port=listener_port,
             load_balancer=load_balancer,
             load_balancer_name=load_balancer_name,
@@ -8361,6 +8449,7 @@ class ApplicationLoadBalancedFargateService(
         "enable_execute_command": "enableExecuteCommand",
         "health_check_grace_period": "healthCheckGracePeriod",
         "idle_timeout": "idleTimeout",
+        "ip_address_type": "ipAddressType",
         "listener_port": "listenerPort",
         "load_balancer": "loadBalancer",
         "load_balancer_name": "loadBalancerName",
@@ -8410,6 +8499,7 @@ class ApplicationLoadBalancedFargateServiceProps(
         enable_execute_command: typing.Optional[builtins.bool] = None,
         health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
         idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+        ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
         listener_port: typing.Optional[jsii.Number] = None,
         load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
         load_balancer_name: typing.Optional[builtins.str] = None,
@@ -8453,6 +8543,7 @@ class ApplicationLoadBalancedFargateServiceProps(
         :param enable_execute_command: Whether ECS Exec should be enabled. Default: - false
         :param health_check_grace_period: The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already set
         :param idle_timeout: The load balancer idle timeout, in seconds. Can be between 1 and 4000 seconds Default: - CloudFormation sets idle timeout to 60 seconds
+        :param ip_address_type: The type of IP address to use. Default: - IpAddressType.IPV4
         :param listener_port: Listener port of the application load balancer that will serve traffic to the service. Default: - The default listener port is determined from the protocol (port 80 for HTTP, port 443 for HTTPS). A domain name and zone must be also be specified if using HTTPS.
         :param load_balancer: The application load balancer that will serve traffic to the service. The VPC attribute of a load balancer must be specified for it to be used to create a new service with this pattern. [disable-awslint:ref-via-interface] Default: - a new load balancer will be created.
         :param load_balancer_name: Name of the load balancer. Default: - Automatically generated name.
@@ -8494,11 +8585,20 @@ class ApplicationLoadBalancedFargateServiceProps(
                 cpu=512,
                 task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
                     image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
-                ),
-                task_subnets=ec2.SubnetSelection(
-                    subnets=[ec2.Subnet.from_subnet_id(self, "subnet", "VpcISOLATEDSubnet1Subnet80F07FA0")]
-                ),
-                load_balancer_name="application-lb-name"
+                )
+            )
+            
+            scalable_target = load_balanced_fargate_service.service.auto_scale_task_count(
+                min_capacity=1,
+                max_capacity=20
+            )
+            
+            scalable_target.scale_on_cpu_utilization("CpuScaling",
+                target_utilization_percent=50
+            )
+            
+            scalable_target.scale_on_memory_utilization("MemoryScaling",
+                target_utilization_percent=50
             )
         '''
         if isinstance(circuit_breaker, dict):
@@ -8530,6 +8630,7 @@ class ApplicationLoadBalancedFargateServiceProps(
             check_type(argname="argument enable_execute_command", value=enable_execute_command, expected_type=type_hints["enable_execute_command"])
             check_type(argname="argument health_check_grace_period", value=health_check_grace_period, expected_type=type_hints["health_check_grace_period"])
             check_type(argname="argument idle_timeout", value=idle_timeout, expected_type=type_hints["idle_timeout"])
+            check_type(argname="argument ip_address_type", value=ip_address_type, expected_type=type_hints["ip_address_type"])
             check_type(argname="argument listener_port", value=listener_port, expected_type=type_hints["listener_port"])
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
             check_type(argname="argument load_balancer_name", value=load_balancer_name, expected_type=type_hints["load_balancer_name"])
@@ -8584,6 +8685,8 @@ class ApplicationLoadBalancedFargateServiceProps(
             self._values["health_check_grace_period"] = health_check_grace_period
         if idle_timeout is not None:
             self._values["idle_timeout"] = idle_timeout
+        if ip_address_type is not None:
+            self._values["ip_address_type"] = ip_address_type
         if listener_port is not None:
             self._values["listener_port"] = listener_port
         if load_balancer is not None:
@@ -8783,6 +8886,15 @@ class ApplicationLoadBalancedFargateServiceProps(
         result = self._values.get("idle_timeout")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def ip_address_type(self) -> typing.Optional[_IpAddressType_c43b240e]:
+        '''The type of IP address to use.
+
+        :default: - IpAddressType.IPV4
+        '''
+        result = self._values.get("ip_address_type")
+        return typing.cast(typing.Optional[_IpAddressType_c43b240e], result)
+
     @builtins.property
     def listener_port(self) -> typing.Optional[jsii.Number]:
         '''Listener port of the application load balancer that will serve traffic to the service.
@@ -16055,6 +16167,7 @@ def _typecheckingstub__8c3ede040de35ed817f7c39537976690e81673c7be443b152e959f7f9
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16110,6 +16223,7 @@ def _typecheckingstub__a68b3d7133b7b22b27e8c904e21f15f3a38d6a44c16a16cdf89d4051b
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16694,6 +16808,7 @@ def _typecheckingstub__c7c2728dc66395799b8f32553505628c230427b49bbbc6fd682aa7208
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16730,6 +16845,7 @@ def _typecheckingstub__b3f33e583b66138930e8047d22ea9454885645ecc97e1b8505d5c0a26
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16778,6 +16894,7 @@ def _typecheckingstub__52e4707f036e6b5ab8a12a1dd88ad78656d9ef102eb7d04caef957d69
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,
@@ -16820,6 +16937,7 @@ def _typecheckingstub__cdcb8bd483faaddad588ad37d4527fa1a0028fc2307a21fc3690044a0
     enable_execute_command: typing.Optional[builtins.bool] = None,
     health_check_grace_period: typing.Optional[_Duration_4839e8c3] = None,
     idle_timeout: typing.Optional[_Duration_4839e8c3] = None,
+    ip_address_type: typing.Optional[_IpAddressType_c43b240e] = None,
     listener_port: typing.Optional[jsii.Number] = None,
     load_balancer: typing.Optional[_IApplicationLoadBalancer_4cbd50ab] = None,
     load_balancer_name: typing.Optional[builtins.str] = None,

aws_cdk/aws_eks/__init__.py

@@ -660,7 +660,7 @@ The default value is `eks.EndpointAccess.PUBLIC_AND_PRIVATE`. Which means the cl
 
 ### Alb Controller
 
-Some Kubernetes resources are commonly implemented on AWS with the help of the [ALB Controller](https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.5/).
+Some Kubernetes resources are commonly implemented on AWS with the help of the [ALB Controller](https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/).
 
 From the docs:
 
@@ -675,7 +675,7 @@ To deploy the controller on your EKS cluster, configure the `albController` prop
 eks.Cluster(self, "HelloEKS",
     version=eks.KubernetesVersion.V1_30,
     alb_controller=eks.AlbControllerOptions(
-        version=eks.AlbControllerVersion.V2_6_2
+        version=eks.AlbControllerVersion.V2_8_2
     )
 )
 ```
@@ -2879,7 +2879,7 @@ class AlbControllerOptions:
             eks.Cluster(self, "HelloEKS",
                 version=eks.KubernetesVersion.V1_30,
                 alb_controller=eks.AlbControllerOptions(
-                    version=eks.AlbControllerVersion.V2_6_2
+                    version=eks.AlbControllerVersion.V2_8_2
                 )
             )
         '''
@@ -3072,7 +3072,7 @@ class AlbControllerVersion(
         eks.Cluster(self, "HelloEKS",
             version=eks.KubernetesVersion.V1_30,
             alb_controller=eks.AlbControllerOptions(
-                version=eks.AlbControllerVersion.V2_6_2
+                version=eks.AlbControllerVersion.V2_8_2
             )
         )
     '''
@@ -3269,6 +3269,42 @@ class AlbControllerVersion(
         '''v2.6.2.'''
         return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_6_2"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_7_0")
+    def V2_7_0(cls) -> "AlbControllerVersion":
+        '''v2.7.0.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_7_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_7_1")
+    def V2_7_1(cls) -> "AlbControllerVersion":
+        '''v2.7.1.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_7_1"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_7_2")
+    def V2_7_2(cls) -> "AlbControllerVersion":
+        '''v2.7.2.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_7_2"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_8_0")
+    def V2_8_0(cls) -> "AlbControllerVersion":
+        '''v2.8.0.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_8_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_8_1")
+    def V2_8_1(cls) -> "AlbControllerVersion":
+        '''v2.8.1.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_8_1"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="V2_8_2")
+    def V2_8_2(cls) -> "AlbControllerVersion":
+        '''v2.8.2.'''
+        return typing.cast("AlbControllerVersion", jsii.sget(cls, "V2_8_2"))
+
     @builtins.property
     @jsii.member(jsii_name="custom")
     def custom(self) -> builtins.bool:

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -1021,7 +1021,7 @@ class AddNetworkTargetsProps:
     ) -> None:
         '''Properties for adding new network targets to a listener.
 
-        :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
+        :param port: The port on which the target receives traffic. Default: Determined from protocol if known
         :param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
         :param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param preserve_client_ip: Indicates whether client IP preservation is enabled. Default: false if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, true.
@@ -1092,7 +1092,7 @@ class AddNetworkTargetsProps:
 
     @builtins.property
     def port(self) -> jsii.Number:
-        '''The port on which the listener listens for requests.
+        '''The port on which the target receives traffic.
 
         :default: Determined from protocol if known
         '''
@@ -14942,53 +14942,29 @@ class IpAddressType(enum.Enum):
 
     Example::
 
-        # vpc: ec2.Vpc
-        
-        
-        lb = elbv2.ApplicationLoadBalancer(self, "LB",
-            vpc=vpc,
-            internet_facing=True,
+        import aws_cdk.aws_elasticloadbalancingv2 as elbv2
         
-            # Whether HTTP/2 is enabled
-            http2_enabled=False,
-        
-            # The idle timeout value, in seconds
-            idle_timeout=Duration.seconds(1000),
         
-            # Whether HTTP headers with header fields thatare not valid
-            # are removed by the load balancer (true), or routed to targets
-            drop_invalid_header_fields=True,
-        
-            # How the load balancer handles requests that might
-            # pose a security risk to your application
-            desync_mitigation_mode=elbv2.DesyncMitigationMode.DEFENSIVE,
-        
-            # The type of IP addresses to use.
-            ip_address_type=elbv2.IpAddressType.IPV4,
-        
-            # The duration of client keep-alive connections
-            client_keep_alive=Duration.seconds(500),
-        
-            # Whether cross-zone load balancing is enabled.
-            cross_zone_enabled=True,
-        
-            # Whether the load balancer blocks traffic through the Internet Gateway (IGW).
-            deny_all_igw_traffic=False,
-        
-            # Whether to preserve host header in the request to the target
-            preserve_host_header=True,
-        
-            # Whether to add the TLS information header to the request
-            x_amzn_tls_version_and_cipher_suite_headers=True,
-        
-            # Whether the X-Forwarded-For header should preserve the source port
-            preserve_xff_client_port=True,
+        # The VPC and subnet must have associated IPv6 CIDR blocks.
+        vpc = ec2.Vpc(self, "Vpc",
+            ip_protocol=ec2.IpProtocol.DUAL_STACK
+        )
+        cluster = ecs.Cluster(self, "EcsCluster", vpc=vpc)
         
-            # The processing mode for X-Forwarded-For headers
-            xff_header_processing_mode=elbv2.XffHeaderProcessingMode.APPEND,
+        service = ecs_patterns.ApplicationLoadBalancedFargateService(self, "myService",
+            cluster=cluster,
+            task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+                image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+            ),
+            ip_address_type=elbv2.IpAddressType.DUAL_STACK
+        )
         
-            # Whether to allow a load balancer to route requests to targets if it is unable to forward the request to AWS WAF.
-            waf_fail_open=True
+        application_load_balanced_ec2_service = ecs_patterns.ApplicationLoadBalancedEc2Service(self, "myService",
+            cluster=cluster,
+            task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+                image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+            ),
+            ip_address_type=elbv2.IpAddressType.DUAL_STACK
         )
     '''
 
@@ -21794,7 +21770,7 @@ class NetworkListener(
         one set of targets must be added without conditions.
 
         :param id: -
-        :param port: The port on which the listener listens for requests. Default: Determined from protocol if known
+        :param port: The port on which the target receives traffic. Default: Determined from protocol if known
         :param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
         :param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
         :param preserve_client_ip: Indicates whether client IP preservation is enabled. Default: false if the target group type is IP address and the target group protocol is TCP or TLS. Otherwise, true.