2013-12-26 19:10:53 -05:00
|
|
|
---
|
2018-04-13 22:48:19 -04:00
|
|
|
modeline: |
|
|
|
|
vim: set ft=pandoc:
|
2017-06-14 21:04:16 -04:00
|
|
|
description: |
|
|
|
|
This VMware Packer builder is able to create VMware virtual machines from an
|
|
|
|
ISO file as a source. It currently supports building virtual machines on hosts
|
|
|
|
running VMware Fusion for OS X, VMware Workstation for Linux and Windows, and
|
|
|
|
VMware Player on Linux. It can also build machines directly on VMware vSphere
|
|
|
|
Hypervisor using SSH as opposed to the vSphere API.
|
2015-07-22 22:31:00 -04:00
|
|
|
layout: docs
|
2017-06-14 21:04:16 -04:00
|
|
|
page_title: 'VMware ISO - Builders'
|
|
|
|
sidebar_current: 'docs-builders-vmware-iso'
|
2017-03-25 18:13:52 -04:00
|
|
|
---
|
2013-12-26 19:10:53 -05:00
|
|
|
|
|
|
|
# VMware Builder (from ISO)
|
|
|
|
|
|
|
|
Type: `vmware-iso`
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
This VMware Packer builder is able to create VMware virtual machines from an ISO
|
|
|
|
file as a source. It currently supports building virtual machines on hosts
|
2016-01-14 15:31:19 -05:00
|
|
|
running [VMware Fusion](https://www.vmware.com/products/fusion/overview.html) for
|
2015-07-22 22:31:00 -04:00
|
|
|
OS X, [VMware
|
2016-01-14 15:31:19 -05:00
|
|
|
Workstation](https://www.vmware.com/products/workstation/overview.html) for Linux
|
|
|
|
and Windows, and [VMware Player](https://www.vmware.com/products/player/) on
|
2015-07-22 22:31:00 -04:00
|
|
|
Linux. It can also build machines directly on [VMware vSphere
|
2016-01-14 15:31:19 -05:00
|
|
|
Hypervisor](https://www.vmware.com/products/vsphere-hypervisor/) using SSH as
|
2015-07-22 22:31:00 -04:00
|
|
|
opposed to the vSphere API.
|
|
|
|
|
|
|
|
The builder builds a virtual machine by creating a new virtual machine from
|
|
|
|
scratch, booting it, installing an OS, provisioning software within the OS, then
|
|
|
|
shutting it down. The result of the VMware builder is a directory containing all
|
|
|
|
the files necessary to run the virtual machine.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
|
|
|
## Basic Example
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
Here is a basic example. This example is not functional. It will start the OS
|
|
|
|
installer but then fail because we don't provide the preseed file for Ubuntu to
|
|
|
|
self-install. Still, the example serves to show the basic configuration:
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
``` json
|
2013-12-26 19:10:53 -05:00
|
|
|
{
|
|
|
|
"type": "vmware-iso",
|
|
|
|
"iso_url": "http://old-releases.ubuntu.com/releases/precise/ubuntu-12.04.2-server-amd64.iso",
|
|
|
|
"iso_checksum": "af5f788aee1b32c4b2634734309cc9e9",
|
|
|
|
"iso_checksum_type": "md5",
|
|
|
|
"ssh_username": "packer",
|
2017-07-27 00:53:16 -04:00
|
|
|
"ssh_password": "packer",
|
2013-12-26 19:10:53 -05:00
|
|
|
"shutdown_command": "shutdown -P now"
|
|
|
|
}
|
2014-10-20 13:55:16 -04:00
|
|
|
```
|
2013-12-26 19:10:53 -05:00
|
|
|
|
|
|
|
## Configuration Reference
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
There are many configuration options available for the VMware builder. They are
|
|
|
|
organized below into two categories: required and optional. Within each
|
|
|
|
category, the available options are alphabetized and described.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2015-06-23 17:44:57 -04:00
|
|
|
In addition to the options listed here, a
|
2015-07-22 22:31:00 -04:00
|
|
|
[communicator](/docs/templates/communicator.html) can be configured for this
|
|
|
|
builder.
|
2015-06-23 17:44:57 -04:00
|
|
|
|
2014-05-04 13:47:40 -04:00
|
|
|
### Required:
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_checksum` (string) - The checksum for the OS ISO file. Because ISO
|
2015-07-22 23:25:58 -04:00
|
|
|
files are so large, this is required and Packer will verify it prior to
|
|
|
|
booting a virtual machine with the ISO attached. The type of the checksum is
|
2016-02-08 09:51:43 -05:00
|
|
|
specified with `iso_checksum_type`, documented below. At least one of
|
|
|
|
`iso_checksum` and `iso_checksum_url` must be defined. This has precedence
|
|
|
|
over `iso_checksum_url` type.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_checksum_type` (string) - The type of the checksum specified in
|
2018-04-21 20:50:40 -04:00
|
|
|
`iso_checksum`. Valid values are `none`, `md5`, `sha1`, `sha256`, or
|
|
|
|
`sha512` currently. While `none` will skip checksumming, this is not
|
2015-07-22 23:25:58 -04:00
|
|
|
recommended since ISO files are generally large and corruption does happen
|
|
|
|
from time to time.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_checksum_url` (string) - A URL to a GNU or BSD style checksum file
|
2016-02-08 09:51:43 -05:00
|
|
|
containing a checksum for the OS ISO file. At least one of `iso_checksum`
|
|
|
|
and `iso_checksum_url` must be defined. This will be ignored if
|
|
|
|
`iso_checksum` is non empty.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_url` (string) - A URL to the ISO containing the installation image.
|
2015-07-22 23:25:58 -04:00
|
|
|
This URL can be either an HTTP URL or a file URL (or path to a file). If
|
|
|
|
this is an HTTP URL, Packer will download it and cache it between runs.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2014-05-04 13:47:40 -04:00
|
|
|
### Optional:
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `boot_command` (array of strings) - This is an array of commands to type
|
2015-07-22 23:25:58 -04:00
|
|
|
when the virtual machine is first booted. The goal of these commands should
|
|
|
|
be to type just enough to initialize the operating system installer. Special
|
|
|
|
keys can be typed as well, and are covered in the section below on the
|
|
|
|
boot command. If this is not specified, it is assumed the installer will
|
|
|
|
start itself.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `boot_wait` (string) - The time to wait after booting the initial virtual
|
2015-07-22 23:25:58 -04:00
|
|
|
machine before typing the `boot_command`. The value of this should be
|
2018-04-21 20:50:40 -04:00
|
|
|
a duration. Examples are `5s` and `1m30s` which will cause Packer to wait
|
2015-07-22 23:25:58 -04:00
|
|
|
five seconds and one minute 30 seconds, respectively. If this isn't
|
2018-04-21 20:50:40 -04:00
|
|
|
specified, the default is `10s` or 10 seconds.
|
|
|
|
|
|
|
|
- `cdrom_adapter_type` (string) - The adapter type (or bus) that will be used
|
|
|
|
by the cdrom device. This is chosen by default based on the disk adapter
|
|
|
|
type. VMware tends to lean towards `ide` for the cdrom device unless
|
|
|
|
`sata` is chosen for the disk adapter and so Packer attempts to mirror
|
|
|
|
this logic. This field can be specified as either `ide`, `sata`, or `scsi`.
|
|
|
|
|
|
|
|
- `disable_vnc` (boolean) - Whether to create a VNC connection or not.
|
|
|
|
A `boot_command` cannot be used when this is `false`. Defaults to `false`.
|
|
|
|
|
|
|
|
- `disk_adapter_type` (string) - The adapter type of the VMware virtual disk
|
|
|
|
to create. This option is for advanced usage, modify only if you know what
|
|
|
|
you're doing. Some of the options you can specify are `ide`, `sata`, `nvme`
|
|
|
|
or `scsi` (which uses the "lsilogic" scsi interface by default). If you
|
|
|
|
specify another option, Packer will assume that you're specifying a `scsi`
|
|
|
|
interface of that specified type. For more information, please consult the
|
|
|
|
<a href="http://www.vmware.com/pdf/VirtualDiskManager.pdf" target="_blank"
|
|
|
|
rel="nofollow noopener noreferrer">
|
|
|
|
Virtual Disk Manager User's Guide</a> for desktop VMware clients.
|
|
|
|
For ESXi, refer to the proper ESXi documentation.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `disk_additional_size` (array of integers) - The size(s) of any additional
|
2016-04-06 09:24:03 -04:00
|
|
|
hard disks for the VM in megabytes. If this is not specified then the VM
|
|
|
|
will only contain a primary hard disk. The builder uses expandable, not
|
|
|
|
fixed-size virtual hard disks, so the actual file representing the disk will
|
|
|
|
not use the full size unless it is full.
|
|
|
|
|
2017-10-16 14:23:33 -04:00
|
|
|
- `disk_size` (number) - The size of the hard disk for the VM in megabytes.
|
2015-07-22 23:25:58 -04:00
|
|
|
The builder uses expandable, not fixed-size virtual hard disks, so the
|
|
|
|
actual file representing the disk will not use the full size unless it
|
2018-04-21 20:50:40 -04:00
|
|
|
is full. By default this is set to `40000` (about 40 GB).
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2018-01-31 15:52:04 -05:00
|
|
|
- `disk_type_id` (string) - The type of VMware virtual disk to create. This
|
2018-04-13 19:48:26 -04:00
|
|
|
option is for advanced usage.
|
2018-01-31 15:52:04 -05:00
|
|
|
|
|
|
|
For desktop VMware clients:
|
2017-12-21 12:24:04 -05:00
|
|
|
|
|
|
|
Type ID | Description
|
|
|
|
--- | ---
|
|
|
|
`0` | Growable virtual disk contained in a single file (monolithic sparse).
|
|
|
|
`1` | Growable virtual disk split into 2GB files (split sparse).
|
|
|
|
`2` | Preallocated virtual disk contained in a single file (monolithic flat).
|
|
|
|
`3` | Preallocated virtual disk split into 2GB files (split flat).
|
|
|
|
`4` | Preallocated virtual disk compatible with ESX server (VMFS flat).
|
|
|
|
`5` | Compressed disk optimized for streaming.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2018-04-21 20:50:40 -04:00
|
|
|
The default is `1`.
|
2018-04-13 19:48:26 -04:00
|
|
|
|
2018-04-21 20:50:40 -04:00
|
|
|
For ESXi, this defaults to `zeroedthick`. The available options for ESXi
|
2018-01-31 15:52:04 -05:00
|
|
|
are: `zeroedthick`, `eagerzeroedthick`, `thin`, `rdm:dev`, `rdmp:dev`,
|
|
|
|
`2gbsparse`.
|
|
|
|
|
|
|
|
For more information, please consult the [Virtual Disk Manager User's
|
|
|
|
Guide](https://www.vmware.com/pdf/VirtualDiskManager.pdf) for desktop
|
|
|
|
VMware clients. For ESXi, refer to the proper ESXi documentation.
|
|
|
|
|
2018-04-21 20:50:40 -04:00
|
|
|
- `floppy_dirs` (array of strings) - A list of directories to place onto
|
|
|
|
the floppy disk recursively. This is similar to the `floppy_files` option
|
|
|
|
except that the directory structure is preserved. This is useful for when
|
|
|
|
your floppy disk includes drivers or if you just want to organize it's
|
|
|
|
contents as a hierarchy. Wildcard characters (\*, ?, and \[\]) are allowed.
|
2017-10-09 20:12:33 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `floppy_files` (array of strings) - A list of files to place onto a floppy
|
2015-07-22 23:25:58 -04:00
|
|
|
disk that is attached when the VM is booted. This is most useful for
|
|
|
|
unattended Windows installs, which look for an `Autounattend.xml` file on
|
|
|
|
removable media. By default, no floppy will be attached. All files listed in
|
|
|
|
this setting get placed into the root directory of the floppy and the floppy
|
|
|
|
is attached as the first floppy device. Currently, no support exists for
|
|
|
|
creating sub-directories on the floppy. Wildcard characters (\*, ?,
|
|
|
|
and \[\]) are allowed. Directory names are also allowed, which will add all
|
|
|
|
the files found in the directory to the floppy.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `fusion_app_path` (string) - Path to "VMware Fusion.app". By default this is
|
2018-04-21 20:50:40 -04:00
|
|
|
`/Applications/VMware Fusion.app` but this setting allows you to
|
2015-07-22 23:25:58 -04:00
|
|
|
customize this.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `guest_os_type` (string) - The guest OS type being installed. This will be
|
2018-04-21 20:50:40 -04:00
|
|
|
set in the VMware VMX. By default this is `other`. By specifying a more
|
2015-07-22 23:25:58 -04:00
|
|
|
specific OS type, VMware may perform some optimizations or virtual hardware
|
|
|
|
changes to better support the operating system running in the
|
|
|
|
virtual machine.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `headless` (boolean) - Packer defaults to building VMware virtual machines
|
2015-07-22 23:25:58 -04:00
|
|
|
by launching a GUI that shows the console of the machine being built. When
|
2018-04-21 20:50:40 -04:00
|
|
|
this value is set to `true`, the machine will start without a console. For
|
2015-07-22 23:25:58 -04:00
|
|
|
VMware machines, Packer will output VNC connection information in case you
|
|
|
|
need to connect to the console to debug the build process.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `http_directory` (string) - Path to a directory to serve using an
|
2015-07-22 23:25:58 -04:00
|
|
|
HTTP server. The files in this directory will be available over HTTP that
|
|
|
|
will be requestable from the virtual machine. This is useful for hosting
|
2018-04-21 20:50:40 -04:00
|
|
|
kickstart files and so on. By default this is an empty string, which means
|
|
|
|
no HTTP server will be started. The address and port of the HTTP server will
|
|
|
|
be available as variables in `boot_command`. This is covered in more detail
|
|
|
|
below.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-10-16 14:23:33 -04:00
|
|
|
- `http_port_min` and `http_port_max` (number) - These are the minimum and
|
2015-07-22 23:25:58 -04:00
|
|
|
maximum port to use for the HTTP server started to serve the
|
|
|
|
`http_directory`. Because Packer often runs in parallel, Packer will choose
|
|
|
|
a randomly available port in this range to run the HTTP server. If you want
|
|
|
|
to force the HTTP server to be on one port, make this minimum and maximum
|
2018-04-21 20:50:40 -04:00
|
|
|
port the same. By default the values are `8000` and `9000`, respectively.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_target_extension` (string) - The extension of the iso file after
|
2018-04-21 20:50:40 -04:00
|
|
|
download. This defaults to `iso`.
|
2016-12-17 05:49:54 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_target_path` (string) - The path where the iso should be saved after
|
2015-08-20 07:37:24 -04:00
|
|
|
download. By default will go in the packer cache, with a hash of the
|
|
|
|
original filename as its name.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `iso_urls` (array of strings) - Multiple URLs for the ISO to download.
|
2015-07-22 23:25:58 -04:00
|
|
|
Packer will try these in order. If anything goes wrong attempting to
|
|
|
|
download or while downloading a single URL, it will move on to the next. All
|
|
|
|
URLs must point to the same file (same checksum). By default this is empty
|
|
|
|
and `iso_url` is used. Only one of `iso_url` or `iso_urls` can be specified.
|
|
|
|
|
2016-10-05 22:51:42 -04:00
|
|
|
- `network` (string) - This is the network type that the virtual machine will
|
|
|
|
be created with. This can be one of the generic values that map to a device
|
2018-04-21 20:50:40 -04:00
|
|
|
such as `hostonly`, `nat`, or `bridged`. If the network is not one of these
|
2016-10-05 22:51:42 -04:00
|
|
|
values, then it is assumed to be a VMware network device. (VMnet0..x)
|
|
|
|
|
2018-01-16 14:17:37 -05:00
|
|
|
- `network_adapter_type` (string) - This is the ethernet adapter type the the
|
2018-04-21 20:50:40 -04:00
|
|
|
virtual machine will be created with. By default the `e1000` network adapter
|
2018-01-16 14:17:37 -05:00
|
|
|
type will be used by Packer. For more information, please consult the
|
2018-02-09 17:28:49 -05:00
|
|
|
<a href="https://kb.vmware.com/s/article/1001805" target="_blank"
|
|
|
|
rel="nofollow noopener noreferrer">
|
|
|
|
Choosing a network adapter for your virtual machine</a> for desktop VMware
|
2018-01-16 14:17:37 -05:00
|
|
|
clients. For ESXi, refer to the proper ESXi documentation.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `output_directory` (string) - This is the path to the directory where the
|
2015-07-22 23:25:58 -04:00
|
|
|
resulting virtual machine will be created. This may be relative or absolute.
|
|
|
|
If relative, the path is relative to the working directory when `packer`
|
|
|
|
is executed. This directory must not exist or be empty prior to running
|
2018-04-21 20:50:40 -04:00
|
|
|
the builder. By default this is `output-BUILDNAME` where "BUILDNAME" is the
|
2015-07-22 23:25:58 -04:00
|
|
|
name of the build.
|
|
|
|
|
2016-10-05 22:51:42 -04:00
|
|
|
- `parallel` (string) - This specifies a parallel port to add to the VM. It
|
|
|
|
has the format of `Type:option1,option2,...`. Type can be one of the
|
2018-04-21 20:50:40 -04:00
|
|
|
following values: `FILE`, `DEVICE`, `AUTO`, or `NONE`.
|
2016-10-05 22:51:42 -04:00
|
|
|
|
|
|
|
* `FILE:path` - Specifies the path to the local file to be used for the
|
|
|
|
parallel port.
|
|
|
|
* `DEVICE:path` - Specifies the path to the local device to be used for the
|
|
|
|
parallel port.
|
|
|
|
* `AUTO:direction` - Specifies to use auto-detection to determine the
|
|
|
|
parallel port. Direction can be `BI` to specify
|
|
|
|
bidirectional communication or `UNI` to specify
|
|
|
|
unidirectional communication.
|
2017-04-12 18:41:36 -04:00
|
|
|
* `NONE` - Specifies to not use a parallel port. (default)
|
2016-10-05 22:51:42 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_cache_datastore` (string) - The path to the datastore where
|
2015-07-22 23:25:58 -04:00
|
|
|
supporting files will be stored during the build on the remote machine. By
|
|
|
|
default this is the same as the `remote_datastore` option. This only has an
|
|
|
|
effect if `remote_type` is enabled.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_cache_directory` (string) - The path where the ISO and/or floppy
|
2015-07-22 23:25:58 -04:00
|
|
|
files will be stored during the build on the remote machine. The path is
|
|
|
|
relative to the `remote_cache_datastore` on the remote machine. By default
|
2018-04-21 20:50:40 -04:00
|
|
|
this is `packer_cache`. This only has an effect if `remote_type`
|
2015-07-22 23:25:58 -04:00
|
|
|
is enabled.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_datastore` (string) - The path to the datastore where the resulting
|
2015-07-22 23:25:58 -04:00
|
|
|
VM will be stored when it is built on the remote machine. By default this
|
2018-04-21 20:50:40 -04:00
|
|
|
is `datastore1`. This only has an effect if `remote_type` is enabled.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_host` (string) - The host of the remote machine used for access.
|
2015-07-22 23:25:58 -04:00
|
|
|
This is only required if `remote_type` is enabled.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_password` (string) - The SSH password for the user used to access
|
2015-07-22 23:25:58 -04:00
|
|
|
the remote machine. By default this is empty. This only has an effect if
|
|
|
|
`remote_type` is enabled.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_private_key_file` (string) - The path to the PEM encoded private key
|
2015-11-13 20:43:22 -05:00
|
|
|
file for the user used to access the remote machine. By default this is empty.
|
|
|
|
This only has an effect if `remote_type` is enabled.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_type` (string) - The type of remote machine that will be used to
|
2015-07-22 23:25:58 -04:00
|
|
|
build this VM rather than a local desktop product. The only value accepted
|
2018-04-21 20:50:40 -04:00
|
|
|
for this currently is `esx5`. If this is not set, a desktop product will
|
2015-07-22 23:25:58 -04:00
|
|
|
be used. By default, this is not set.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_username` (string) - The username for the SSH user that will access
|
2015-07-22 23:25:58 -04:00
|
|
|
the remote machine. This is required if `remote_type` is enabled.
|
|
|
|
|
2016-10-05 22:51:42 -04:00
|
|
|
- `serial` (string) - This specifies a serial port to add to the VM.
|
|
|
|
It has a format of `Type:option1,option2,...`. The field `Type` can be one
|
2017-04-12 18:41:36 -04:00
|
|
|
of the following values: `FILE`, `DEVICE`, `PIPE`, `AUTO`, or `NONE`.
|
2016-10-05 22:51:42 -04:00
|
|
|
|
|
|
|
* `FILE:path(,yield)` - Specifies the path to the local file to be used as the
|
|
|
|
serial port.
|
|
|
|
* `yield` (bool) - This is an optional boolean that specifies whether
|
|
|
|
the vm should yield the cpu when polling the port.
|
|
|
|
By default, the builder will assume this as `FALSE`.
|
|
|
|
* `DEVICE:path(,yield)` - Specifies the path to the local device to be used
|
|
|
|
as the serial port. If `path` is empty, then
|
|
|
|
default to the first serial port.
|
|
|
|
* `yield` (bool) - This is an optional boolean that specifies whether
|
|
|
|
the vm should yield the cpu when polling the port.
|
|
|
|
By default, the builder will assume this as `FALSE`.
|
|
|
|
* `PIPE:path,endpoint,host(,yield)` - Specifies to use the named-pipe "path"
|
|
|
|
as a serial port. This has a few
|
|
|
|
options that determine how the VM
|
|
|
|
should use the named-pipe.
|
|
|
|
* `endpoint` (string) - Chooses the type of the VM-end, which can be
|
|
|
|
either a `client` or `server`.
|
|
|
|
* `host` (string) - Chooses the type of the host-end, which can be either
|
|
|
|
an `app` (application) or `vm` (another virtual-machine).
|
|
|
|
* `yield` (bool) - This is an optional boolean that specifies whether
|
|
|
|
the vm should yield the cpu when polling the port.
|
|
|
|
By default, the builder will assume this as `FALSE`.
|
|
|
|
|
|
|
|
* `AUTO:(yield)` - Specifies to use auto-detection to determine the serial
|
|
|
|
port to use. This has one option to determine how the VM
|
|
|
|
should support the serial port.
|
|
|
|
* `yield` (bool) - This is an optional boolean that specifies whether
|
|
|
|
the vm should yield the cpu when polling the port.
|
|
|
|
By default, the builder will assume this as `FALSE`.
|
2017-04-12 18:41:36 -04:00
|
|
|
* `NONE` - Specifies to not use a serial port. (default)
|
2016-10-05 22:51:42 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `shutdown_command` (string) - The command to use to gracefully shut down the
|
2015-07-22 23:25:58 -04:00
|
|
|
machine once all the provisioning is done. By default this is an empty
|
|
|
|
string, which tells Packer to just forcefully shut down the machine.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `shutdown_timeout` (string) - The amount of time to wait after executing the
|
2015-07-22 23:25:58 -04:00
|
|
|
`shutdown_command` for the virtual machine to actually shut down. If it
|
|
|
|
doesn't shut down in this time, it is an error. By default, the timeout is
|
2018-04-21 20:50:40 -04:00
|
|
|
`5m` or five minutes.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `skip_compaction` (boolean) - VMware-created disks are defragmented and
|
2015-07-22 23:25:58 -04:00
|
|
|
compacted at the end of the build process using `vmware-vdiskmanager`. In
|
|
|
|
certain rare cases, this might actually end up making the resulting disks
|
|
|
|
slightly larger. If you find this to be the case, you can disable compaction
|
2017-06-14 21:04:16 -04:00
|
|
|
using this configuration value. Defaults to `false`.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `skip_export` (boolean) - Defaults to `false`. When enabled, Packer will
|
2017-01-10 18:26:43 -05:00
|
|
|
not export the VM. Useful if the build output is not the resultant image,
|
|
|
|
but created inside the VM.
|
2017-01-10 06:46:42 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `keep_registered` (boolean) - Set this to `true` if you would like to keep
|
2016-03-16 18:31:50 -04:00
|
|
|
the VM registered with the remote ESXi server. This is convenient if you
|
|
|
|
use packer to provision VMs on ESXi and don't want to use ovftool to
|
2016-04-06 09:24:03 -04:00
|
|
|
deploy the resulting artifact (VMX or OVA or whatever you used as `format`).
|
|
|
|
Defaults to `false`.
|
2016-03-16 18:31:50 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `ovftool_options` (array of strings) - Extra options to pass to ovftool
|
2017-02-10 03:22:02 -05:00
|
|
|
during export. Each item in the array is a new argument. The options
|
|
|
|
`--noSSLVerify`, `--skipManifestCheck`, and `--targetType` are reserved,
|
|
|
|
and should not be passed to this argument.
|
|
|
|
|
2016-10-05 22:51:42 -04:00
|
|
|
- `sound` (boolean) - Enable VMware's virtual soundcard device for the VM.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `tools_upload_flavor` (string) - The flavor of the VMware Tools ISO to
|
2018-04-21 20:50:40 -04:00
|
|
|
upload into the VM. Valid values are `darwin`, `linux`, and `windows`. By
|
2015-07-22 23:25:58 -04:00
|
|
|
default, this is empty, which means VMware tools won't be uploaded.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `tools_upload_path` (string) - The path in the VM to upload the
|
2015-07-22 23:25:58 -04:00
|
|
|
VMware tools. This only takes effect if `tools_upload_flavor` is non-empty.
|
|
|
|
This is a [configuration
|
2017-03-28 18:28:34 -04:00
|
|
|
template](/docs/templates/engine.html) that has a single
|
2015-07-22 23:25:58 -04:00
|
|
|
valid variable: `Flavor`, which will be the value of `tools_upload_flavor`.
|
|
|
|
By default the upload path is set to `{{.Flavor}}.iso`. This setting is not
|
2018-04-21 20:50:40 -04:00
|
|
|
used when `remote_type` is `esx5`.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2018-03-05 21:58:43 -05:00
|
|
|
- `usb` (boolean) - Enable VMware's USB bus for the guest VM. To enable usage
|
|
|
|
of the XHCI bus for USB 3 (5 Gbit/s), one can use the `vmx_data` option to
|
2018-04-21 20:50:40 -04:00
|
|
|
enable it by specifying `true` for the `usb_xhci.present` property.
|
2016-10-05 22:51:42 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `version` (string) - The [vmx hardware
|
2015-07-22 23:25:58 -04:00
|
|
|
version](http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1003746)
|
|
|
|
for the new virtual machine. Only the default value has been tested, any
|
2018-04-21 20:50:40 -04:00
|
|
|
other value is experimental. Default value is `9`.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `vm_name` (string) - This is the name of the VMX file for the new virtual
|
2018-04-21 20:50:40 -04:00
|
|
|
machine, without the file extension. By default this is `packer-BUILDNAME`,
|
2015-07-22 23:25:58 -04:00
|
|
|
where "BUILDNAME" is the name of the build.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `vmdk_name` (string) - The filename of the virtual disk that'll be created,
|
2018-04-21 20:50:40 -04:00
|
|
|
without the extension. This defaults to `packer`.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `vmx_data` (object of key/value strings) - Arbitrary key/values to enter
|
2015-07-22 23:25:58 -04:00
|
|
|
into the virtual machine VMX file. This is for advanced users who want to
|
|
|
|
set properties such as memory, CPU, etc.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `vmx_data_post` (object of key/value strings) - Identical to `vmx_data`,
|
2015-07-22 23:25:58 -04:00
|
|
|
except that it is run after the virtual machine is shutdown, and before the
|
|
|
|
virtual machine is exported.
|
|
|
|
|
2018-04-21 20:50:40 -04:00
|
|
|
- `vmx_remove_ethernet_interfaces` (boolean) - Remove all ethernet interfaces
|
|
|
|
from the VMX file after building. This is for advanced users who understand
|
|
|
|
the ramifications, but is useful for building Vagrant boxes since Vagrant
|
|
|
|
will create ethernet interfaces when provisioning a box. Defaults to
|
|
|
|
`false`.
|
2017-05-24 19:44:35 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `vmx_template_path` (string) - Path to a [configuration
|
2017-03-28 18:28:34 -04:00
|
|
|
template](/docs/templates/engine.html) that defines the
|
2015-07-22 23:25:58 -04:00
|
|
|
contents of the virtual machine VMX file for VMware. This is for **advanced
|
|
|
|
users only** as this can render the virtual machine non-functional. See
|
|
|
|
below for more information. For basic VMX modifications, try
|
|
|
|
`vmx_data` first.
|
|
|
|
|
2018-04-21 20:50:40 -04:00
|
|
|
- `vnc_bind_address` (string / IP address) - The IP address that should be
|
|
|
|
binded to for VNC. By default packer will use `127.0.0.1` for this. If you
|
|
|
|
wish to bind to all interfaces use `0.0.0.0`.
|
2016-08-19 06:49:23 -04:00
|
|
|
|
2018-04-21 20:50:40 -04:00
|
|
|
- `vnc_disable_password` (boolean) - Don't auto-generate a VNC password that
|
|
|
|
is used to secure the VNC communication with the VM.
|
2016-05-25 04:32:42 -04:00
|
|
|
|
2017-10-16 14:23:33 -04:00
|
|
|
- `vnc_port_min` and `vnc_port_max` (number) - The minimum and maximum port
|
2015-07-22 23:25:58 -04:00
|
|
|
to use for VNC access to the virtual machine. The builder uses VNC to type
|
|
|
|
the initial `boot_command`. Because Packer generally runs in parallel,
|
|
|
|
Packer uses a randomly chosen port in this range that appears available. By
|
2018-04-21 20:50:40 -04:00
|
|
|
default this is `5900` to `6000`. The minimum and maximum ports are
|
|
|
|
inclusive.
|
2014-05-04 13:47:40 -04:00
|
|
|
|
2013-12-26 19:10:53 -05:00
|
|
|
## Boot Command
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
The `boot_command` configuration is very important: it specifies the keys to
|
|
|
|
type when the virtual machine is first booted in order to start the OS
|
|
|
|
installer. This command is typed after `boot_wait`, which gives the virtual
|
|
|
|
machine some time to actually load the ISO.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
As documented above, the `boot_command` is an array of strings. The strings are
|
|
|
|
all typed in sequence. It is an array only to improve readability within the
|
|
|
|
template.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
The boot command is "typed" character for character over a VNC connection to the
|
2017-01-14 20:56:04 -05:00
|
|
|
machine, simulating a human actually typing the keyboard.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
-> Keystrokes are typed as separate key up/down events over VNC with a
|
|
|
|
default 100ms delay. The delay alleviates issues with latency and CPU
|
|
|
|
contention. For local builds you can tune this delay by specifying
|
|
|
|
e.g. `PACKER_KEY_INTERVAL=10ms` to speed through the boot command.
|
2017-01-14 20:56:04 -05:00
|
|
|
|
2018-04-13 19:48:26 -04:00
|
|
|
<%= partial "partials/builders/boot-command" %>
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2018-04-20 15:28:11 -04:00
|
|
|
-> **Note**: for the `HTTPIP` to be resolved correctly, your VM's network
|
|
|
|
configuration has to include a `hostonly` or `nat` type network interface.
|
|
|
|
If you are using this feature, it is recommended to leave the default network
|
|
|
|
configuration while you are building the VM, and use the `vmx_data_post` hook
|
|
|
|
to modify the network configuration after the VM is done building.
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
Example boot command. This is actually a working boot command used to start an
|
|
|
|
Ubuntu 12.04 installer:
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
``` text
|
2013-12-26 19:10:53 -05:00
|
|
|
[
|
2015-01-04 13:43:54 -05:00
|
|
|
"<esc><esc><enter><wait>",
|
2013-12-26 19:10:53 -05:00
|
|
|
"/install/vmlinuz noapic ",
|
|
|
|
"preseed/url=http://{{ .HTTPIP }}:{{ .HTTPPort }}/preseed.cfg ",
|
|
|
|
"debian-installer=en_US auto locale=en_US kbd-chooser/method=us ",
|
|
|
|
"hostname={{ .Name }} ",
|
|
|
|
"fb=false debconf/frontend=noninteractive ",
|
|
|
|
"keyboard-configuration/modelcode=SKIP keyboard-configuration/layout=USA ",
|
|
|
|
"keyboard-configuration/variant=USA console-setup/ask_detect=false ",
|
2015-01-04 13:43:54 -05:00
|
|
|
"initrd=/install/initrd.gz -- <enter>"
|
2013-12-26 19:10:53 -05:00
|
|
|
]
|
2014-10-20 13:55:16 -04:00
|
|
|
```
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-10-12 01:58:03 -04:00
|
|
|
For more examples of various boot commands, see the sample projects from our
|
2017-10-13 21:59:58 -04:00
|
|
|
[community templates page](/community-tools.html#templates).
|
2017-10-12 01:58:03 -04:00
|
|
|
|
2013-12-26 19:10:53 -05:00
|
|
|
## VMX Template
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
The heart of a VMware machine is the "vmx" file. This contains all the virtual
|
|
|
|
hardware metadata necessary for the VM to function. Packer by default uses a
|
|
|
|
[safe, flexible VMX
|
2017-04-04 16:39:01 -04:00
|
|
|
file](https://github.com/hashicorp/packer/blob/20541a7eda085aa5cf35bfed5069592ca49d106e/builder/vmware/step_create_vmx.go#L84).
|
2015-07-22 22:31:00 -04:00
|
|
|
But for advanced users, this template can be customized. This allows Packer to
|
|
|
|
build virtual machines of effectively any guest operating system type.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
~> **This is an advanced feature.** Modifying the VMX template can easily
|
2015-07-22 22:31:00 -04:00
|
|
|
cause your virtual machine to not boot properly. Please only modify the template
|
|
|
|
if you know what you're doing.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
Within the template, a handful of variables are available so that your template
|
|
|
|
can continue working with the rest of the Packer machinery. Using these
|
|
|
|
variables isn't required, however.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `Name` - The name of the virtual machine.
|
|
|
|
- `GuestOS` - The VMware-valid guest OS type.
|
|
|
|
- `DiskName` - The filename (without the suffix) of the main virtual disk.
|
|
|
|
- `ISOPath` - The path to the ISO to use for the OS installation.
|
|
|
|
- `Version` - The Hardware version VMWare will execute this vm under. Also
|
2015-07-22 23:25:58 -04:00
|
|
|
known as the `virtualhw.version`.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
|
|
|
## Building on a Remote vSphere Hypervisor
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
In addition to using the desktop products of VMware locally to build virtual
|
|
|
|
machines, Packer can use a remote VMware Hypervisor to build the virtual
|
|
|
|
machine.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
-> **Note:** Packer supports ESXi 5.1 and above.
|
2014-05-02 11:27:42 -04:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
Before using a remote vSphere Hypervisor, you need to enable GuestIPHack by
|
|
|
|
running the following command:
|
2014-05-02 11:27:42 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
``` text
|
2014-05-02 11:27:42 -04:00
|
|
|
esxcli system settings advanced set -o /Net/GuestIPHack -i 1
|
|
|
|
```
|
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
When using a remote VMware Hypervisor, the builder still downloads the ISO and
|
|
|
|
various files locally, and uploads these to the remote machine. Packer currently
|
|
|
|
uses SSH to communicate to the ESXi machine rather than the vSphere API. At some
|
|
|
|
point, the vSphere API may be used.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-10-09 20:12:33 -04:00
|
|
|
Packer also requires VNC to issue boot commands during a build, which may be
|
2015-07-22 22:31:00 -04:00
|
|
|
disabled on some remote VMware Hypervisors. Please consult the appropriate
|
|
|
|
documentation on how to update VMware Hypervisor's firewall to allow these
|
2017-10-09 20:12:33 -04:00
|
|
|
connections. VNC can be disabled by not setting a `boot_command` and setting
|
|
|
|
`disable_vnc` to `true`.
|
2014-09-16 23:16:22 -04:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
To use a remote VMware vSphere Hypervisor to build your virtual machine, fill in
|
|
|
|
the required `remote_*` configurations:
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_type` - This must be set to "esx5".
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_host` - The host of the remote machine.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
Additionally, there are some optional configurations that you'll likely have to
|
|
|
|
modify as well:
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_port` - The SSH port of the remote machine
|
2015-08-03 12:53:33 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_datastore` - The path to the datastore where the VM will be stored
|
2015-07-22 23:25:58 -04:00
|
|
|
on the ESXi machine.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_cache_datastore` - The path to the datastore where supporting files
|
2015-07-22 23:25:58 -04:00
|
|
|
will be stored during the build on the remote machine.
|
2014-10-14 22:25:15 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_cache_directory` - The path where the ISO and/or floppy files will
|
2015-07-22 23:25:58 -04:00
|
|
|
be stored during the build on the remote machine. The path is relative to
|
|
|
|
the `remote_cache_datastore` on the remote machine.
|
2014-10-14 22:25:15 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_username` - The SSH username used to access the remote machine.
|
2013-12-26 19:10:53 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_password` - The SSH password for access to the remote machine.
|
2015-08-17 06:15:26 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `remote_private_key_file` - The SSH key for access to the remote machine.
|
2015-11-13 20:43:22 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `format` (string) - Either "ovf", "ova" or "vmx", this specifies the output
|
2015-02-13 05:13:58 -05:00
|
|
|
format of the exported virtual machine. This defaults to "ovf".
|
2017-10-09 20:12:33 -04:00
|
|
|
Before using this option, you need to install `ovftool`. This option
|
|
|
|
works currently only with option remote_type set to "esx5".
|
2015-02-13 05:13:58 -05:00
|
|
|
|
2017-05-23 17:50:49 -04:00
|
|
|
### VNC port discovery
|
|
|
|
|
|
|
|
Packer needs to decide on a port to use for VNC when building remotely. To find
|
|
|
|
an open port, we try to connect to ports in the range of `vnc_port_min` to
|
|
|
|
`vnc_port_max`. If we notice something is listening on a port in the range, we
|
|
|
|
try to connect to the next one, and so on until we find a port that has nothing
|
|
|
|
listening on it. If you have many clients building on the ESXi host, there
|
|
|
|
might be competition for the VNC ports. You can adjust how long packer waits
|
|
|
|
for a connection timeout by setting `PACKER_ESXI_VNC_PROBE_TIMEOUT`. This
|
|
|
|
defaults to 15 seconds. Set this shorter if vnc connections are refused, and
|
|
|
|
set it longer if Packer can't find an open port. This is intended as an
|
|
|
|
advanced configuration option. Please make sure your firewall settings are
|
|
|
|
correct before adjusting.
|
|
|
|
|
2015-08-17 17:56:26 -04:00
|
|
|
### Using a Floppy for Linux kickstart file or preseed
|
2015-08-17 06:15:26 -04:00
|
|
|
|
2015-08-17 17:56:26 -04:00
|
|
|
Depending on your network configuration, it may be difficult to use packer's
|
|
|
|
built-in HTTP server with ESXi. Instead, you can provide a kickstart or preseed
|
|
|
|
file by attaching a floppy disk. An example below, based on RHEL:
|
2015-08-17 06:15:26 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
``` json
|
2015-08-17 17:56:26 -04:00
|
|
|
{
|
|
|
|
"builders": [
|
|
|
|
{
|
|
|
|
"type":"vmware-iso",
|
|
|
|
"floppy_files": [
|
|
|
|
"folder/ks.cfg"
|
|
|
|
],
|
|
|
|
"boot_command": "<tab> text ks=floppy <enter><wait>"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
2015-08-17 06:15:26 -04:00
|
|
|
```
|
2015-11-10 16:46:15 -05:00
|
|
|
|
2017-10-17 14:29:11 -04:00
|
|
|
It's also worth noting that `ks=floppy` has been deprecated. Later versions of
|
|
|
|
the Anaconda installer (used in RHEL/CentOS 7 and Fedora) may require
|
|
|
|
a different syntax to source a kickstart file from a mounted floppy image.
|
2015-11-10 16:46:15 -05:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
``` json
|
2015-11-10 16:46:15 -05:00
|
|
|
{
|
|
|
|
"builders": [
|
|
|
|
{
|
|
|
|
"type":"vmware-iso",
|
|
|
|
"floppy_files": [
|
|
|
|
"folder/ks.cfg"
|
|
|
|
],
|
|
|
|
"boot_command": "<tab> inst.text inst.ks=hd:fd0:/ks.cfg <enter><wait>"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
|
|
|
```
|