software.amazon.awscdk.services.ecs.patterns

Interface ApplicationLoadBalancedFargateServiceProps

All Superinterfaces:

ApplicationLoadBalancedServiceBaseProps, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ApplicationLoadBalancedFargateServiceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-11T17:58:52.462Z")
 @Stability(value=Stable)
public interface ApplicationLoadBalancedFargateServiceProps
extends software.amazon.jsii.JsiiSerializable, ApplicationLoadBalancedServiceBaseProps

The properties for the ApplicationLoadBalancedFargateService service.

Example:

 Cluster cluster;
 ApplicationLoadBalancedFargateService loadBalancedFargateService = ApplicationLoadBalancedFargateService.Builder.create(this, "Service")
         .cluster(cluster)
         .memoryLimitMiB(1024)
         .desiredCount(1)
         .cpu(512)
         .taskImageOptions(ApplicationLoadBalancedTaskImageOptions.builder()
                 .image(ContainerImage.fromRegistry("amazon/amazon-ecs-sample"))
                 .build())
         .build();
 ScalableTaskCount scalableTarget = loadBalancedFargateService.service.autoScaleTaskCount(EnableScalingProps.builder()
         .minCapacity(1)
         .maxCapacity(20)
         .build());
 scalableTarget.scaleOnCpuUtilization("CpuScaling", CpuUtilizationScalingProps.builder()
         .targetUtilizationPercent(50)
         .build());
 scalableTarget.scaleOnMemoryUtilization("MemoryScaling", MemoryUtilizationScalingProps.builder()
         .targetUtilizationPercent(50)
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static ApplicationLoadBalancedFargateServiceProps.Builder	builder()
default Boolean	getAssignPublicIp() Determines whether the service will be assigned a public IP address.
default Number	getCpu() The number of cpu units used by the task.
default Number	getMemoryLimitMiB() The amount (in MiB) of memory used by the task.
default FargatePlatformVersion	getPlatformVersion() The platform version on which to run your service.
default List<ISecurityGroup>	getSecurityGroups() The security groups to associate with the service.
default FargateTaskDefinition	getTaskDefinition() The task definition to use for tasks in the service.
default SubnetSelection	getTaskSubnets() The subnets to associate with the service.

Methods inherited from interface software.amazon.awscdk.services.ecs.patterns.ApplicationLoadBalancedServiceBaseProps

getCertificate, getCircuitBreaker, getCloudMapOptions, getCluster, getDeploymentController, getDesiredCount, getDomainName, getDomainZone, getEnableECSManagedTags, getHealthCheckGracePeriod, getListenerPort, getLoadBalancer, getLoadBalancerName, getMaxHealthyPercent, getMinHealthyPercent, getOpenListener, getPropagateTags, getProtocol, getProtocolVersion, getPublicLoadBalancer, getRecordType, getRedirectHTTP, getServiceName, getSslPolicy, getTargetProtocol, getTaskImageOptions, getVpc

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAssignPublicIp

@Stability(value=Stable)
 @Nullable
default Boolean getAssignPublicIp()

Determines whether the service will be assigned a public IP address.

Default: false

getCpu

@Stability(value=Stable)
 @Nullable
default Number getCpu()

The number of cpu units used by the task.

Valid values, which determines your range of valid values for the memory parameter:

256 (.25 vCPU) - Available memory values: 0.5GB, 1GB, 2GB

512 (.5 vCPU) - Available memory values: 1GB, 2GB, 3GB, 4GB

1024 (1 vCPU) - Available memory values: 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB

2048 (2 vCPU) - Available memory values: Between 4GB and 16GB in 1GB increments

4096 (4 vCPU) - Available memory values: Between 8GB and 30GB in 1GB increments

This default is set in the underlying FargateTaskDefinition construct.

Default: 256

getMemoryLimitMiB

@Stability(value=Stable)
 @Nullable
default Number getMemoryLimitMiB()

The amount (in MiB) of memory used by the task.

This field is required and you must use one of the following values, which determines your range of valid values for the cpu parameter:

512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 vCPU)

1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: 512 (.5 vCPU)

2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU)

Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - Available cpu values: 2048 (2 vCPU)

Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - Available cpu values: 4096 (4 vCPU)

This default is set in the underlying FargateTaskDefinition construct.

Default: 512

getPlatformVersion

@Stability(value=Stable)
 @Nullable
default FargatePlatformVersion getPlatformVersion()

The platform version on which to run your service.

If one is not specified, the LATEST platform version is used by default. For more information, see AWS Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

Default: Latest

getSecurityGroups

@Stability(value=Stable)
 @Nullable
default List<ISecurityGroup> getSecurityGroups()

The security groups to associate with the service.

If you do not specify a security group, a new security group is created.

Default: - A new security group is created.

getTaskDefinition

@Stability(value=Stable)
 @Nullable
default FargateTaskDefinition getTaskDefinition()

The task definition to use for tasks in the service. TaskDefinition or TaskImageOptions must be specified, but not both.

[disable-awslint:ref-via-interface]

Default: - none

getTaskSubnets

@Stability(value=Stable)
 @Nullable
default SubnetSelection getTaskSubnets()

The subnets to associate with the service.

Default: - Public subnets if `assignPublicIp` is set, otherwise the first available one of Private, Isolated, Public, in that order.

builder

@Stability(value=Stable)
static ApplicationLoadBalancedFargateServiceProps.Builder builder()

Specified by:

builder in interface ApplicationLoadBalancedServiceBaseProps

Returns:

a ApplicationLoadBalancedFargateServiceProps.Builder of ApplicationLoadBalancedFargateServiceProps