terraform/website/source/docs/providers/vsphere/r/virtual_machine.html.markdown

7.4 KiB

layout page_title sidebar_current description
vsphere VMware vSphere: vsphere_virtual_machine docs-vsphere-resource-virtual-machine Provides a VMware vSphere virtual machine resource. This can be used to create, modify, and delete virtual machines.

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 (cannot contain underscores and must be less than 15 characters)
  • 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.