createclusterandsubmitsteps
Create an AWS EMR cluster, submit steps, and retrieve the cluster ID.
Create an AWS EMR cluster, submit steps, and retrieve the cluster ID.
Create an AWS EMR cluster, submit steps, and retrieve the cluster ID.
type: "io.kestra.plugin.aws.emr.createclusterandsubmitsteps"Examples
Create an EMR Cluster, submit a Spark job, wait until the job is terminated.
id: aws_emr_create_cluster
namespace: company.team
tasks:
- id: create_cluster
type: io.kestra.plugin.aws.emr.CreateClusterAndSubmitSteps
accessKeyId: "{{ secret('AWS_ACCESS_KEY_ID') }}"
secretKeyId: "{{ secret('AWS_SECRET_KEY_ID') }}"
region: eu-west-3
clusterName: "Spark job cluster"
logUri: "s3://my-bucket/test-emr-logs"
keepJobFlowAliveWhenNoSteps: true
applications:
- Spark
masterInstanceType: m5.xlarge
slaveInstanceType: m5.xlarge
instanceCount: 3
ec2KeyName: my-ec2-ssh-key-pair-name
steps:
- name: Spark_job_test
jar: "command-runner.jar"
actionOnFailure: CONTINUE
commands:
- spark-submit s3://mybucket/health_violations.py --data_source s3://mybucket/food_establishment_data.csv --output_uri s3://mybucket/test-emr-output
wait: true
Properties
clusterName*Requiredstring
Cluster Name.
instanceCount*Requiredintegerstring
Instance count.
masterInstanceType*Requiredstring
Master Instance Type.
EC2 instance type for master instances.
slaveInstanceType*Requiredstring
Slave Instance Type.
EC2 instance type for slave instances.
accessKeyIdstring
Access Key Id in order to connect to AWS.
applicationsarray
Applications.
List of applications name: Ex: "Hive", "Spark", "Ganglia"
compatibilityModebooleanstring
Enable compatibility mode.
Use it to connect to S3 bucket with S3 compatible services that don't support the new transport client.
completionCheckIntervalstring
PT10SdurationCheck interval duration.
The frequency with which the task checks whether the job is completed.
ec2KeyNamestring
EC2 Key name.
The name of the Amazon EC2 key pair that can be used to connect to the master node using SSH as the user called "hadoop".
ec2SubnetIdstring
EC2 Subnet ID.
Applies to clusters that use the uniform instance group configuration. To launch the cluster in Amazon Virtual Private Cloud (Amazon VPC), set this parameter to the identifier of the Amazon VPC subnet where you want the cluster to launch. If you do not specify this value and your account supports EC2-Classic, the cluster launches in EC2-Classic.
endpointOverridestring
The endpoint with which the SDK should communicate.
This property allows you to use a different S3 compatible storage backend.
forcePathStylebooleanstring
Force path style access.
Must only be used when compatibilityMode is enabled.
jobFlowRolestring
EMR_EC2_DefaultRoleJob flow Role.
Also called instance profile and Amazon EC2 role. An IAM role for an Amazon EMR cluster. The Amazon EC2 instances of the cluster assume this role. The default role is EMR_EC2_DefaultRole. In order to use the default role, you must have already created it using the CLI or console.
keepJobFlowAliveWhenNoStepsbooleanstring
falseKeep job flow alive.
Specifies whether the cluster should remain available after completing all steps. Defaults to false.
logUristring
Log URI.
The location in Amazon S3 to write the log files of the job flow. If a value is not provided, logs are not created.
regionstring
AWS region with which the SDK should communicate.
releaseLabelstring
emr-5.20.0Release Label.
It specifies the EMR release version label. Pattern is 'emr-x.x.x'.
secretKeyIdstring
Secret Key Id in order to connect to AWS.
serviceRolestring
EMR_DefaultRoleService Role.
The IAM role that Amazon EMR assumes in order to access Amazon Web Services resources on your behalf. If you've created a custom service role path, you must specify it for the service role when you launch your cluster.
sessionTokenstring
AWS session token, retrieved from an AWS token service, used for authenticating that this user has received temporary permissions to access a given resource.
If no credentials are defined, we will use the default credentials provider chain to fetch credentials.
stepsNon-dynamicarray
Steps
List of steps to run.
io.kestra.plugin.aws.emr.models.StepConfig
TERMINATE_CLUSTERCANCEL_AND_WAITCONTINUETERMINATE_JOB_FLOWAction on failure.
Possible values : TERMINATE_CLUSTER, CANCEL_AND_WAIT, CONTINUE, TERMINATE_JOB_FLOW.
JAR path.
A path to a JAR file run during the step.
Step configuration name.
Ex: "Run Spark job"
Commands.
A list of commands that will be passed to the JAR file's main function when executed.
Main class.
The name of the main class in the specified Java file. If not specified, the JAR file should specify a Main-Class in its manifest file.
stsEndpointOverridestring
The AWS STS endpoint with which the SDKClient should communicate.
stsRoleArnstring
AWS STS Role.
The Amazon Resource Name (ARN) of the role to assume. If set the task will use the StsAssumeRoleCredentialsProvider. If no credentials are defined, we will use the default credentials provider chain to fetch credentials.
stsRoleExternalIdstring
AWS STS External Id.
A unique identifier that might be required when you assume a role in another account. This property is only used when an stsRoleArn is defined.
stsRoleSessionDurationstring
PT15MdurationAWS STS Session duration.
The duration of the role session (default: 15 minutes, i.e., PT15M). This property is only used when an stsRoleArn is defined.
stsRoleSessionNamestring
AWS STS Session name.
This property is only used when an stsRoleArn is defined.
visibleToAllUsersbooleanstring
trueVisible to all users.
Set this value to true so that IAM principals in the Amazon Web Services account associated with the cluster can perform Amazon EMR actions on the cluster that their IAM policies allow.
waitbooleanstring
falseWait for the end of the run.
If set to true it will wait until the cluster has status TERMINATED or WAITING.
waitUntilCompletionstring
PT1HdurationCompletion timeout.
Outputs
jobFlowIdstring
Job flow ID.
