aws-cdk-lib 2.73.0__py3-none-any.whl → 2.76.0__py3-none-any.whl

aws_cdk/aws_ecs_patterns/__init__.py

@@ -880,6 +880,7 @@ stack.node.set_context(cxapi.ECS_REMOVE_DEFAULT_DESIRED_COUNT, True)
 The following is an example of an application with the REMOVE_DEFAULT_DESIRED_COUNT feature flag enabled:
 
 ```python
+from constructs import Construct
 from aws_cdk import App, Stack
 import aws_cdk.aws_ec2 as ec2
 import aws_cdk.aws_ecs as ecs
@@ -887,20 +888,21 @@ import aws_cdk.aws_ecs_patterns as ecs_patterns
 import aws_cdk.cx_api as cxapi
 import path as path
 
-app = App()
+class MyStack(Stack):
+    def __init__(self, scope, id):
+        super().__init__(scope, id)
 
-stack = Stack(app, "aws-ecs-patterns-queue")
-stack.node.set_context(cxapi.ECS_REMOVE_DEFAULT_DESIRED_COUNT, True)
+        self.node.set_context(cxapi.ECS_REMOVE_DEFAULT_DESIRED_COUNT, True)
 
-vpc = ec2.Vpc(stack, "VPC",
-    max_azs=2
-)
+        vpc = ec2.Vpc(self, "VPC",
+            max_azs=2
+        )
 
-ecs_patterns.QueueProcessingFargateService(stack, "QueueProcessingService",
-    vpc=vpc,
-    memory_limit_mi_b=512,
-    image=ecs.AssetImage(path.join(__dirname, "..", "sqs-reader"))
-)
+        ecs_patterns.QueueProcessingFargateService(self, "QueueProcessingService",
+            vpc=vpc,
+            memory_limit_mi_b=512,
+            image=ecs.AssetImage(path.join(__dirname, "..", "sqs-reader"))
+        )
 ```
 
 ### Deploy application and metrics sidecar

aws_cdk/aws_eks/__init__.py

@@ -41,7 +41,10 @@ This example defines an Amazon EKS cluster with the following configuration:
 
 ```python
 # Example automatically generated from non-compiling source. May contain errors.
-# provisiong a cluster
+from aws_cdk.lambda_layer_kubectl_v25 import KubectlV25Layer
+
+
+# provisioning a cluster
 cluster = eks.Cluster(self, "hello-eks",
     version=eks.KubernetesVersion.V1_25,
     kubectl_layer=KubectlV25Layer(self, "kubectl")
@@ -687,7 +690,7 @@ version, you will need to use one of the `@aws-cdk/lambda-layer-kubectl-vXY` pac
 
 ```python
 # Example automatically generated from non-compiling source. May contain errors.
-from aws_cdk_lib.lambda_layer_kubectl_v25 import KubectlV25Layer
+from aws_cdk.lambda_layer_kubectl_v25 import KubectlV25Layer
 
 
 cluster = eks.Cluster(self, "hello-eks",
@@ -1191,7 +1194,9 @@ cluster.add_helm_chart("test-chart",
 Nested values passed to the `values` parameter should be provided as a nested dictionary:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
+# cluster: eks.Cluster
+
+
 cluster.add_helm_chart("ExternalSecretsOperator",
     chart="external-secrets",
     release="external-secrets",
@@ -1282,12 +1287,12 @@ To get started, add the following dependencies to your `package.json` file:
 ```json
 "dependencies": {
   "cdk8s": "^2.0.0",
-  "cdk8s-plus-22": "^2.0.0-rc.30",
+  "cdk8s-plus-25": "^2.0.0",
   "constructs": "^10.0.0"
 }
 ```
 
-Note that here we are using `cdk8s-plus-22` as we are targeting Kubernetes version 1.22.0. If you operate a different kubernetes version, you should
+Note that here we are using `cdk8s-plus-25` as we are targeting Kubernetes version 1.25.0. If you operate a different kubernetes version, you should
 use the corresponding `cdk8s-plus-XX` library.
 See [Select the appropriate cdk8s+ library](https://cdk8s.io/docs/latest/plus/#i-operate-kubernetes-version-1xx-which-cdk8s-library-should-i-be-using)
 for more details.
@@ -1304,7 +1309,7 @@ In this example we create a chart that accepts an `s3.Bucket` and passes its nam
 from aws_cdk import aws_s3 as s3
 import constructs as constructs
 import cdk8s as cdk8s
-import cdk8s_plus_22 as kplus
+import cdk8s_plus_25 as kplus
 
 class MyChart(cdk8s.Chart):
     def __init__(self, scope, id, *, bucket):
@@ -1341,14 +1346,14 @@ cluster.add_cdk8s_chart("my-chart", my_chart)
 #### Custom CDK8s Constructs
 
 You can also compose a few stock `cdk8s+` constructs into your own custom construct. However, since mixing scopes between `aws-cdk` and `cdk8s` is currently not supported, the `Construct` class
-you'll need to use is the one from the [`constructs`](https://github.com/aws/constructs) module, and not from `@aws-cdk/core` like you normally would.
+you'll need to use is the one from the [`constructs`](https://github.com/aws/constructs) module, and not from `aws-cdk-lib` like you normally would.
 This is why we used `new cdk8s.App()` as the scope of the chart above.
 
 ```python
 # Example automatically generated from non-compiling source. May contain errors.
 import constructs as constructs
 import cdk8s as cdk8s
-import cdk8s_plus_21 as kplus
+import cdk8s_plus_25 as kplus
 
 app = cdk8s.App()
 chart = cdk8s.Chart(app, "my-chart")

aws_cdk/aws_elasticloadbalancing/__init__.py

@@ -46,15 +46,17 @@ lb.add_listener(
 You can add an EC2 instance to the load balancer by calling using `new InstanceTarget` as the argument to `addTarget()`:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
+# vpc: ec2.IVpc
+
 lb = elb.LoadBalancer(self, "LB",
     vpc=vpc
 )
+
 # instance to add as the target for load balancer.
-instance = Instance(stack, "targetInstance",
+instance = ec2.Instance(self, "targetInstance",
     vpc=vpc,
-    instance_type=InstanceType.of(InstanceClass.BURSTABLE2, InstanceSize.MICRO),
-    machine_image=AmazonLinuxImage()
+    instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE2, ec2.InstanceSize.MICRO),
+    machine_image=ec2.AmazonLinuxImage(generation=ec2.AmazonLinuxGeneration.AMAZON_LINUX_2)
 )
 lb.add_target(elb.InstanceTarget(instance))
 ```
@@ -2072,15 +2074,17 @@ class InstanceTarget(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
+        # vpc: ec2.IVpc
+        
         lb = elb.LoadBalancer(self, "LB",
             vpc=vpc
         )
+        
         # instance to add as the target for load balancer.
-        instance = Instance(stack, "targetInstance",
+        instance = ec2.Instance(self, "targetInstance",
             vpc=vpc,
-            instance_type=InstanceType.of(InstanceClass.BURSTABLE2, InstanceSize.MICRO),
-            machine_image=AmazonLinuxImage()
+            instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE2, ec2.InstanceSize.MICRO),
+            machine_image=ec2.AmazonLinuxImage(generation=ec2.AmazonLinuxGeneration.AMAZON_LINUX_2)
         )
         lb.add_target(elb.InstanceTarget(instance))
     '''
@@ -2570,7 +2574,10 @@ class LoadBalancerProps:
             
             lb = elb.LoadBalancer(self, "LB", vpc=vpc)
             lb.add_listener(external_port=80)
-            lb.add_target(service)
+            lb.add_target(service.load_balancer_target(
+                container_name="MyContainer",
+                container_port=80
+            ))
         '''
         if isinstance(access_logging_policy, dict):
             access_logging_policy = CfnLoadBalancer.AccessLoggingPolicyProperty(**access_logging_policy)

aws_cdk/aws_elasticloadbalancingv2/__init__.py

@@ -17,7 +17,6 @@ and adding Targets to the Listener:
 ```python
 from aws_cdk.aws_autoscaling import AutoScalingGroup
 # asg: AutoScalingGroup
-
 # vpc: ec2.Vpc
 
 
@@ -204,7 +203,9 @@ ingress rules then set `open: false` and use the listener's `connections` object
 You can modify attributes of Application Load Balancers:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
+# vpc: ec2.Vpc
+
+
 lb = elbv2.ApplicationLoadBalancer(self, "LB",
     vpc=vpc,
     internet_facing=True,
@@ -213,7 +214,7 @@ lb = elbv2.ApplicationLoadBalancer(self, "LB",
     http2_enabled=False,
 
     # The idle timeout value, in seconds
-    idle_timeout=cdk.Duration.seconds(1000),
+    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
@@ -616,7 +617,6 @@ You may create metrics for Load Balancers and Target Groups through the `metrics
 **Load Balancer:**
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # alb: elbv2.IApplicationLoadBalancer
 
 
@@ -627,7 +627,6 @@ metric_connection_count = alb_metrics.active_connection_count()
 **Target Group:**
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # target_group: elbv2.IApplicationTargetGroup
 
 
@@ -638,11 +637,10 @@ metric_healthy_host_count = target_group_metrics.healthy_host_count()
 Metrics are also available to imported resources:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # stack: Stack
 
 
-target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(stack, "MyTargetGroup",
+target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(self, "MyTargetGroup",
     target_group_arn=Fn.import_value("TargetGroupArn"),
     load_balancer_arns=Fn.import_value("LoadBalancerArn")
 )
@@ -654,10 +652,9 @@ Notice that TargetGroups must be imported by supplying the Load Balancer too, ot
 throw an error:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # stack: Stack
 
-target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(stack, "MyTargetGroup",
+target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(self, "MyTargetGroup",
     target_group_arn=Fn.import_value("TargetGroupArn")
 )
 
@@ -1956,18 +1953,20 @@ class BaseApplicationListenerProps:
 
         Example::
 
-            from aws_cdk.aws_apigatewayv2_integrations_alpha import HttpAlbIntegration
-            
-            # lb: elbv2.ApplicationLoadBalancer
+            # cluster: ecs.Cluster
+            # task_definition: ecs.TaskDefinition
+            # vpc: ec2.Vpc
             
-            listener = lb.add_listener("listener", port=80)
-            listener.add_targets("target",
-                port=80
-            )
+            service = ecs.FargateService(self, "Service", cluster=cluster, task_definition=task_definition)
             
-            http_endpoint = apigwv2.HttpApi(self, "HttpProxyPrivateApi",
-                default_integration=HttpAlbIntegration("DefaultIntegration", listener,
-                    parameter_mapping=apigwv2.ParameterMapping().custom("myKey", "myValue")
+            lb = elbv2.ApplicationLoadBalancer(self, "LB", vpc=vpc, internet_facing=True)
+            listener = lb.add_listener("Listener", port=80)
+            service.register_load_balancer_targets(
+                container_name="web",
+                container_port=80,
+                new_target_group_id="ECS",
+                listener=ecs.ListenerConfig.application_listener(listener,
+                    protocol=elbv2.ApplicationProtocol.HTTPS
                 )
             )
         '''
@@ -9564,7 +9563,9 @@ class DesyncMitigationMode(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
+        # vpc: ec2.Vpc
+        
+        
         lb = elbv2.ApplicationLoadBalancer(self, "LB",
             vpc=vpc,
             internet_facing=True,
@@ -9573,7 +9574,7 @@ class DesyncMitigationMode(enum.Enum):
             http2_enabled=False,
         
             # The idle timeout value, in seconds
-            idle_timeout=cdk.Duration.seconds(1000),
+            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
@@ -9974,7 +9975,66 @@ class HttpCodeElb(enum.Enum):
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_elasticloadbalancingv2.HttpCodeTarget")
 class HttpCodeTarget(enum.Enum):
-    '''Count of HTTP status originating from the targets.'''
+    '''Count of HTTP status originating from the targets.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_cloudwatch as cloudwatch
+        
+        # service: ecs.FargateService
+        # blue_target_group: elbv2.ApplicationTargetGroup
+        # green_target_group: elbv2.ApplicationTargetGroup
+        # listener: elbv2.IApplicationListener
+        
+        
+        # Alarm on the number of unhealthy ECS tasks in each target group
+        blue_unhealthy_hosts = cloudwatch.Alarm(self, "BlueUnhealthyHosts",
+            alarm_name=Stack.of(self).stack_name + "-Unhealthy-Hosts-Blue",
+            metric=blue_target_group.metric_unhealthy_host_count(),
+            threshold=1,
+            evaluation_periods=2
+        )
+        
+        green_unhealthy_hosts = cloudwatch.Alarm(self, "GreenUnhealthyHosts",
+            alarm_name=Stack.of(self).stack_name + "-Unhealthy-Hosts-Green",
+            metric=green_target_group.metric_unhealthy_host_count(),
+            threshold=1,
+            evaluation_periods=2
+        )
+        
+        # Alarm on the number of HTTP 5xx responses returned by each target group
+        blue_api_failure = cloudwatch.Alarm(self, "Blue5xx",
+            alarm_name=Stack.of(self).stack_name + "-Http-5xx-Blue",
+            metric=blue_target_group.metric_http_code_target(elbv2.HttpCodeTarget.TARGET_5XX_COUNT, period=Duration.minutes(1)),
+            threshold=1,
+            evaluation_periods=1
+        )
+        
+        green_api_failure = cloudwatch.Alarm(self, "Green5xx",
+            alarm_name=Stack.of(self).stack_name + "-Http-5xx-Green",
+            metric=green_target_group.metric_http_code_target(elbv2.HttpCodeTarget.TARGET_5XX_COUNT, period=Duration.minutes(1)),
+            threshold=1,
+            evaluation_periods=1
+        )
+        
+        codedeploy.EcsDeploymentGroup(self, "BlueGreenDG",
+            # CodeDeploy will monitor these alarms during a deployment and automatically roll back
+            alarms=[blue_unhealthy_hosts, green_unhealthy_hosts, blue_api_failure, green_api_failure],
+            auto_rollback=codedeploy.AutoRollbackConfig(
+                # CodeDeploy will automatically roll back if a deployment is stopped
+                stopped_deployment=True
+            ),
+            service=service,
+            blue_green_deployment_config=codedeploy.EcsBlueGreenDeploymentConfig(
+                blue_target_group=blue_target_group,
+                green_target_group=green_target_group,
+                listener=listener
+            ),
+            deployment_config=codedeploy.EcsDeploymentConfig.CANARY_10PERCENT_5MINUTES
+        )
+    '''
 
     TARGET_2XX_COUNT = "TARGET_2XX_COUNT"
     '''The number of 2xx response codes from targets.'''
@@ -13589,16 +13649,21 @@ class ListenerAction(
     Example::
 
         # listener: elbv2.ApplicationListener
+        # my_target_group: elbv2.ApplicationTargetGroup
         
         
-        listener.add_action("Fixed",
-            priority=10,
-            conditions=[
-                elbv2.ListenerCondition.path_patterns(["/ok"])
-            ],
-            action=elbv2.ListenerAction.fixed_response(200,
-                content_type="text/plain",
-                message_body="OK"
+        listener.add_action("DefaultAction",
+            action=elbv2.ListenerAction.authenticate_oidc(
+                authorization_endpoint="https://example.com/openid",
+                # Other OIDC properties here
+                client_id="...",
+                client_secret=SecretValue.secrets_manager("..."),
+                issuer="...",
+                token_endpoint="...",
+                user_info_endpoint="...",
+        
+                # Next
+                next=elbv2.ListenerAction.forward([my_target_group])
             )
         )
     '''
@@ -14617,18 +14682,23 @@ class NetworkLoadBalancer(
 
     Example::
 
-        from aws_cdk.aws_apigatewayv2_integrations_alpha import HttpNlbIntegration
+        import aws_cdk.aws_elasticloadbalancingv2 as elbv2
         
         
         vpc = ec2.Vpc(self, "VPC")
-        lb = elbv2.NetworkLoadBalancer(self, "lb", vpc=vpc)
-        listener = lb.add_listener("listener", port=80)
-        listener.add_targets("target",
-            port=80
+        nlb = elbv2.NetworkLoadBalancer(self, "NLB",
+            vpc=vpc
+        )
+        link = apigateway.VpcLink(self, "link",
+            targets=[nlb]
         )
         
-        http_endpoint = apigwv2.HttpApi(self, "HttpProxyPrivateApi",
-            default_integration=HttpNlbIntegration("DefaultIntegration", listener)
+        integration = apigateway.Integration(
+            type=apigateway.IntegrationType.HTTP_PROXY,
+            options=apigateway.IntegrationOptions(
+                connection_type=apigateway.ConnectionType.VPC_LINK,
+                vpc_link=link
+            )
         )
     '''
 
@@ -15370,18 +15440,23 @@ class NetworkLoadBalancerProps(BaseLoadBalancerProps):
 
         Example::
 
-            from aws_cdk.aws_apigatewayv2_integrations_alpha import HttpNlbIntegration
+            import aws_cdk.aws_elasticloadbalancingv2 as elbv2
             
             
             vpc = ec2.Vpc(self, "VPC")
-            lb = elbv2.NetworkLoadBalancer(self, "lb", vpc=vpc)
-            listener = lb.add_listener("listener", port=80)
-            listener.add_targets("target",
-                port=80
+            nlb = elbv2.NetworkLoadBalancer(self, "NLB",
+                vpc=vpc
+            )
+            link = apigateway.VpcLink(self, "link",
+                targets=[nlb]
             )
             
-            http_endpoint = apigwv2.HttpApi(self, "HttpProxyPrivateApi",
-                default_integration=HttpNlbIntegration("DefaultIntegration", listener)
+            integration = apigateway.Integration(
+                type=apigateway.IntegrationType.HTTP_PROXY,
+                options=apigateway.IntegrationOptions(
+                    connection_type=apigateway.ConnectionType.VPC_LINK,
+                    vpc_link=link
+                )
             )
         '''
         if isinstance(vpc_subnets, dict):
@@ -16289,11 +16364,10 @@ class TargetGroupAttributes:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # stack: Stack
             
             
-            target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(stack, "MyTargetGroup",
+            target_group = elbv2.ApplicationTargetGroup.from_target_group_attributes(self, "MyTargetGroup",
                 target_group_arn=Fn.import_value("TargetGroupArn"),
                 load_balancer_arns=Fn.import_value("LoadBalancerArn")
             )
@@ -16944,7 +17018,6 @@ class AddApplicationTargetsProps(AddRuleProps):
 
             from aws_cdk.aws_autoscaling import AutoScalingGroup
             # asg: AutoScalingGroup
-            
             # vpc: ec2.Vpc
             
             
@@ -17754,35 +17827,21 @@ class ApplicationLoadBalancerProps(BaseLoadBalancerProps):
 
         Example::
 
-            from aws_cdk.aws_autoscaling import AutoScalingGroup
-            # asg: AutoScalingGroup
-            
+            # cluster: ecs.Cluster
+            # task_definition: ecs.TaskDefinition
             # vpc: ec2.Vpc
             
+            service = ecs.FargateService(self, "Service", cluster=cluster, task_definition=task_definition)
             
-            # Create the load balancer in a VPC. 'internetFacing' is 'false'
-            # by default, which creates an internal load balancer.
-            lb = elbv2.ApplicationLoadBalancer(self, "LB",
-                vpc=vpc,
-                internet_facing=True
-            )
-            
-            # Add a listener and open up the load balancer's security group
-            # to the world.
-            listener = lb.add_listener("Listener",
-                port=80,
-            
-                # 'open: true' is the default, you can leave it out if you want. Set it
-                # to 'false' and use `listener.connections` if you want to be selective
-                # about who can access the load balancer.
-                open=True
-            )
-            
-            # Create an AutoScaling group and add it as a load balancing
-            # target to the listener.
-            listener.add_targets("ApplicationFleet",
-                port=8080,
-                targets=[asg]
+            lb = elbv2.ApplicationLoadBalancer(self, "LB", vpc=vpc, internet_facing=True)
+            listener = lb.add_listener("Listener", port=80)
+            service.register_load_balancer_targets(
+                container_name="web",
+                container_port=80,
+                new_target_group_id="ECS",
+                listener=ecs.ListenerConfig.application_listener(listener,
+                    protocol=elbv2.ApplicationProtocol.HTTPS
+                )
             )
         '''
         if isinstance(vpc_subnets, dict):
@@ -19430,15 +19489,19 @@ class ApplicationListener(
 
     Example::
 
-        import aws_cdk.aws_elasticloadbalancingv2 as elbv2
+        from aws_cdk.aws_apigatewayv2_integrations_alpha import HttpAlbIntegration
         
-        # alb: elbv2.ApplicationLoadBalancer
+        # lb: elbv2.ApplicationLoadBalancer
         
-        listener = alb.add_listener("Listener", port=80)
-        target_group = listener.add_targets("Fleet", port=80)
+        listener = lb.add_listener("listener", port=80)
+        listener.add_targets("target",
+            port=80
+        )
         
-        deployment_group = codedeploy.ServerDeploymentGroup(self, "DeploymentGroup",
-            load_balancer=codedeploy.LoadBalancer.application(target_group)
+        http_endpoint = apigwv2.HttpApi(self, "HttpProxyPrivateApi",
+            default_integration=HttpAlbIntegration("DefaultIntegration", listener,
+                parameter_mapping=apigwv2.ParameterMapping().custom("myKey", "myValue")
+            )
         )
     '''
 
@@ -19759,7 +19822,6 @@ class ApplicationLoadBalancer(
 
         from aws_cdk.aws_autoscaling import AutoScalingGroup
         # asg: AutoScalingGroup
-        
         # vpc: ec2.Vpc
         
         
@@ -21050,8 +21112,6 @@ class ApplicationTargetGroup(
 
     Example::
 
-        import aws_cdk.aws_elasticloadbalancingv2 as elbv2
-        
         # alb: elbv2.ApplicationLoadBalancer
         
         listener = alb.add_listener("Listener", port=80)