alicloud_ehpc_cluster

更新时间:2024-10-28 03:35:29

Provides a Ehpc Cluster resource.

For information about Ehpc Cluster and how to use it, see What is Cluster.

-> NOTE: Available since v1.173.0.

Example Usage

Basic Usage


variable "name" {
  default = "tf-example"
}
data "alicloud_zones" "default" {
  available_resource_creation = "VSwitch"
}
data "alicloud_images" "default" {
  name_regex = "^centos_7_6_x64*"
  owners     = "system"
}
data "alicloud_instance_types" "default" {
  availability_zone = data.alicloud_zones.default.zones.0.id
}

resource "alicloud_vpc" "default" {
  vpc_name   = var.name
  cidr_block = "10.0.0.0/8"
}
resource "alicloud_vswitch" "default" {
  vswitch_name = var.name
  cidr_block   = "10.1.0.0/16"
  vpc_id       = alicloud_vpc.default.id
  zone_id      = data.alicloud_zones.default.zones.0.id
}

resource "alicloud_nas_file_system" "default" {
  storage_type  = "Performance"
  protocol_type = "NFS"
}
resource "alicloud_nas_mount_target" "default" {
  file_system_id    = alicloud_nas_file_system.default.id
  access_group_name = "DEFAULT_VPC_GROUP_NAME"
  vswitch_id        = alicloud_vswitch.default.id
}

resource "alicloud_ehpc_cluster" "default" {
  cluster_name          = var.name
  deploy_mode           = "Simple"
  description           = var.name
  ha_enable             = false
  image_id              = data.alicloud_images.default.images.0.id
  image_owner_alias     = "system"
  volume_protocol       = "nfs"
  volume_id             = alicloud_nas_file_system.default.id
  volume_mountpoint     = alicloud_nas_mount_target.default.mount_target_domain
  compute_count         = 1
  compute_instance_type = data.alicloud_instance_types.default.instance_types.0.id
  login_count           = 1
  login_instance_type   = data.alicloud_instance_types.default.instance_types.0.id
  manager_count         = 1
  manager_instance_type = data.alicloud_instance_types.default.instance_types.0.id
  os_tag                = "CentOS_7.6_64"
  scheduler_type        = "pbs"
  password              = "your-password123"
  vswitch_id            = alicloud_vswitch.default.id
  vpc_id                = alicloud_vpc.default.id
  zone_id               = data.alicloud_zones.default.zones.0.id
}

Argument Reference

The following arguments are supported:

  • account_type - (Optional, ForceNew) The type of the domain account service. Valid values: nis, ldap. Default value: nis
  • additional_volumes - (Optional, ForceNew) The additional volumes. See additional_volumes below.
  • application - (Optional, ForceNew) The application. See application below.
  • auto_renew - (Optional) Specifies whether to enable auto-renewal for the subscription. Default value: false.
  • auto_renew_period - (Optional) The auto-renewal period of the subscription compute nodes. The parameter takes effect when AutoRenew is set to true.
  • client_version - (Optional, ForceNew) The version of the E-HPC client. By default, the parameter is set to the latest version number.
  • cluster_name - (Required) The name of the cluster. The name must be 2 to 64 characters in length.
  • cluster_version - (Optional) The version of the cluster. Default value: 1.0.
  • compute_count - (Required, ForceNew) The number of the compute nodes. Valid values: 1 to 99.
  • compute_enable_ht - (Optional) Specifies whether the compute nodes support hyper-threading. Default value: true.
  • compute_instance_type - (Required, ForceNew) The instance type of the compute nodes.
  • compute_spot_price_limit - (Optional) The maximum hourly price of the compute nodes. A maximum of three decimal places can be used in the value of the parameter. The parameter is valid only when the ComputeSpotStrategy parameter is set to SpotWithPriceLimit.
  • compute_spot_strategy - (Optional) The bidding method of the compute nodes. Default value: NoSpot. Valid values:
    • NoSpot: The compute nodes are pay-as-you-go instances.
    • SpotWithPriceLimit: The compute nodes are preemptible instances that have a user-defined maximum hourly price.
    • SpotAsPriceGo: The compute nodes are preemptible instances for which the market price at the time of purchase is used as the bid price.
  • deploy_mode - (Optional, ForceNew) The mode in which the cluster is deployed. Valid values: Standard, Simple, Tiny. Default value: Standard.
    • Standard: An account node, a scheduling node, a logon node, and multiple compute nodes are separately deployed.
    • Simple: A management node, a logon node, and multiple compute nodes are deployed. The management node consists of an account node and a scheduling node. The logon node and compute nodes are separately deployed.
    • Tiny: A management node and multiple compute nodes are deployed. The management node consists of an account node, a scheduling node, and a logon node. The compute nodes are separately deployed.
  • description - (Optional) The description of the cluster. The description must be 2 to 256 characters in length. It cannot start with http:// or https://.
  • domain - (Optional) The domain name of the on-premises cluster. This parameter takes effect only when the AccoutType parameter is set to Idap.
  • ecs_charge_type - (Optional, ForceNew) The billing method of the nodes.
  • ehpc_version - (Optional) The version of E-HPC. By default, the parameter is set to the latest version number.
  • ha_enable - (Optional, ForceNew) Specifies whether to enable the high availability feature. Default value: false. Note: If high availability is enabled, a primary management node and a secondary management node are used.
  • image_id - (Optional) The ID of the image.
  • image_owner_alias - (Optional) The type of the image. Valid values: others, self, system, marketplace. Default value: system.
  • input_file_url - (Optional) The URL of the job files that are uploaded to an Object Storage Service (OSS) bucket.
  • is_compute_ess - (Optional) Specifies whether to enable auto scaling. Default value: false.
  • job_queue - (Optional) The queue to which the compute nodes are added.
  • key_pair_name - (Optional, ForceNew) The name of the AccessKey pair.
  • login_count - (Required, ForceNew) The number of the logon nodes. Valid values: 1.
  • login_instance_type - (Required, ForceNew) The instance type of the logon nodes.
  • manager_instance_type - (Required, ForceNew) The instance type of the management nodes.
  • manager_count - (Optional, ForceNew) The number of the management nodes. Valid values: 1 and 2.
  • os_tag - (Required, ForceNew) The image tag of the operating system.
  • password - (Optional, ForceNew) The root password of the logon node. The password must be 8 to 30 characters in length and contain at least three of the following items: uppercase letters, lowercase letters, digits, and special characters. The password can contain the following special characters: ( ) ~ ! @ # $ % ^ & * - + = { } [ ] : ; ‘ < > , . ? /. You must specify either password or key_pair_name. If both are specified, the Password parameter prevails.
  • period - (Optional) The duration of the subscription. The unit of the duration is specified by the period_unit parameter. Default value: 1.
    • If you set PriceUnit to Year, the valid values of the Period parameter are 1, 2, and 3.
    • If you set PriceUnit to Month, the valid values of the Period parameter are 1, 2, 3, 4, 5, 6, 7, 8, and 9.
    • If you set PriceUnit to Hour, the valid value of the Period parameter is 1.
  • period_unit - (Optional) The unit of the subscription duration. Valid values: Year, Month, Hour. Default value: Month.
  • plugin - (Optional) The mode configurations of the plug-in. This parameter takes effect only when the SchedulerType parameter is set to custom. The value must be a JSON string. The parameter contains the following parameters: pluginMod, pluginLocalPath, and pluginOssPath.
    • pluginMod: the mode of the plug-in. The following modes are supported:
      • oss: The plug-in is downloaded and decompressed from OSS to a local path. The local path is specified by the pluginLocalPath parameter.
      • image: By default, the plug-in is stored in a pre-defined local path. The local path is specified by the pluginLocalPath parameter.
    • pluginLocalPath: the local path where the plug-in is stored. We recommend that you select a shared directory in oss mode and a non-shared directory in image mode.
    • pluginOssPath: the remote path where the plug-in is stored in OSS. This parameter takes effect only when the pluginMod parameter is set to oss.
  • post_install_script - (Optional, ForceNew) The post install script. See post_install_script below.
  • ram_node_types - (Optional) The node of the RAM role.
  • ram_role_name - (Optional) The name of the Resource Access Management (RAM) role.
  • release_instance - (Optional) The release instance. Valid values: true.
  • remote_directory - (Optional, ForceNew) The remote directory to which the file system is mounted.
  • remote_vis_enable - (Optional) Specifies whether to enable Virtual Network Computing (VNC). Default value: false.
  • resource_group_id - (Optional) The ID of the resource group.
  • scc_cluster_id - (Optional, ForceNew) The ID of the Super Computing Cluster (SCC) instance. If you specify the parameter, the SCC instance is moved to a new SCC cluster.
  • scheduler_type - (Optional, ForceNew) The type of the scheduler. Valid values: pbs, slurm, opengridscheduler and deadline. Default value: pbs.
  • security_group_id - (Optional, ForceNew) The ID of the security group to which the cluster belongs.
  • security_group_name - (Optional) If you do not use an existing security group, set the parameter to the name of a new security group. A default policy is applied to the new security group.
  • system_disk_level - (Optional) The performance level of the ESSD that is used as the system disk. Default value: PL1 For more information, see ESSDs. Valid values:
    • PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.
    • PL1: A single ESSD can deliver up to 50,000 random read/write IOPS.
    • PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
    • PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.
  • system_disk_size - (Optional) The size of the system disk. Unit: GB. Valid values: 40 to 500. Default value: 40.
  • system_disk_type - (Optional) The type of the system disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd or cloud. Default value: cloud_ssd.
  • volume_id - (Optional, ForceNew) The ID of the file system. If you leave the parameter empty, a Performance NAS file system is created by default.
  • volume_mount_option - (Optional) The mount options of the file system.
  • volume_mountpoint - (Optional, ForceNew) The mount target of the file system. Take note of the following information:
    • If you do not specify the VolumeId parameter, you can leave the VolumeMountpoint parameter empty. A mount target is created by default.
    • If you specify the VolumeId parameter, the VolumeMountpoint parameter is required.
  • volume_protocol - (Optional, ForceNew) The type of the protocol that is used by the file system. Valid values: NFS, SMB. Default value: NFS.
  • volume_type - (Optional, ForceNew) The type of the shared storage. Only Apsara File Storage NAS file systems are supported.
  • vswitch_id - (Optional, ForceNew) The ID of the vSwitch. E-HPC supports only VPC networks.
  • without_agent - (Optional) Specifies whether not to install the agent. Default value: false.
  • without_elastic_ip - (Optional) Specifies whether the logon node uses an elastic IP address (EIP). Default value: false.
  • zone_id - (Optional, ForceNew) The ID of the zone.
  • vpc_id - (Optional, ForceNew) The ID of the virtual private cloud (VPC) to which the cluster belongs.

application

The application supports the following:

  • tag - (Optional) The tag of the software.

post_install_script

The post_install_script supports the following:

  • args - (Optional) The parameter that is used to run the script after the cluster is created.
  • url - (Optional) The URL that is used to download the script after the cluster is created.

additional_volumes

The additional_volumes supports the following:

  • job_queue - (Optional) The queue of the nodes to which the additional file system is attached.
  • local_directory - (Optional) The local directory on which the additional file system is mounted.
  • location - (Optional) The type of the cluster. Valid value: PublicCloud.
  • remote_directory - (Optional) The remote directory to which the additional file system is mounted.
  • roles - (Optional) The roles. See roles below.
  • volume_id - (Optional) The ID of the additional file system.
  • volume_mount_option - (Optional) The mount options of the file system.
  • volume_mountpoint - (Optional) The mount target of the additional file system.
  • volume_protocol - (Optional) The type of the protocol that is used by the additional file system. Valid values: NFS, SMB. Default value: NFS
  • volume_type - (Optional) The type of the additional shared storage. Only NAS file systems are supported.

additional_volumes-roles

The roles supports the following:

  • name - (Optional) The type of the nodes to which the additional file system is attached.

Attributes Reference

The following attributes are exported:

  • id - The resource ID in terraform of Cluster.
  • status - The status of the resource.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

  • create - (Defaults to 20 mins) Used when create the Cluster.
  • delete - (Defaults to 5 mins) Used when delete the Cluster.
  • update - (Defaults to 5 mins) Used when update the Cluster.

Import

Ehpc Cluster can be imported using the id, e.g.

$ terraform import alicloud_ehpc_cluster.example <id>

  • 本页导读 (1)
  • Example Usage
  • Argument Reference
  • application
  • post_install_script
  • additional_volumes
  • additional_volumes-roles
  • Attributes Reference
  • Timeouts
  • Import