Update VMCX doc: Include `temp_path`; ISO & VMCX docs: Better explain opts

This commit is contained in:
DanHam 2018-07-09 15:56:31 +01:00
parent ee0a2469eb
commit e42e03ef2e
No known key found for this signature in database
GPG Key ID: 58E79AEDD6AA987E
2 changed files with 38 additions and 19 deletions

View File

@ -201,12 +201,13 @@ builder.
the default virtual network card. The MAC address must be a string with
no delimiters, for example "0000deadbeef".
- `output_directory` (string) - This is the path to the directory where the
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 the builder. By default this is "output-BUILDNAME" where
"BUILDNAME" is the name of the build.
- `output_directory` (string) - This setting specifies the directory that
artifacts from the build, such as the virtual machine files and disks,
will be output to. The path to the directory may be relative or
absolute. If relative, the path is relative to the working directory
`packer` is executed from. This directory must not exist or, if
created, must be empty prior to running the builder. By default this is
"output-BUILDNAME" where "BUILDNAME" is the name of the build.
- `ram_size` (number) - The amount, in megabytes, of RAM to assign to the
VM. By default, this is 1 GB.
@ -238,11 +239,11 @@ builder.
- `skip_compaction` (boolean) - If `true` skip compacting the hard disk for
the virtual machine when exporting. This defaults to `false`.
- `skip_export` (boolean) - If `true` Packer will skip the export of the
VM. If you are interested only in the VHD/VHDX files, you can enable
this option. This will create inline disks which improves the build
performance. There will not be any copying of source VHDs to the temp
directory. This defaults to `false`.
- `skip_export` (boolean) - If `true` Packer will skip the export of the VM.
If you are interested only in the VHD/VHDX files, you can enable this
option. The resulting VHD/VHDX file will be output to
`<output_directory>/Virtual Hard Disks`. By default this option is `false`
and Packer will export the VM to `output_directory`.
- `switch_name` (string) - The name of the switch to connect the virtual
machine to. By default, leaving this value unset will cause Packer to
@ -254,8 +255,15 @@ builder.
set on the switch's network card. If this value is set it should match
the VLAN specified in by `vlan_id`.
- `temp_path` (string) - This is the temporary path in which Packer will
create the virtual machine. By default the value is the system `%temp%`.
- `temp_path` (string) - The location under which Packer will create a
directory to house all the VM files and folders during the build.
By default `%TEMP%` is used which, for most systems, will evaluate to
`%USERPROFILE%/AppData/Local/Temp`.
The build directory housed under `temp_path` will have a name similar
to `packerhv1234567`. The seven digit number at the end of the name is
automatically generated by Packer to ensure the directory name is
unique.
- `use_fixed_vhd_format` (boolean) - If true, creates the boot disk on the
virtual machine as a fixed VHD format disk. The default is `false`, which

View File

@ -202,12 +202,13 @@ builder.
the default virtual network card. The MAC address must be a string with
no delimiters, for example "0000deadbeef".
- `output_directory` (string) - This is the path to the directory where the
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 the builder. By default this is "output-BUILDNAME" where
"BUILDNAME" is the name of the build.
- `output_directory` (string) - This setting specifies the directory that
artifacts from the build, such as the virtual machine files and disks,
will be output to. The path to the directory may be relative or
absolute. If relative, the path is relative to the working directory
`packer` is executed from. This directory must not exist or, if
created, must be empty prior to running the builder. By default this is
"output-BUILDNAME" where "BUILDNAME" is the name of the build.
- `ram_size` (number) - The amount, in megabytes, of RAM to assign to the
VM. By default, this is 1 GB.
@ -255,6 +256,16 @@ builder.
set on the switch's network card. If this value is set it should match
the VLAN specified in by `vlan_id`.
- `temp_path` (string) - The location under which Packer will create a
directory to house all the VM files and folders during the build.
By default `%TEMP%` is used which, for most systems, will evaluate to
`%USERPROFILE%/AppData/Local/Temp`.
The build directory housed under `temp_path` will have a name similar
to `packerhv1234567`. The seven digit number at the end of the name is
automatically generated by Packer to ensure the directory name is
unique.
- `vlan_id` (string) - This is the VLAN of the virtual machine's network
card for the new virtual machine. By default none is set. If none is set
then VLANs are not set on the virtual machine's network card.