class ListenerRuleConfiguration

Language	Type name
.NET	Amazon.CDK.AWS.ECS.ListenerRuleConfiguration
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsecs#ListenerRuleConfiguration
Java	software.amazon.awscdk.services.ecs.ListenerRuleConfiguration
Python	aws_cdk.aws_ecs.ListenerRuleConfiguration
TypeScript (source)	aws-cdk-lib » aws_ecs » ListenerRuleConfiguration

Represents a listener configuration for advanced load balancer settings.

Example

import * as lambda from 'aws-cdk-lib/aws-lambda';

declare const cluster: ecs.Cluster;
declare const taskDefinition: ecs.TaskDefinition;
declare const lambdaHook: lambda.Function;
declare const blueTargetGroup: elbv2.ApplicationTargetGroup;
declare const greenTargetGroup: elbv2.ApplicationTargetGroup;
declare const prodListenerRule: elbv2.ApplicationListenerRule;

const service = new ecs.FargateService(this, 'Service', {
  cluster,
  taskDefinition,
  deploymentStrategy: ecs.DeploymentStrategy.BLUE_GREEN,
});

service.addLifecycleHook(new ecs.DeploymentLifecycleLambdaTarget(lambdaHook, 'PreScaleHook', {
  lifecycleStages: [ecs.DeploymentLifecycleStage.PRE_SCALE_UP],
}));

const target = service.loadBalancerTarget({
  containerName: 'nginx',
  containerPort: 80,
  protocol: ecs.Protocol.TCP,
}, new ecs.AlternateTarget('AlternateTarget', {
  alternateTargetGroup: greenTargetGroup,
  productionListener: ecs.ListenerRuleConfiguration.applicationListenerRule(prodListenerRule),
}));

target.attachToApplicationTargetGroup(blueTargetGroup);

Initializer

new ListenerRuleConfiguration()

Methods

Name	Description
static applicationListenerRule(rule)	Use an Application Load Balancer listener rule.
static networkListener(listener)	Use a Network Load Balancer listener.

---

static applicationListenerRule(rule)

public static applicationListenerRule(rule: ApplicationListenerRule): ListenerRuleConfiguration

Parameters

• rule ApplicationListenerRule

Returns

• ListenerRuleConfiguration

Use an Application Load Balancer listener rule.

---

static networkListener(listener)

public static networkListener(listener: NetworkListener): ListenerRuleConfiguration

Parameters

• listener NetworkListener

Returns

• ListenerRuleConfiguration

Use a Network Load Balancer listener.