Ansible Role kvm_host

This role installs the required packages and configures the host as a KVM host.

Mandatory Requirements

  • Install Python 3, and the python3-libvirt and python3-lxml modules.

Tags

Tag

What it does

kvm_host

Install the required packages and configure the host as a KVM host

Optional Role Variables

Variable

Description

Default Value

kvm_host__libvirt_guests_on_shutdown

What should happen with the guests (VMs) when the host shuts down. Possible options:
* shutdown
* suspend

'shutdown'

kvm_host__libvirt_guests_parallel_shutdown

Number of guests will be shutdown concurrently.

5

kvm_host__libvirt_guests_service_enabled

Enables or disables the libvirt-guests service, analogous to systemctl enable/disable --now.

true

kvm_host__libvirt_guests_shutdown_timeout

Number of seconds we’re willing to wait for a guest to shut down.

300

kvm_host__libvirtd_service_enabled

Enables or disables the libvirtd service, analogous to systemctl enable/disable --now.

true

kvm_host__networks

A list of libvirt network definitions. Subkeys:
* name: Mandatory, string. The name of the network.
* bridge: Optional, string. If set, will be used as the network bridge.
* ip_address: Optional, string. If set, will be used the IP address for the interface.
* subnet: Optional, string. Subnet mask for the network. Defaults to 255.255.255.0 if the ip_address is set.
* dhcp_start: Optional, string. Start of the DHCP range. Requires dhcp_end to be set as well.
* dhcp_end: Optional, string. End of the DHCP range. Requires dhcp_start to be set as well.

[]

kvm_host__pools

A list of libvirt storage pool definitions. Currently only supports directory pools. Subkeys:
* name: Mandatory, string. The name of the pool. Use default to overwrite the default pool.
* path: Mandatory, string. Path to the directory that should be used as the storage pool.

[]

Example:

# optional
kvm_host__libvirt_guests_on_shutdown: 'shutdown'
kvm_host__libvirt_guests_parallel_shutdown: 5
kvm_host__libvirt_guests_service_enabled: true
kvm_host__libvirt_guests_shutdown_timeout: 300
kvm_host__libvirtd_service_enabled: true
kvm_host__networks:
  - name: 'default'
    bridge: 'virbr0'
    ip_address: '192.0.2.0.1'
    subnet: '255.255.255.0'
    dhcp_start: '192.0.2.0.10'
    dhcp_end: '192.0.2.0.254'
kvm_host__pools:
  - name: 'default'
    path: '/data/kvm/images'

License

The Unlicense

Author Information

Linuxfabrik GmbH, Zurich