software.amazon.awscdk.services.stepfunctions.tasks

Interface EcsRunTaskProps

All Superinterfaces:

TaskStateBaseProps

All Known Implementing Classes:

EcsRunTaskProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:50.222Z")
public interface EcsRunTaskProps
extends TaskStateBaseProps

Properties for ECS Tasks.

Example:

 IVpc vpc = Vpc.fromLookup(this, "Vpc", VpcLookupOptions.builder()
         .isDefault(true)
         .build());
 Cluster cluster = Cluster.Builder.create(this, "Ec2Cluster").vpc(vpc).build();
 cluster.addCapacity("DefaultAutoScalingGroup", AddCapacityOptions.builder()
         .instanceType(new InstanceType("t2.micro"))
         .vpcSubnets(SubnetSelection.builder().subnetType(SubnetType.PUBLIC).build())
         .build());
 TaskDefinition taskDefinition = TaskDefinition.Builder.create(this, "TD")
         .compatibility(Compatibility.EC2)
         .build();
 taskDefinition.addContainer("TheContainer", ContainerDefinitionOptions.builder()
         .image(ContainerImage.fromRegistry("foo/bar"))
         .memoryLimitMiB(256)
         .build());
 EcsRunTask runTask = EcsRunTask.Builder.create(this, "Run")
         .integrationPattern(IntegrationPattern.RUN_JOB)
         .cluster(cluster)
         .taskDefinition(taskDefinition)
         .launchTarget(EcsEc2LaunchTarget.Builder.create()
                 .placementStrategies(List.of(PlacementStrategy.spreadAcrossInstances(), PlacementStrategy.packedByCpu(), PlacementStrategy.randomly()))
                 .placementConstraints(List.of(PlacementConstraint.memberOf("blieptuut")))
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	EcsRunTaskProps.Builder A builder for EcsRunTaskProps
static class	EcsRunTaskProps.Jsii$Proxy An implementation for EcsRunTaskProps

Method Summary

Modifier and Type	Method and Description
static EcsRunTaskProps.Builder	builder()
default java.lang.Boolean	getAssignPublicIp() Assign public IP addresses to each task.
ICluster	getCluster() The ECS cluster to run the task on.
default java.util.List<ContainerOverride>	getContainerOverrides() Container setting overrides.
IEcsLaunchTarget	getLaunchTarget() An Amazon ECS launch type determines the type of infrastructure on which your tasks and services are hosted.
default java.util.List<ISecurityGroup>	getSecurityGroups() Existing security groups to use for the tasks.
default SubnetSelection	getSubnets() Subnets to place the task's ENIs.
TaskDefinition	getTaskDefinition() [disable-awslint:ref-via-interface] Task Definition used for running tasks in the service.

Methods inherited from interface software.amazon.awscdk.services.stepfunctions.TaskStateBaseProps

getComment, getHeartbeat, getInputPath, getIntegrationPattern, getOutputPath, getResultPath, getResultSelector, getTimeout

Method Detail

getCluster

ICluster getCluster()

The ECS cluster to run the task on.

getLaunchTarget

IEcsLaunchTarget getLaunchTarget()

An Amazon ECS launch type determines the type of infrastructure on which your tasks and services are hosted.

See Also:

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html

getTaskDefinition

TaskDefinition getTaskDefinition()

[disable-awslint:ref-via-interface] Task Definition used for running tasks in the service.

Note: this must be TaskDefinition, and not ITaskDefinition, as it requires properties that are not known for imported task definitions

getAssignPublicIp

default java.lang.Boolean getAssignPublicIp()

Assign public IP addresses to each task.

Default: false

getContainerOverrides

default java.util.List<ContainerOverride> getContainerOverrides()

Container setting overrides.

Specify the container to use and the overrides to apply.

Default: - No overrides

getSecurityGroups

default java.util.List<ISecurityGroup> getSecurityGroups()

Existing security groups to use for the tasks.

Default: - A new security group is created

getSubnets

default SubnetSelection getSubnets()

Subnets to place the task's ENIs.

Default: - Public subnets if assignPublicIp is set. Private subnets otherwise.

builder

static EcsRunTaskProps.Builder builder()

Specified by:

builder in interface TaskStateBaseProps

Returns:

a EcsRunTaskProps.Builder of EcsRunTaskProps