AWS CDK Reference

Appearance

v2.273.0

DeploymentAlarmOptions Struct ​

Options for deployment alarms.

Source
aws-ecs/lib/base/base-service.ts
Type last changed
v2.87.0 · 6 Jul 2023

Example ​

ts
import * as cw from 'aws-cdk-lib/aws-cloudwatch';

declare const cluster: ecs.Cluster;
declare const taskDefinition: ecs.TaskDefinition;
declare const elbAlarm: cw.Alarm;

const service = new ecs.FargateService(this, 'Service', {
  cluster,
  taskDefinition,
  minHealthyPercent: 100,
  deploymentAlarms: {
    alarmNames: [elbAlarm.alarmName],
    behavior: ecs.AlarmBehavior.ROLLBACK_ON_ALARM,
  },
});

// Defining a deployment alarm after the service has been created
const cpuAlarmName =  'MyCpuMetricAlarm';
new cw.Alarm(this, 'CPUAlarm', {
  alarmName: cpuAlarmName,
  metric: service.metricCpuUtilization(),
  evaluationPeriods: 2,
  threshold: 80,
});
service.enableDeploymentAlarms([cpuAlarmName], {
  behavior: ecs.AlarmBehavior.FAIL_ON_ALARM,
});

Properties ​

behaviorAlarmBehaviorbehaviorAlarmBehaviorbehaviorAlarmBehaviorBehaviorAlarmBehaviorBehaviorAlarmBehavior= AlarmBehavior.ROLLBACK_ON_ALARM#
Default rollback on alarm.