feat(ecs): pass healthy percent & deregistraiton delay params in L3 c…

…onstruct

packages/@aws-cdk-testing/framework-integ/test/aws-ecs-patterns/test/ec2/integ.multiple-application-load-balanced-ecs-service.js.snapshot/aws-ecs-integ-multiple-alb.template.json

@@ -968,6 +968,10 @@
     "Port": 80,
     "Protocol": "HTTP",
     "TargetGroupAttributes": [
+     {
+      "Key": "deregistration_delay.timeout_seconds",
+      "Value": "10"
+     },
      {
       "Key": "stickiness.enabled",
       "Value": "false"
@@ -1188,7 +1192,7 @@
       "Rollback": false
      },
      "MaximumPercent": 200,
-     "MinimumHealthyPercent": 50
+     "MinimumHealthyPercent": 33
     },
     "EnableECSManagedTags": false,
     "EnableExecuteCommand": true,

packages/@aws-cdk-testing/framework-integ/test/aws-ecs-patterns/test/ec2/integ.multiple-application-load-balanced-ecs-service.ts

@@ -1,6 +1,6 @@
 import { InstanceType, Vpc } from 'aws-cdk-lib/aws-ec2';
 import { Cluster, ContainerImage } from 'aws-cdk-lib/aws-ecs';
-import { App, Stack } from 'aws-cdk-lib';
+import { App, Duration, Stack } from 'aws-cdk-lib';
 import * as integ from '@aws-cdk/integ-tests-alpha';
 import { ApplicationMultipleTargetGroupsEc2Service } from 'aws-cdk-lib/aws-ecs-patterns';
 import { AUTOSCALING_GENERATE_LAUNCH_TEMPLATE } from 'aws-cdk-lib/cx-api';
@@ -19,9 +19,11 @@ new ApplicationMultipleTargetGroupsEc2Service(stack, 'myService', {
     image: ContainerImage.fromRegistry('amazon/amazon-ecs-sample'),
   },
   enableExecuteCommand: true,
+  minHealthyPercent: 33,
   targetGroups: [
     {
       containerPort: 80,
+      deregistrationDelay: Duration.seconds(10),
     },
     {
       containerPort: 90,

packages/aws-cdk-lib/aws-ecs-patterns/README.md

@@ -83,9 +83,11 @@ const loadBalancedEc2Service = new ecsPatterns.ApplicationMultipleTargetGroupsEc
   taskImageOptions: {
     image: ecs.ContainerImage.fromRegistry("amazon/amazon-ecs-sample"),
   },
+  minHealthyPercent: 33,
   targetGroups: [
     {
       containerPort: 80,
+      deregistrationDelay: Duration.seconds(300),
     },
     {
       containerPort: 90,
@@ -108,9 +110,11 @@ const loadBalancedFargateService = new ecsPatterns.ApplicationMultipleTargetGrou
   taskImageOptions: {
     image: ecs.ContainerImage.fromRegistry("amazon/amazon-ecs-sample"),
   },
+  minHealthyPercent: 33,
   targetGroups: [
     {
       containerPort: 80,
+      deregistrationDelay: Duration.seconds(300),
     },
     {
       containerPort: 90,

packages/aws-cdk-lib/aws-ecs-patterns/lib/base/application-multiple-target-groups-service-base.ts

@@ -114,6 +114,15 @@ export interface ApplicationMultipleTargetGroupsServiceBaseProps {
    * @default - false
    */
   readonly enableExecuteCommand?: boolean;
+
+  /**
+   * The minimum number of tasks, specified as a percentage of
+   * the Amazon ECS service's DesiredCount value, that must
+   * continue to run and remain healthy during a deployment.
+   *
+   * @default - 0 if daemon, otherwise 50
+   */
+  readonly minHealthyPercent?: number;
 }
 
 /**
@@ -268,6 +277,15 @@ export interface ApplicationTargetProps {
    * @default No path condition
    */
   readonly pathPattern?: string;
+
+  /**
+   * The amount of time for Elastic Load Balancing to wait before deregistering a target.
+   *
+   * The range is 0-3600 seconds.
+   *
+   * @default 300
+   */
+  readonly deregistrationDelay?: Duration;
 }
 
 /**
@@ -516,6 +534,7 @@ export abstract class ApplicationMultipleTargetGroupsServiceBase extends Constru
           }),
         ],
         conditions,
+        deregistrationDelay: targetProps.deregistrationDelay,
         priority: targetProps.priority,
       });
       this.targetGroups.push(targetGroup);

packages/aws-cdk-lib/aws-ecs-patterns/lib/base/network-multiple-target-groups-service-base.ts

@@ -105,6 +105,15 @@ export interface NetworkMultipleTargetGroupsServiceBaseProps {
    * @default - false
    */
   readonly enableExecuteCommand?: boolean;
+
+  /**
+   * The minimum number of tasks, specified as a percentage of
+   * the Amazon ECS service's DesiredCount value, that must
+   * continue to run and remain healthy during a deployment.
+   *
+   * @default - 0 if daemon, otherwise 50
+   */
+  readonly minHealthyPercent?: number;
 }
 
 /**
@@ -268,6 +277,15 @@ export interface NetworkTargetProps {
    * @default - default listener (first added listener)
    */
   readonly listener?: string;
+
+  /**
+   * The amount of time for Elastic Load Balancing to wait before deregistering a target.
+   *
+   * The range is 0-3600 seconds.
+   *
+   * @default 300
+   */
+  readonly deregistrationDelay?: Duration;
 }
 
 /**
@@ -394,6 +412,7 @@ export abstract class NetworkMultipleTargetGroupsServiceBase extends Construct {
             containerPort: targetProps.containerPort,
           }),
         ],
+        deregistrationDelay: targetProps.deregistrationDelay,
       });
       this.targetGroups.push(targetGroup);
     }

packages/aws-cdk-lib/aws-ecs-patterns/lib/ecs/application-multiple-target-groups-ecs-service.ts

@@ -171,6 +171,7 @@ export class ApplicationMultipleTargetGroupsEc2Service extends ApplicationMultip
       enableExecuteCommand: props.enableExecuteCommand,
       placementConstraints: props.placementConstraints,
       placementStrategies: props.placementStrategies,
+      minHealthyPercent: props.minHealthyPercent,
     });
   }
 }

packages/aws-cdk-lib/aws-ecs-patterns/lib/ecs/network-multiple-target-groups-ecs-service.ts

@@ -177,6 +177,7 @@ export class NetworkMultipleTargetGroupsEc2Service extends NetworkMultipleTarget
       enableExecuteCommand: props.enableExecuteCommand,
       placementConstraints: props.placementConstraints,
       placementStrategies: props.placementStrategies,
+      minHealthyPercent: props.minHealthyPercent,
     });
   }
 }

packages/aws-cdk-lib/aws-ecs-patterns/test/ec2/l3s-v2.test.ts

@@ -168,6 +168,7 @@ describe('When Application Load Balancer', () => {
       ],
       placementStrategies: [PlacementStrategy.spreadAcrossInstances(), PlacementStrategy.packedByCpu(), PlacementStrategy.randomly()],
       placementConstraints: [PlacementConstraint.memberOf('attribute:ecs.instance-type =~ m5a.*')],
+      minHealthyPercent: 50,
     });
 
     // THEN
@@ -197,6 +198,7 @@ describe('When Application Load Balancer', () => {
       ServiceName: 'myService',
       PlacementConstraints: [{ Type: 'memberOf', Expression: 'attribute:ecs.instance-type =~ m5a.*' }],
       PlacementStrategies: [{ Field: 'instanceId', Type: 'spread' }, { Field: 'CPU', Type: 'binpack' }, { Type: 'random' }],
+      DeploymentConfiguration: { MinimumHealthyPercent: 50 },
     });
 
     Template.fromStack(stack).hasResourceProperties('AWS::ECS::TaskDefinition', {
@@ -1148,6 +1150,7 @@ describe('When Network Load Balancer', () => {
       ],
       placementStrategies: [PlacementStrategy.spreadAcrossInstances(), PlacementStrategy.packedByCpu(), PlacementStrategy.randomly()],
       placementConstraints: [PlacementConstraint.memberOf('attribute:ecs.instance-type =~ m5a.*')],
+      minHealthyPercent: 50,
     });
 
     // THEN
@@ -1178,6 +1181,7 @@ describe('When Network Load Balancer', () => {
       ServiceName: 'myService',
       PlacementConstraints: [{ Type: 'memberOf', Expression: 'attribute:ecs.instance-type =~ m5a.*' }],
       PlacementStrategies: [{ Field: 'instanceId', Type: 'spread' }, { Field: 'CPU', Type: 'binpack' }, { Type: 'random' }],
+      DeploymentConfiguration: { MinimumHealthyPercent: 50 },
     });
 
     Template.fromStack(stack).hasResourceProperties('AWS::ECS::TaskDefinition', {