Resource: awsEmrInstanceFleet
Provides an Elastic MapReduce Cluster Instance Fleet configuration. See Amazon Elastic MapReduce Documentation for more information.
\~> NOTE: At this time, Instance Fleets cannot be destroyed through the API nor web interface. Instance Fleets are destroyed when the EMR Cluster is destroyed. Terraform will resize any Instance Fleet to zero when destroying the resource.
Example Usage
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as aws from "./.gen/providers/aws";
new aws.emrInstanceFleet.EmrInstanceFleet(this, "task", {
clusterId: "${aws_emr_cluster.cluster.id}",
instanceTypeConfigs: [
{
bidPriceAsPercentageOfOnDemandPrice: 100,
ebsConfig: [
{
size: 100,
type: "gp2",
volumesPerInstance: 1,
},
],
instanceType: "m4.xlarge",
weightedCapacity: 1,
},
{
bidPriceAsPercentageOfOnDemandPrice: 100,
ebsConfig: [
{
size: 100,
type: "gp2",
volumesPerInstance: 1,
},
],
instanceType: "m4.2xlarge",
weightedCapacity: 2,
},
],
launchSpecifications: {
spotSpecification: [
{
allocationStrategy: "capacity-optimized",
blockDurationMinutes: 0,
timeoutAction: "TERMINATE_CLUSTER",
timeoutDurationMinutes: 10,
},
],
},
name: "task fleet",
targetOnDemandCapacity: 1,
targetSpotCapacity: 1,
});
Argument Reference
The following arguments are supported:
clusterId
- (Required) ID of the EMR Cluster to attach to. Changing this forces a new resource to be created.instanceTypeConfigs
- (Optional) Configuration block for instance fleetlaunchSpecifications
- (Optional) Configuration block for launch specificationtargetOnDemandCapacity
- (Optional) The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision.targetSpotCapacity
- (Optional) The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision.name
- (Optional) Friendly name given to the instance fleet.
instance_type_configs Configuration Block
bidPrice
- (Optional) The bid price for each EC2 Spot instance type as defined byinstanceType
. Expressed in USD. If neitherbidPrice
norbidPriceAsPercentageOfOnDemandPrice
is provided,bidPriceAsPercentageOfOnDemandPrice
defaults to 100%.bidPriceAsPercentageOfOnDemandPrice
- (Optional) The bid price, as a percentage of On-Demand price, for each EC2 Spot instance as defined byinstanceType
. Expressed as a number (for example, 20 specifies 20%). If neitherbidPrice
norbidPriceAsPercentageOfOnDemandPrice
is provided,bidPriceAsPercentageOfOnDemandPrice
defaults to 100%.configurations
- (Optional) A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster. List ofconfiguration
blocks.ebsConfig
- (Optional) Configuration block(s) for EBS volumes attached to each instance in the instance group. Detailed below.instanceType
- (Required) An EC2 instance type, such as m4.xlarge.weightedCapacity
- (Optional) The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined inawsEmrInstanceFleet
.
configurations Configuration Block
A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster. See Configuring Applications.
classification
- (Optional) The classification within a configuration.properties
- (Optional) A map of properties specified within a configuration classification
ebsConfig
Attributes for the EBS volumes attached to each EC2 instance in the masterInstanceGroup
and coreInstanceGroup
configuration blocks:
size
- (Required) The volume size, in gibibytes (GiB).type
- (Required) The volume type. Valid options aregp2
,io1
,standard
andst1
. See EBS Volume Types.iops
- (Optional) The number of I/O operations per second (IOPS) that the volume supportsvolumesPerInstance
- (Optional) The number of EBS volumes with this configuration to attach to each EC2 instance in the instance group (default is 1)
launch_specifications Configuration Block
onDemandSpecification
- (Optional) Configuration block for on demand instances launch specificationsspotSpecification
- (Optional) Configuration block for spot instances launch specifications
on_demand_specification Configuration Block
The launch specification for On-Demand instances in the instance fleet, which determines the allocation strategy. The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions. On-Demand instances allocation strategy is available in Amazon EMR version 5.12.1 and later.
allocationStrategy
- (Required) Specifies the strategy to use in launching On-Demand instance fleets. Currently, the only option islowestPrice
(the default), which launches the lowest price first.
spot_specification Configuration Block
The launch specification for Spot instances in the fleet, which determines the defined duration, provisioning timeout behavior, and allocation strategy.
allocationStrategy
- (Required) Specifies the strategy to use in launching Spot instance fleets. Currently, the only option iscapacityOptimized
(the default), which launches instances from Spot instance pools with optimal capacity for the number of instances that are launching.blockDurationMinutes
- (Optional) The defined duration for Spot instances (also known as Spot blocks) in minutes. When specified, the Spot instance does not terminate before the defined duration expires, and defined duration pricing for Spot instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot instance for termination and provides a Spot instance termination notice, which gives the instance a two-minute warning before it terminates.timeoutAction
- (Required) The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired; that is, when all Spot instances could not be provisioned within the Spot provisioning timeout. Valid values areTERMINATE_CLUSTER
andSWITCH_TO_ON_DEMAND
. SWITCH_TO_ON_DEMAND specifies that if no Spot instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.timeoutDurationMinutes
- (Required) The spot provisioning timeout period in minutes. If Spot instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.
Attributes Reference
In addition to all arguments above, the following attributes are exported:
-
id
- The unique identifier of the instance fleet. -
provisionedOnDemandCapacity
The number of On-Demand units that have been provisioned for the instance fleet to fulfill TargetOnDemandCapacity. This provisioned capacity might be less than or greater than TargetOnDemandCapacity. -
provisionedSpotCapacity
The number of Spot units that have been provisioned for this instance fleet to fulfill TargetSpotCapacity. This provisioned capacity might be less than or greater than TargetSpotCapacity. -
status
The current status of the instance fleet.
Import
EMR Instance Fleet can be imported with the EMR Cluster identifier and Instance Fleet identifier separated by a forward slash (/
), e.g.,