Ansible Role: virtio-win

Ansible Galaxy: https://galaxy.ansible.com/ruzickap/virtio-win/

This role helps you install Virtio Windows drivers and spice-guest-tools:

• Virtio Network Driver (netkvm)
• Virtio Block Driver (viostor)
• QXL Graphics Driver (qxldod)
• VirtIO SCSI Pass-Through Driver (vioscsi)
• Balloon Driver (Balloon)
• Virtio RNG Driver (viorng)
• Virtio Serial Driver (vioserial)
• Virtio Input Driver (vioinput)
• PV Panic Device Driver (pvpanic)
• QEMU Guest Agent (qemu-ga-x86_64)
• SPICE Guest Tools (vdagent-win)

This is useful if you run Windows on the KVM hypervisor, as it provides the best performance using VirtIO drivers and tools.

Requirements

Ansible version 2.7 or higher.

Role Variables

Here are the available variables along with their default values (check defaults/main.yml):

# Find the available versions here https://www.spice-space.org/download/windows/vdagent/
vdagent_win_version: 0.9.0

# URL of the virtio-win.iso file
virtio_win_iso_url: https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/latest-virtio/virtio-win.iso

# Path where the files/directories from the virtio-win.iso are located (usually a CD-ROM).
# If set, the virtio-win.iso will be downloaded.
virtio_win_iso_path: E:\\

Dependencies

Requires a 64-bit Windows (amd64/x64).

Example Playbook

- hosts: all
  roles:
    - { role: ruzickap.virtio-win }
    # or
    - role: ruzickap.virtio-win
      virtio_win_iso_path: 'E:\\'

License

MIT License

Author Information

This role was created in 2017 by [email protected].