Skip to main content

kitchen-hyperv

The kitchen-hyperv driver provisions virtual machines on Microsoft Hyper-V. This driver ships with Chef Workstation. Run it on a Windows host that has the Hyper-V role enabled, and specify a parent VHD and a virtual switch in the driver configuration.

Example kitchen.yml

The following example sets hyperv as the driver in a kitchen.yml file:

driver:
  name: hyperv
  parent_vhd_folder: C:\vhd
  parent_vhd_name: ubuntu-22.04.vhdx
  memory_startup_bytes: 2GB

platforms:
  - name: ubuntu-22.04

Configuration

The kitchen-hyperv driver provides configuration options that you set in the driver section of your kitchen.yml file, either globally or for an individual platform. For the complete and current list of settings, see the kitchen-hyperv repository.

Note

The upstream driver documentation can lag behind the driver code. Verify the configuration options against the version of kitchen-hyperv installed in your Test Kitchen environment.

Thank you for your feedback!

×