Role Name

A role to set up Libvirt with KVM as well as create KVM machines. Forked from https://github.com/hicknhack-software/ansible-libvirt

One Line Install

sudo ansible-galaxy install kireledan.libvirt
echo -ne "- hosts: localhost\n  remote_user: root\n  roles:\n    - kireledan.libvirt\n  vars:\n    state: install" > inst.yml
ansible-playbook inst.yml

Role Variables

image_download_path: "Path to download images"

libvirt_images_path: "Path of converted images (Be careful with changing this)"

libvirt_domain:
  # basic arguments
  groups: [] # names of Ansible nodes/groups used to provision the domain
  name: # name/uuid of the domain (empty means new uuid)
  title: '' # title of the vm
  description: '' # description of the vm
  apt_mirror: ''
  # note: if you do not provide a domain_id each run will create a new vm!

  # default VM configuration
  vm:
    memory: "512MiB" # RAM memory available to the VM
    vcpu: 1 # number of cores designated to the VM
    vcpu_placement: 'static' # options 'auto', 'static', defaults to 'numatune'
    vcpu_cpuset: [] # list of host CPU numbers the VM can run on
    networks: ['default'] # libvirts id of networks this VM is part of
    disk_size: "12G" # use this to change first disk size
    features: ['acpi', 'apic', 'pae'] # vm features available

  image_url: 'url to use'
  pubkey: 'ssh key to add to instance'

libvirt_cloud_config_default_user:
  name: 'ubuntu'
  gecos: 'Ubuntu'

Example Playbook

To set up the host.

    - hosts: localhost
  	  remote_user: root
  	  roles:
  	    - kireledan.libvirt
  	  vars:
  	    state: install

To Create a VM

- hosts: localhost
  remote_user: root
  roles:
    - kireledan.libvirt
  vars:
    state: create
    libvirt_domain:
      groups: ['cluster'] 
      name: 'Testing'
      title: 'Machine1' 
      description: 'test'
      image_url: "https://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-disk1.img"
      pubkey: "your ssh-key pub"

( The playbook will print the IP address of the machine created )

To Destroy the VM

- hosts: localhost
  remote_user: root
  roles:
    - kireledan.libvirt
  vars:
    state: destroy
    to_destroy: 
      - 'Testing'

License

MIT