subcategory | layout | page_title | description |
---|---|---|---|
HDInsight |
azurerm |
Azure Resource Manager: azurerm_hdinsight_interactive_query_cluster |
Manages a HDInsight Interactive Query Cluster. |
Manages a HDInsight Interactive Query Cluster.
resource "azurerm_resource_group" "example" {
name = "example-resources"
location = "West Europe"
}
resource "azurerm_storage_account" "example" {
name = "hdinsightstor"
resource_group_name = azurerm_resource_group.example.name
location = azurerm_resource_group.example.location
account_tier = "Standard"
account_replication_type = "LRS"
}
resource "azurerm_storage_container" "example" {
name = "hdinsight"
storage_account_name = azurerm_storage_account.example.name
container_access_type = "private"
}
resource "azurerm_hdinsight_interactive_query_cluster" "example" {
name = "example-hdicluster"
resource_group_name = azurerm_resource_group.example.name
location = azurerm_resource_group.example.location
cluster_version = "3.6"
tier = "Standard"
component_version {
interactive_hive = "2.1"
}
gateway {
enabled = true
username = "acctestusrgw"
password = "TerrAform123!"
}
storage_account {
storage_container_id = azurerm_storage_container.example.id
storage_account_key = azurerm_storage_account.example.primary_access_key
is_default = true
}
roles {
head_node {
vm_size = "Standard_D13_V2"
username = "acctestusrvm"
password = "AccTestvdSC4daf986!"
}
worker_node {
vm_size = "Standard_D14_V2"
username = "acctestusrvm"
password = "AccTestvdSC4daf986!"
target_instance_count = 3
}
zookeeper_node {
vm_size = "Standard_A4_V2"
username = "acctestusrvm"
password = "AccTestvdSC4daf986!"
}
}
}
The following arguments are supported:
-
name
- (Required) Specifies the name for this HDInsight Interactive Query Cluster. Changing this forces a new resource to be created. -
resource_group_name
- (Required) Specifies the name of the Resource Group in which this HDInsight Interactive Query Cluster should exist. Changing this forces a new resource to be created. -
location
- (Required) Specifies the Azure Region which this HDInsight Interactive Query Cluster should exist. Changing this forces a new resource to be created. -
cluster_version
- (Required) Specifies the Version of HDInsights which should be used for this Cluster. Changing this forces a new resource to be created. -
component_version
- (Required) Acomponent_version
block as defined below. -
gateway
- (Required) Agateway
block as defined below. -
roles
- (Required) Aroles
block as defined below. -
storage_account
- (Required) One or morestorage_account
block as defined below. -
storage_account_gen2
- (Required) Astorage_account_gen2
block as defined below. -
tier
- (Required) Specifies the Tier which should be used for this HDInsight Interactive Query Cluster. Possible values areStandard
orPremium
. Changing this forces a new resource to be created. -
min_tls_version
- (Optional) The minimal supported TLS version. Possible values are 1.0, 1.1 or 1.2. Changing this forces a new resource to be created.
~> NOTE: Starting on June 30, 2020, Azure HDInsight will enforce TLS 1.2 or later versions for all HTTPS connections. For more information, see Azure HDInsight TLS 1.2 Enforcement.
tags
- (Optional) A map of Tags which should be assigned to this HDInsight Interactive Query Cluster.
A component_version
block supports the following:
interactive_query
- (Required) The version of Interactive Query which should be used for this HDInsight Interactive Query Cluster. Changing this forces a new resource to be created.
A gateway
block supports the following:
-
enabled
- (Optional) Is the Ambari portal enabled? Deprecated: HDInsight doesn't support disabling gateway anymore. -
password
- (Required) The password used for the Ambari Portal.
-> NOTE: This password must be different from the one used for the head_node
, worker_node
and zookeeper_node
roles.
username
- (Required) The username used for the Ambari Portal. Changing this forces a new resource to be created.
A head_node
block supports the following:
-
username
- (Required) The Username of the local administrator for the Head Nodes. Changing this forces a new resource to be created. -
vm_size
- (Required) The Size of the Virtual Machine which should be used as the Head Nodes. Changing this forces a new resource to be created.
-> NOTE: High memory instances must be specified for the Head Node (Azure suggests a Standard_D13_V2
).
password
- (Optional) The Password associated with the local administrator for the Head Nodes. Changing this forces a new resource to be created.
-> NOTE: If specified, this password must be at least 10 characters in length and must contain at least one digit, one uppercase and one lower case letter, one non-alphanumeric character (except characters ' " ` ).
ssh_keys
- (Optional) A list of SSH Keys which should be used for the local administrator on the Head Nodes. Changing this forces a new resource to be created.
-> NOTE: Either a password
or one or more ssh_keys
must be specified - but not both.
-
subnet_id
- (Optional) The ID of the Subnet within the Virtual Network where the Head Nodes should be provisioned within. Changing this forces a new resource to be created. -
virtual_network_id
- (Optional) The ID of the Virtual Network where the Head Nodes should be provisioned within. Changing this forces a new resource to be created.
A roles
block supports the following:
-
head_node
- (Required) Ahead_node
block as defined above. -
worker_node
- (Required) Aworker_node
block as defined below. -
zookeeper_node
- (Required) Azookeeper_node
block as defined below.
A storage_account
block supports the following:
is_default
- (Required) Is this the Default Storage Account for the HDInsight Hadoop Cluster? Changing this forces a new resource to be created.
-> NOTE: One of the storage_account
or storage_account_gen2
blocks must be marked as the default.
-
storage_account_key
- (Required) The Access Key which should be used to connect to the Storage Account. Changing this forces a new resource to be created. -
storage_container_id
- (Required) The ID of the Storage Container. Changing this forces a new resource to be created.
-> NOTE: This can be obtained from the id
of the azurerm_storage_container
resource.
A storage_account_gen2
block supports the following:
is_default
- (Required) Is this the Default Storage Account for the HDInsight Hadoop Cluster? Changing this forces a new resource to be created.
-> NOTE: One of the storage_account
or storage_account_gen2
blocks must be marked as the default.
-
storage_resource_id
- (Required) The ID of the Storage Account. Changing this forces a new resource to be created. -
filesystem_id
- (Required) The ID of the Gen2 Filesystem. Changing this forces a new resource to be created. -
managed_identity_resource_id
- (Required) The ID of Managed Identity to use for accessing the Gen2 filesystem. Changing this forces a new resource to be created.
-> NOTE: This can be obtained from the id
of the azurerm_storage_container
resource.
A worker_node
block supports the following:
-
username
- (Required) The Username of the local administrator for the Worker Nodes. Changing this forces a new resource to be created. -
vm_size
- (Required) The Size of the Virtual Machine which should be used as the Worker Nodes. Changing this forces a new resource to be created.
-> NOTE: High memory instances must be specified for the Head Node (Azure suggests a Standard_D14_V2
).
-
min_instance_count
- (Optional) The minimum number of instances which should be run for the Worker Nodes. Changing this forces a new resource to be created. -
password
- (Optional) The Password associated with the local administrator for the Worker Nodes. Changing this forces a new resource to be created.
-> NOTE: If specified, this password must be at least 10 characters in length and must contain at least one digit, one uppercase and one lower case letter, one non-alphanumeric character (except characters ' " ` ).
ssh_keys
- (Optional) A list of SSH Keys which should be used for the local administrator on the Worker Nodes. Changing this forces a new resource to be created.
-> NOTE: Either a password
or one or more ssh_keys
must be specified - but not both.
-
subnet_id
- (Optional) The ID of the Subnet within the Virtual Network where the Worker Nodes should be provisioned within. Changing this forces a new resource to be created. -
target_instance_count
- (Optional) The number of instances which should be run for the Worker Nodes. -
virtual_network_id
- (Optional) The ID of the Virtual Network where the Worker Nodes should be provisioned within. Changing this forces a new resource to be created.
A zookeeper_node
block supports the following:
-
username
- (Required) The Username of the local administrator for the Zookeeper Nodes. Changing this forces a new resource to be created. -
vm_size
- (Required) The Size of the Virtual Machine which should be used as the Zookeeper Nodes. Changing this forces a new resource to be created. -
password
- (Optional) The Password associated with the local administrator for the Zookeeper Nodes. Changing this forces a new resource to be created.
-> NOTE: If specified, this password must be at least 10 characters in length and must contain at least one digit, one uppercase and one lower case letter, one non-alphanumeric character (except characters ' " ` ).
ssh_keys
- (Optional) A list of SSH Keys which should be used for the local administrator on the Zookeeper Nodes. Changing this forces a new resource to be created.
-> NOTE: Either a password
or one or more ssh_keys
must be specified - but not both.
-
subnet_id
- (Optional) The ID of the Subnet within the Virtual Network where the Zookeeper Nodes should be provisioned within. Changing this forces a new resource to be created. -
virtual_network_id
- (Optional) The ID of the Virtual Network where the Zookeeper Nodes should be provisioned within. Changing this forces a new resource to be created.
The following attributes are exported:
-
id
- The ID of the HDInsight Interactive Query Cluster. -
https_endpoint
- The HTTPS Connectivity Endpoint for this HDInsight Interactive Query Cluster. -
ssh_endpoint
- The SSH Connectivity Endpoint for this HDInsight Interactive Query Cluster.
The timeouts
block allows you to specify timeouts for certain actions:
create
- (Defaults to 60 minutes) Used when creating the Interactive Query HDInsight Cluster.update
- (Defaults to 60 minutes) Used when updating the Interactive Query HDInsight Cluster.read
- (Defaults to 5 minutes) Used when retrieving the Interactive Query HDInsight Cluster.delete
- (Defaults to 60 minutes) Used when deleting the Interactive Query HDInsight Cluster.
HDInsight Interactive Query Clusters can be imported using the resource id
, e.g.
terraform import azurerm_hdinsight_interactive_query_cluster.example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.HDInsight/clusters/cluster1}