kayobe/ansible/roles/libvirt-host/README.md
Mark Goddard c2771d7c0e Add libvirt-host role
Configures a host as a Libvirt/KVM hypervisor. It can also create pools and networks
2017-08-07 12:08:08 +00:00

1.6 KiB

Libvirt Host

This role configures a host as a Libvirt/KVM hypervisor. It can also configure storage pools and networks on the host.

Requirements

The host should have Virtualization Technology (VT) enabled.

Role Variables

libvirt_host_networks is a list of pools to define and start. Each item should be a dict containing the following items:

  • name The name of the pool.
  • type The type of the pool, currently only dir is supported.
  • capacity The capacity, in bytes, of the pool.
  • path The absolute path to the pool's backing directory.
  • mode The access mode of the pool.
  • owner The owner of the pool.
  • group The group of the pool.

libvirt_host_networks is a list of networks to define and start. Each item should be a dict containing the following items:

  • name The name of the network.
  • mode The forwarding mode of the network, currently only bridge is supported.
  • bridge` The name of the bridge interface for this network.

Dependencies

None

Example Playbook

---
- name: Ensure that Libvirt is configured
  hosts: all
  roles:
    - role: libvirt-host
      libvirt_host_pools:
        - name: my-pool
          type: dir
          capacity: 1024
          path: /path/to/pool
          mode: 0755
          owner: my-user
          group: my-group
      libvirt_host_networks:
        - name: br-example
          mode: bridge
          bridge: br-example

Author Information