AWS::Batch::JobDefinition
The AWS::Batch::JobDefinition
resource specifies the parameters for an Amazon Batch job
definition. For more information, see Job Definitions in the Amazon Batch User Guide.
Syntax
To declare this entity in your Amazon CloudFormation template, use the following syntax:
JSON
{ "Type" : "AWS::Batch::JobDefinition", "Properties" : { "ContainerProperties" :
ContainerProperties
, "EksProperties" :EksProperties
, "JobDefinitionName" :String
, "NodeProperties" :NodeProperties
, "Parameters" :Json
, "PlatformCapabilities" :[ String, ... ]
, "PropagateTags" :Boolean
, "RetryStrategy" :RetryStrategy
, "SchedulingPriority" :Integer
, "Tags" :Json
, "Timeout" :Timeout
, "Type" :String
} }
YAML
Type: AWS::Batch::JobDefinition Properties: ContainerProperties:
ContainerProperties
EksProperties:EksProperties
JobDefinitionName:String
NodeProperties:NodeProperties
Parameters:Json
PlatformCapabilities:- String
PropagateTags:Boolean
RetryStrategy:RetryStrategy
SchedulingPriority:Integer
Tags:Json
Timeout:Timeout
Type:String
Properties
ContainerProperties
-
An object with various properties specific to Amazon ECS based jobs. Valid values are
containerProperties
,eksProperties
, andnodeProperties
. Only one can be specified.Required: No
Type: ContainerProperties
Update requires: No interruption
EksProperties
-
An object with various properties that are specific to Amazon EKS based jobs. Valid values are
containerProperties
,eksProperties
, andnodeProperties
. Only one can be specified.Required: No
Type: EksProperties
Update requires: No interruption
JobDefinitionName
-
The name of the job definition.
Required: No
Type: String
Update requires: Replacement
NodeProperties
-
An object with various properties that are specific to multi-node parallel jobs. Valid values are
containerProperties
,eksProperties
, andnodeProperties
. Only one can be specified.Note
If the job runs on Fargate resources, don't specify
nodeProperties
. UsecontainerProperties
instead.Required: No
Type: NodeProperties
Update requires: No interruption
Parameters
-
Default parameters or parameter substitution placeholders that are set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in a
SubmitJob
request override any corresponding parameter defaults from the job definition. For more information about specifying parameters, see Job definition parameters in the Amazon Batch User Guide.Required: No
Type: Json
Update requires: No interruption
PlatformCapabilities
-
The platform capabilities required by the job definition. If no value is specified, it defaults to
EC2
. Jobs run on Fargate resources specifyFARGATE
.Required: No
Type: List of String
Update requires: No interruption
PropagateTags
-
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task. If no value is specified, the tags aren't propagated. Tags can only be propagated to the tasks when the tasks are created. For tags with the same name, job tags are given priority over job definitions tags. If the total number of combined tags from the job and job definition is over 50, the job is moved to the
FAILED
state.Required: No
Type: Boolean
Update requires: No interruption
RetryStrategy
-
The retry strategy to use for failed jobs that are submitted with this job definition.
Required: No
Type: RetryStrategy
Update requires: No interruption
SchedulingPriority
-
The scheduling priority of the job definition. This only affects jobs in job queues with a fair share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower scheduling priority.
Required: No
Type: Integer
Update requires: No interruption
Tags
-
The tags that are applied to the job definition.
Required: No
Type: Json
Update requires: Replacement
Timeout
-
The timeout time for jobs that are submitted with this job definition. After the amount of time you specify passes, Amazon Batch terminates your jobs if they aren't finished.
Required: No
Type: Timeout
Update requires: No interruption
Type
-
The type of job definition. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the Amazon Batch User Guide.
Note
If the job is run on Fargate resources, then
multinode
isn't supported.Required: Yes
Type: String
Allowed values:
container | multinode
Update requires: No interruption
Return values
Ref
When you pass the logical ID of this resource to the intrinsic Ref
function, Ref
returns the job definition ARN, such as arn:aws-cn:batch:us-east-1:111122223333:job-definition/test-gpu:2
.
For more information about using the Ref
function, see Ref.
Examples
Test nvidia-smi
The following example tests the nvidia-smi
command on a GPU instance to verify that the GPU is
working inside the container. For more information, see Test GPU Functionality in the
Amazon Batch User Guide.
JSON
{ "JobDefinition": { "Type": "AWS::Batch::JobDefinition", "Properties": { "Type": "container", "JobDefinitionName": "nvidia-smi", "ContainerProperties": { "MountPoints": [ { "ReadOnly": false, "SourceVolume": "nvidia", "ContainerPath": "/usr/local/nvidia" } ], "Volumes": [ { "Host": { "SourcePath": "/var/lib/nvidia-docker/volumes/nvidia_driver/latest" }, "Name": "nvidia" } ], "Command": [ "nvidia-smi" ], "Privileged": true, "JobRoleArn": "String", "ReadonlyRootFilesystem": true, "ResourceRequirements": [ { "Type": "MEMORY", "Value": "2000" }, { "Type": "VCPU", "Value": "2" } ], "Image": "nvidia/cuda" } } } }
YAML
JobDefinition: Type: AWS::Batch::JobDefinition Properties: Type: container JobDefinitionName: nvidia-smi ContainerProperties: MountPoints: - ReadOnly: false SourceVolume: nvidia ContainerPath: /usr/local/nvidia Volumes: - Host: SourcePath: /var/lib/nvidia-docker/volumes/nvidia_driver/latest Name: nvidia Command: - nvidia-smi Privileged: true JobRoleArn: String ReadonlyRootFilesystem: true ResourceRequirements: - Type: MEMORY Value: '2000' - Type: VCPU Value: '2' Image: nvidia/cuda
See also
-
Job Definition Parameters in the Amazon Batch User Guide.