Kitchen::Hyperv

TODO: Write a gem description

Installation

Add this line to your application's Gemfile:

gem 'kitchen-hyperv'

Usage

In the .kitchen.yml

driver:
  name: 'hyperv'

Required parameters:

• parent_vhd_folder
  • Location of the base vhd files
• parent_vhd_name
  • Vhd file name for the base vhd file

Optional parameters:

• memory_startup_bytes
  • amount of RAM to assign to each virtual machine. Defaults to 536,870,912.
• processor_count
  • number of virtual processors to assign to each virtual machine. Defaults to 2.
• dynamic_memory
  • if true, the amount of memory allocated to a virtual machine is adjusted by Hyper-V dynamically. Defaults to false.
• dynamic_memory_min_bytes / dynamic_memory_max_bytes
  • The minimum and maximum amount of memory Hyper-V will allocate to a virtual machine if dynamic_memory is enabled. Defaults to 536,870,912 and 2,147,483,648 (512MB-2GB)
• ip_address
  • IP address for the virtual machine. If the VM is not on a network with DHCP, this can be used to assign an IP that can be reached from the host machine.
• subnet
  • The subnet of the virtual machine. Defaults to 255.255.255.0
• gateway
  • The default gateway of the virtual machine.
• dns_servers
  • A list of DNS Servers that can be reached on the virtual network.
• vm_switch
  • The virtual switch to attach the guest VMs. Defaults to the first switch returned from Get-VMSwitch.
• iso_path
  • Path on the host to the ISO to mount on the VMs.
• boot_iso_path
  • Path on the host to the ISO to mount before starting the VMs.
• vm_generation
  • The generation for the hyper-v VM. Defaults to 1.
• enable_guest_services
  • Enable the Hyper-V Integration Guest services for the VM before starting it. Hyper-V defauls is false (true|false)
• disk_type
  • The type of virtual disk to create, .VHD or .VHDX. Defaults to the file extension of the parent virtual hard drive.
• resize_vhd
  • Resize the disk to the specified size. Leave empty to keep the original size. Only works on newly created VM's. Defaults to empty.
• vm_note
  • A note to add to the VM's note field. Defaults to empty.

Image Configuration

The following changes need to be made to a Windows image that is going to be used for testing. This is not an exhaustive list and, your milage may vary.

WinRM

winrm set winrm/config/client/auth @{Basic="true"}
winrm set winrm/config/service/auth @{Basic="true"}
winrm set winrm/config/service @{AllowUnencrypted="true"}

Contributing

1. Fork it ( https://github.com/[my-github-username]/kitchen-hyperv/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request