AWS Fundamentals Logo
AWS Fundamentals
L2 Construct

MultiNodeJobDefinition

A JobDefinition that uses Ecs orchestration to run multiple containers.

Import

import { MultiNodeJobDefinition } from 'aws-cdk-lib/aws-batch';

Or use the module namespace:

import * as batch from 'aws-cdk-lib/aws-batch';
// batch.MultiNodeJobDefinition

Properties

Configuration passed to the constructor as MultiNodeJobDefinitionProps.

containersOptional
MultiNodeContainer[]

The containers that this multinode job will run.

Default: none

instanceTypeOptional
InstanceType

The instance type that this job definition will run.

Default: - optimal instance, selected by Batch

mainNodeOptional
number

The index of the main node in this job. The main node is responsible for orchestration.

Default: 0

propagateTagsOptional
boolean

Whether to propagate tags from the JobDefinition to the ECS task that Batch spawns.

Default: false

7 properties inherited from JobDefinitionProps
jobDefinitionNameOptionalinherited from JobDefinitionProps
string

The name of this job definition.

Default: - generated by CloudFormation

parametersOptionalinherited from JobDefinitionProps
{ [key: string]: any }

The default parameters passed to the container These parameters can be referenced in the `command` that you give to the container.

Default: none

retryAttemptsOptionalinherited from JobDefinitionProps
number

The number of times to retry a job. The job is retried on failure the same number of attempts as the value.

Default: 1

retryStrategiesOptionalinherited from JobDefinitionProps
RetryStrategy[]

Defines the retry behavior for this job.

Default: - no `RetryStrategy`

schedulingPriorityOptionalinherited from JobDefinitionProps
number

The priority of this Job. Only used in Fairshare Scheduling to decide which job to run first when there are multiple jobs with the same share identifier.

Default: none

skipDeregisterOnUpdateOptionalinherited from JobDefinitionProps
boolean

Specifies whether the previous revision of the job definition is retained in an active status after UPDATE events for the resource. When the property is set to false, the previous revision of the job definition is de-registered after a new revision is created. When the property is set to true, the previous revision of the job definition is not de-registered.

Default: undefined - AWS Batch default is false

timeoutOptionalinherited from JobDefinitionProps
Duration

The timeout time for jobs that are submitted with this job definition. After the amount of time you specify passes, Batch terminates your jobs if they aren't finished.

Default: - no timeout

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL2 (Higher-level)
Moduleaws-batch
Properties11

Related Constructs

Explore This Service

External Links