Minor fixes, changes and improvements to Hyper-V VMCX docs

This commit is contained in:
DanHam 2018-07-19 23:38:33 +01:00
parent c8f54d5291
commit 1a7804221e
No known key found for this signature in database
GPG Key ID: 58E79AEDD6AA987E
1 changed files with 28 additions and 12 deletions

View File

@ -22,18 +22,18 @@ boots it, provisions software within the OS, and then shuts it down. The
result of the Hyper-V builder is a directory containing all the files
necessary to run the virtual machine portably.
## Basic Example
## Basic Examples
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:
Here are some basic examples. Neither example would really do anything more
than producing a copy of the source virtual machine. However, the examples
could be used as a starting point for more advanced templates.
Import from folder:
``` json
{
"type": "hyperv-vmcx",
"clone_from_vmcx_path": "c:\\virtual machines\\ubuntu-12.04.5-server-amd64",
"clone_from_vmcx_path": "c:/virtual machines/ubuntu-12.04.5-server-amd64",
"ssh_username": "packer",
"ssh_password": "packer",
"shutdown_command": "echo 'packer' | sudo -S shutdown -P now"
@ -71,12 +71,14 @@ builder.
### Required for virtual machine import:
- `clone_from_vmcx_path` (string) - The path to the exported virtual machine
folder.
- `clone_from_vmcx_path` (string) - The path to a directory containing a
previously exported virtual machine. The exported machine will be used
as the source for new VM.
### Required for virtual machine clone:
- `clone_from_vm_name` (string) - The name of the vm to clone from. Ideally
- `clone_from_vm_name` (string) - The name of the VM to clone from. Ideally
the machine to clone from should be shutdown.
### Optional:
@ -94,11 +96,25 @@ builder.
Packer to wait for 1 minute 30 seconds before typing the boot command.
The default duration is "10s" (10 seconds).
- `clone_all_snapshots` (boolean) - If set to `true` all snapshots will be
cloned when the machine is cloned.
- `clone_all_snapshots` (boolean) - If set to `true` all snapshots
present in the source machine will be copied when the machine is
cloned. The final result of the build will be an exported virtual
machine that contains all the snapshots of the parent.
- `clone_from_snapshot_name` (string) - The name of the snapshot to clone
from.
If `clone_from_vmcx_path` is set, this setting has no effect and any
snapshots associated with the source VM will also be present in the
resultant VM.
If `clone_from_snapshot_name` is configured, this setting has no
effect and the resultant machine will not contain any snapshots.
- `clone_from_snapshot_name` (string) - The name of a snapshot in the
source machine to use as a starting point for the clone. If the value
given is an empty string, the last snapshot present in the source will
be chosen as the starting point for the new VM.
This setting only has an effect if using `clone_from_vm_name` and is
ignored otherwise.
- `cpu` (number) - The number of CPUs the virtual machine should use. If
this isn't specified, the default is 1 CPU.