pulumi-aws-kotlin/com.pulumi.aws.ecs.kotlin/TaskSet

TaskSet

class TaskSet : KotlinCustomResource

Provides an ECS task set - effectively a task that is expected to run until an error occurs or a user terminates it (typically a webserver or a database). See ECS Task Set section in AWS developer guide.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.TaskSet;
import com.pulumi.aws.ecs.TaskSetArgs;
import com.pulumi.aws.ecs.inputs.TaskSetLoadBalancerArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new TaskSet("example", TaskSetArgs.builder()
            .service(aws_ecs_service.example().id())
            .cluster(aws_ecs_cluster.example().id())
            .taskDefinition(aws_ecs_task_definition.example().arn())
            .loadBalancers(TaskSetLoadBalancerArgs.builder()
                .targetGroupArn(aws_lb_target_group.example().arn())
                .containerName("mongo")
                .containerPort(8080)
                .build())
            .build());
    }
}

Ignoring Changes to Scale

You can utilize the generic resource lifecycle configuration block with ignore_changes to create an ECS service with an initial count of running instances, then ignore any changes to that count caused externally (e.g. Application Autoscaling).

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecs.TaskSet;
import com.pulumi.aws.ecs.TaskSetArgs;
import com.pulumi.aws.ecs.inputs.TaskSetScaleArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new TaskSet("example", TaskSetArgs.builder()
            .lifecycle(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
            .scale(TaskSetScaleArgs.builder()
                .value(50)
                .build())
            .build());
    }
}

Import

ECS Task Sets can be imported via the task_set_id, service, and cluster separated by commas (,) e.g.

$ pulumi import aws:ecs/taskSet:TaskSet example ecs-svc/7177320696926227436,arn:aws:ecs:us-west-2:123456789101:service/example/example-1234567890,arn:aws:ecs:us-west-2:123456789101:cluster/example

Properties

arn

val arn: Output<String>

The Amazon Resource Name (ARN) that identifies the task set.

capacityProviderStrategies

val capacityProviderStrategies: Output<List<TaskSetCapacityProviderStrategy>>?

The capacity provider strategy to use for the service. Can be one or more. Defined below.

cluster

val cluster: Output<String>

The short name or ARN of the cluster that hosts the service to create the task set in.

externalId

val externalId: Output<String>

The external ID associated with the task set.

forceDelete

val forceDelete: Output<Boolean>?

Whether to allow deleting the task set without waiting for scaling down to 0. You can force a task set to delete even if it's in the process of scaling a resource. Normally, the provider drains all the tasks before deleting the task set. This bypasses that behavior and potentially leaves resources dangling.

val id: Output<String>

launchType

val launchType: Output<String>

The launch type on which to run your service. The valid values are EC2, FARGATE, and EXTERNAL. Defaults to EC2.

loadBalancers

val loadBalancers: Output<List<TaskSetLoadBalancer>>?

Details on load balancers that are used with a task set. Detailed below.

networkConfiguration

val networkConfiguration: Output<TaskSetNetworkConfiguration>?

The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. Detailed below.

platformVersion

val platformVersion: Output<String>

The platform version on which to run your service. Only applicable for launch_type set to FARGATE. Defaults to LATEST. More information about Fargate platform versions can be found in the AWS ECS User Guide.