vsphere_virtual_machine

Provides a VMware vSphere virtual machine resource. This can be used to create, modify, and delete virtual machines.

Example Usage

resource "vsphere_virtual_machine" "web" {
  name   = "terraform_web"
  vcpu   = 2
  memory = 4096

  network_interface {
    label = "VM Network"
  }

  disk {
    template = "centos-7"
  }
}

Example Usage VMware Cluster

resource "vsphere_virtual_machine" "lb" {
  name   = "lb01"
  folder = "Loadbalancers"
  vcpu   = 2
  memory = 4096
  domain = "MYDOMAIN"
  datacenter = "EAST"
  cluster = "Production Cluster"
  resource_pool = "Production Cluster/Resources/Production Servers"

  gateway = "10.20.30.254"

  network_interface {
      label = "10_20_30_VMNet"
      ipv4_address = "10.20.30.40"
      ipv4_prefix_length = "24"
  }

  disk {
    datastore = "EAST/VMFS01-EAST"
    template = "Templates/Centos7"
  }
}

Argument Reference

The following arguments are supported:

• name - (Required) The virtual machine name
• vcpu - (Required) The number of virtual CPUs to allocate to the virtual machine
• memory - (Required) The amount of RAM (in MB) to allocate to the virtual machine
• memory_reservation - (Optional) The amount of RAM (in MB) to reserve physical memory resource; defaults to 0 (means not to reserve)
• datacenter - (Optional) The name of a Datacenter in which to launch the virtual machine
• cluster - (Optional) Name of a Cluster in which to launch the virtual machine
• resource_pool (Optional) The name of a Resource Pool in which to launch the virtual machine. Requires full path (see cluster example).
• gateway - Deprecated, please use network_interface.ipv4_gateway instead.
• domain - (Optional) A FQDN for the virtual machine; defaults to “vsphere.local”
• time_zone - (Optional) The Linux or Windows time zone to set on the virtual machine. Defaults to “Etc/UTC”
• dns_suffixes - (Optional) List of name resolution suffixes for the virtual network adapter
• dns_servers - (Optional) List of DNS servers for the virtual network adapter; defaults to 8.8.8.8, 8.8.4.4
• network_interface - (Required) Configures virtual network interfaces; see Network Interfaces below for details.
• disk - (Required) Configures virtual disks; see Disks below for details
• detach_unknown_disks_on_delete - (Optional) will detach disks not managed by this resource on delete (avoids deletion of disks attached after resource creation outside of Terraform scope).
• cdrom - (Optional) Configures a CDROM device and mounts an image as its media; see CDROM below for more details.
• windows_opt_config - (Optional) Extra options for clones of Windows machines.
• linked_clone - (Optional) Specifies if the new machine is a linked clone of another machine or not.
• enable_disk_uuid - (Optional) This option causes the vm to mount disks by uuid on the guest OS.
• custom_configuration_parameters - (Optional) Map of values that is set as virtual machine custom configurations.
• skip_customization - (Optional) skip virtual machine customization (useful if OS is not in the guest OS support matrix of VMware like “other3xLinux64Guest”).

The network_interface block supports:

• label - (Required) Label to assign to this network interface
• ipv4_address - (Optional) Static IPv4 to assign to this network interface. Interface will use DHCP if this is left blank.
• ipv4_prefix_length - (Optional) prefix length to use when statically assigning an IPv4 address.
• ipv4_gateway - (Optional) IPv4 gateway IP address to use.
• ipv6_address - (Optional) Static IPv6 to assign to this network interface. Interface will use DHCPv6 if this is left blank.
• ipv6_prefix_length - (Optional) prefix length to use when statically assigning an IPv6.
• ipv6_gateway - (Optional) IPv6 gateway IP address to use.
• mac_address - (Optional) Manual MAC address to assign to this network interface. Will be generated by VMware if not set. (VMware KB: Setting a static MAC address for a virtual NIC (219))

The following arguments are maintained for backwards compatibility and may be removed in a future version:

• ip_address - Deprecated, please use ipv4_address instead.
• subnet_mask - Deprecated, please use ipv4_prefix_length instead.

The windows_opt_config block supports:

• product_key - (Optional) Serial number for new installation of Windows. This serial number is ignored if the original guest operating system was installed using a volume-licensed CD.
• admin_password - (Optional) The password for the new administrator account. Omit for passwordless admin (using "" does not work).
• domain - (Optional) Domain that the new machine will be placed into. If domain, domain_user, and domain_user_password are not all set, all three will be ignored.
• domain_user - (Optional) User that is a member of the specified domain.
• domain_user_password - (Optional) Password for domain user, in plain text.

Disks

The disk block supports:

• template - (Required if size and bootable_vmdk_path not provided) Template for this disk.
• datastore - (Optional) Datastore for this disk
• size - (Required if template and bootable_vmdks_path not provided) Size of this disk (in GB).
• name - (Required if size is provided when creating a new disk) This “name” is used for the disk file name in vSphere, when the new disk is created.
• iops - (Optional) Number of virtual iops to allocate for this disk.
• type - (Optional) ‘eager_zeroed’ (the default), ‘lazy’, or ‘thin’ are supported options.
• vmdk - (Required if template and size not provided) Path to a vmdk in a vSphere datastore.
• bootable - (Optional) Set to ‘true’ if a vmdk was given and it should attempt to boot after creation.
• controller_type = (Optional) Controller type to attach the disk to. ‘scsi’ (the default), or ‘ide’ are supported options.

CDROM

The cdrom block supports:

• datastore - (Required) The name of the datastore where the disk image is stored.
• path - (Required) The absolute path to the image within the datastore.

Attributes Reference

The following attributes are exported:

• id - The instance ID.
• uuid - The instance UUID.
• name - See Argument Reference above.
• vcpu - See Argument Reference above.
• memory - See Argument Reference above.
• datacenter - See Argument Reference above.
• network_interface/label - See Argument Reference above.
• network_interface/ipv4_address - See Argument Reference above.
• network_interface/ipv4_prefix_length - See Argument Reference above.
• network_interface/ipv6_address - Assigned static IPv6 address.
• network_interface/ipv6_prefix_length - Prefix length of assigned static IPv6 address.

See the source of this document at Terraform.io