aws-cdk-lib 2.129.0__py3-none-any.whl → 2.131.0__py3-none-any.whl

aws_cdk/aws_ecs/__init__.py

@@ -3200,7 +3200,7 @@ class AsgCapacityProvider(
         :param scope: -
         :param id: -
         :param auto_scaling_group: The autoscaling group to add as a Capacity Provider.
-        :param capacity_provider_name: The name of the capacity provider. If a name is specified, it cannot start with ``aws``, ``ecs``, or ``fargate``. If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used. Default: CloudFormation-generated name
+        :param capacity_provider_name: The name of the capacity provider. If a name is specified, it cannot start with ``aws``, ``ecs``, or ``fargate``. If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used. If the stack name starts with ``aws``, ``ecs``, or ``fargate``, a unique resource name is generated that starts with ``cp-``. Default: CloudFormation-generated name
         :param enable_managed_draining: Managed instance draining facilitates graceful termination of Amazon ECS instances. This allows your service workloads to stop safely and be rescheduled to non-terminating instances. Infrastructure maintenance and updates are preformed without disruptions to workloads. To use managed instance draining, set enableManagedDraining to true. Default: true
         :param enable_managed_scaling: When enabled the scale-in and scale-out actions of the cluster's Auto Scaling Group will be managed for you. This means your cluster will automatically scale instances based on the load your tasks put on the cluster. For more information, see `Using Managed Scaling <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/asg-capacity-providers.html#asg-capacity-providers-managed-scaling>`_ in the ECS Developer Guide. Default: true
         :param enable_managed_termination_protection: When enabled the Auto Scaling Group will only terminate EC2 instances that no longer have running non-daemon tasks. Scale-in protection will be automatically enabled on instances. When all non-daemon tasks are stopped on an instance, ECS initiates the scale-in process and turns off scale-in protection for the instance. The Auto Scaling Group can then terminate the instance. For more information see `Managed termination protection <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-auto-scaling.html#managed-termination-protection>`_ in the ECS Developer Guide. Managed scaling must also be enabled. Default: true
@@ -3322,7 +3322,7 @@ class AsgCapacityProviderProps(AddAutoScalingGroupCapacityOptions):
         :param spot_instance_draining: Specify whether to enable Automated Draining for Spot Instances running Amazon ECS Services. For more information, see `Using Spot Instances <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-spot.html>`_. Default: false
         :param topic_encryption_key: If ``AddAutoScalingGroupCapacityOptions.taskDrainTime`` is non-zero, then the ECS cluster creates an SNS Topic to as part of a system to drain instances of tasks when the instance is being shut down. If this property is provided, then this key will be used to encrypt the contents of that SNS Topic. See `SNS Data Encryption <https://docs.aws.amazon.com/sns/latest/dg/sns-data-encryption.html>`_ for more information. Default: The SNS Topic will not be encrypted.
         :param auto_scaling_group: The autoscaling group to add as a Capacity Provider.
-        :param capacity_provider_name: The name of the capacity provider. If a name is specified, it cannot start with ``aws``, ``ecs``, or ``fargate``. If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used. Default: CloudFormation-generated name
+        :param capacity_provider_name: The name of the capacity provider. If a name is specified, it cannot start with ``aws``, ``ecs``, or ``fargate``. If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used. If the stack name starts with ``aws``, ``ecs``, or ``fargate``, a unique resource name is generated that starts with ``cp-``. Default: CloudFormation-generated name
         :param enable_managed_draining: Managed instance draining facilitates graceful termination of Amazon ECS instances. This allows your service workloads to stop safely and be rescheduled to non-terminating instances. Infrastructure maintenance and updates are preformed without disruptions to workloads. To use managed instance draining, set enableManagedDraining to true. Default: true
         :param enable_managed_scaling: When enabled the scale-in and scale-out actions of the cluster's Auto Scaling Group will be managed for you. This means your cluster will automatically scale instances based on the load your tasks put on the cluster. For more information, see `Using Managed Scaling <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/asg-capacity-providers.html#asg-capacity-providers-managed-scaling>`_ in the ECS Developer Guide. Default: true
         :param enable_managed_termination_protection: When enabled the Auto Scaling Group will only terminate EC2 instances that no longer have running non-daemon tasks. Scale-in protection will be automatically enabled on instances. When all non-daemon tasks are stopped on an instance, ECS initiates the scale-in process and turns off scale-in protection for the instance. The Auto Scaling Group can then terminate the instance. For more information see `Managed termination protection <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-auto-scaling.html#managed-termination-protection>`_ in the ECS Developer Guide. Managed scaling must also be enabled. Default: true
@@ -3465,6 +3465,8 @@ class AsgCapacityProviderProps(AddAutoScalingGroupCapacityOptions):
         If a name is specified,
         it cannot start with ``aws``, ``ecs``, or ``fargate``. If no name is specified,
         a default name in the CFNStackName-CFNResourceName-RandomString format is used.
+        If the stack name starts with ``aws``, ``ecs``, or ``fargate``, a unique resource name
+        is generated that starts with ``cp-``.
 
         :default: CloudFormation-generated name
         '''
@@ -18360,34 +18362,42 @@ class ClusterProps:
 
         Example::
 
-            vpc = ec2.Vpc.from_lookup(self, "Vpc",
-                is_default=True
+            # vpc: ec2.Vpc
+            
+            
+            cluster = ecs.Cluster(self, "Cluster",
+                vpc=vpc
             )
             
-            cluster = ecs.Cluster(self, "FargateCluster", vpc=vpc)
+            auto_scaling_group = autoscaling.AutoScalingGroup(self, "ASG",
+                vpc=vpc,
+                instance_type=ec2.InstanceType("t2.micro"),
+                machine_image=ecs.EcsOptimizedImage.amazon_linux2(),
+                min_capacity=0,
+                max_capacity=100
+            )
             
-            task_definition = ecs.TaskDefinition(self, "TD",
-                memory_mi_b="512",
-                cpu="256",
-                compatibility=ecs.Compatibility.FARGATE
+            capacity_provider = ecs.AsgCapacityProvider(self, "AsgCapacityProvider",
+                auto_scaling_group=auto_scaling_group,
+                instance_warmup_period=300
             )
+            cluster.add_asg_capacity_provider(capacity_provider)
             
-            container_definition = task_definition.add_container("TheContainer",
-                image=ecs.ContainerImage.from_registry("foo/bar"),
-                memory_limit_mi_b=256
+            task_definition = ecs.Ec2TaskDefinition(self, "TaskDef")
+            
+            task_definition.add_container("web",
+                image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample"),
+                memory_reservation_mi_b=256
             )
             
-            run_task = tasks.EcsRunTask(self, "RunFargate",
-                integration_pattern=sfn.IntegrationPattern.RUN_JOB,
+            ecs.Ec2Service(self, "EC2Service",
                 cluster=cluster,
                 task_definition=task_definition,
-                assign_public_ip=True,
-                container_overrides=[tasks.ContainerOverride(
-                    container_definition=container_definition,
-                    environment=[tasks.TaskEnvironmentVariable(name="SOME_KEY", value=sfn.JsonPath.string_at("$.SomeKey"))]
-                )],
-                launch_target=tasks.EcsFargateLaunchTarget(),
-                propagated_tag_source=ecs.PropagatedTagSource.TASK_DEFINITION
+                capacity_provider_strategies=[ecs.CapacityProviderStrategy(
+                    capacity_provider=capacity_provider.capacity_provider_name,
+                    weight=1
+                )
+                ]
             )
         '''
         if isinstance(capacity, dict):
@@ -37006,42 +37016,24 @@ class Cluster(
 
     Example::
 
-        # vpc: ec2.Vpc
+        from aws_cdk import Tags
         
         
-        cluster = ecs.Cluster(self, "Cluster",
-            vpc=vpc
-        )
-        
-        auto_scaling_group = autoscaling.AutoScalingGroup(self, "ASG",
-            vpc=vpc,
-            instance_type=ec2.InstanceType("t2.micro"),
-            machine_image=ecs.EcsOptimizedImage.amazon_linux2(),
-            min_capacity=0,
-            max_capacity=100
-        )
-        
-        capacity_provider = ecs.AsgCapacityProvider(self, "AsgCapacityProvider",
-            auto_scaling_group=auto_scaling_group,
-            instance_warmup_period=300
+        vpc = ec2.Vpc(self, "Vpc", max_azs=1)
+        cluster = ecs.Cluster(self, "EcsCluster", vpc=vpc)
+        task_definition = ecs.FargateTaskDefinition(self, "TaskDef",
+            memory_limit_mi_b=512,
+            cpu=256
         )
-        cluster.add_asg_capacity_provider(capacity_provider)
-        
-        task_definition = ecs.Ec2TaskDefinition(self, "TaskDef")
-        
-        task_definition.add_container("web",
-            image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample"),
-            memory_reservation_mi_b=256
+        task_definition.add_container("WebContainer",
+            image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
         )
-        
-        ecs.Ec2Service(self, "EC2Service",
+        Tags.of(task_definition).add("my-tag", "my-tag-value")
+        scheduled_fargate_task = ecs_patterns.ScheduledFargateTask(self, "ScheduledFargateTask",
             cluster=cluster,
             task_definition=task_definition,
-            capacity_provider_strategies=[ecs.CapacityProviderStrategy(
-                capacity_provider=capacity_provider.capacity_provider_name,
-                weight=1
-            )
-            ]
+            schedule=appscaling.Schedule.expression("rate(1 minute)"),
+            propagate_tags=ecs.PropagatedTagSource.TASK_DEFINITION
         )
     '''