aws-cdk-lib.aws_ecs.HealthCheck

interface HealthCheck

LanguageType name
.NETAmazon.CDK.AWS.ECS.HealthCheck
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsecs#HealthCheck
Javasoftware.amazon.awscdk.services.ecs.HealthCheck
Pythonaws_cdk.aws_ecs.HealthCheck
TypeScript (source)aws-cdk-lib » aws_ecs » HealthCheck

The health check command and associated configuration parameters for the container.

Example

declare const vpc: ec2.Vpc;
declare const securityGroup: ec2.SecurityGroup;
const queueProcessingFargateService = new ecsPatterns.QueueProcessingFargateService(this, 'Service', {
  vpc,
  memoryLimitMiB: 512,
  image: ecs.ContainerImage.fromRegistry('test'),
  healthCheck: {
    command: [ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ],
    // the properties below are optional
    interval: Duration.minutes(30),
    retries: 123,
    startPeriod: Duration.minutes(30),
    timeout: Duration.minutes(30),
  },
});

Properties

NameTypeDescription
commandstring[]A string array representing the command that the container runs to determine if it is healthy.
interval?DurationThe time period in seconds between each health check execution.
retries?numberThe number of times to retry a failed health check before the container is considered unhealthy.
startPeriod?DurationThe optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries.
timeout?DurationThe time period in seconds to wait for a health check to succeed before it is considered a failure.

command

Type: string[]

A string array representing the command that the container runs to determine if it is healthy.

The string array must start with CMD to execute the command arguments directly, or CMD-SHELL to run the command with the container's default shell.

For example: [ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ]


interval?

Type: Duration (optional, default: Duration.seconds(30))

The time period in seconds between each health check execution.

You may specify between 5 and 300 seconds.


retries?

Type: number (optional, default: 3)

The number of times to retry a failed health check before the container is considered unhealthy.

You may specify between 1 and 10 retries.


startPeriod?

Type: Duration (optional, default: No start period)

The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries.

You may specify between 0 and 300 seconds.


timeout?

Type: Duration (optional, default: Duration.seconds(5))

The time period in seconds to wait for a health check to succeed before it is considered a failure.

You may specify between 2 and 60 seconds.