PlacementStrategy

class aws_cdk.aws_ecs.PlacementStrategy(*args: Any, **kwargs)

Bases: object

The placement strategies to use for tasks in the service. For more information, see Amazon ECS Task Placement Strategies.

Tasks will preferentially be placed on instances that match these rules.

ExampleMetadata

infused

Example:

vpc = ec2.Vpc.from_lookup(self, "Vpc",
    is_default=True
)

cluster = ecs.Cluster(self, "Ec2Cluster", vpc=vpc)
cluster.add_capacity("DefaultAutoScalingGroup",
    instance_type=ec2.InstanceType("t2.micro"),
    vpc_subnets=ec2.SubnetSelection(subnet_type=ec2.SubnetType.PUBLIC)
)

task_definition = ecs.TaskDefinition(self, "TD",
    compatibility=ecs.Compatibility.EC2
)

task_definition.add_container("TheContainer",
    image=ecs.ContainerImage.from_registry("foo/bar"),
    memory_limit_mi_b=256
)

run_task = tasks.EcsRunTask(self, "Run",
    integration_pattern=sfn.IntegrationPattern.RUN_JOB,
    cluster=cluster,
    task_definition=task_definition,
    launch_target=tasks.EcsEc2LaunchTarget(
        placement_strategies=[
            ecs.PlacementStrategy.spread_across_instances(),
            ecs.PlacementStrategy.packed_by_cpu(),
            ecs.PlacementStrategy.randomly()
        ],
        placement_constraints=[
            ecs.PlacementConstraint.member_of("blieptuut")
        ]
    )
)

Methods

to_json()

Return the placement JSON.

Return type

List[PlacementStrategyProperty]

Static Methods

classmethod packed_by(resource)

Places tasks on the container instances with the least available capacity of the specified resource.

Parameters

resource (BinPackResource) –

Return type

PlacementStrategy

classmethod packed_by_cpu()

Places tasks on container instances with the least available amount of CPU capacity.

This minimizes the number of instances in use.

Return type

PlacementStrategy

classmethod packed_by_memory()

Places tasks on container instances with the least available amount of memory capacity.

This minimizes the number of instances in use.

Return type

PlacementStrategy

classmethod randomly()

Places tasks randomly.

Return type

PlacementStrategy

classmethod spread_across(*fields)

Places tasks evenly based on the specified value.

You can use one of the built-in attributes found on BuiltInAttributes or supply your own custom instance attributes. If more than one attribute is supplied, spreading is done in order.

Parameters

fields (str) –

Default

attributes instanceId

Return type

PlacementStrategy

classmethod spread_across_instances()

Places tasks evenly across all container instances in the cluster.

Return type

PlacementStrategy