ansible-kvm-vm's Introduction

kvm-vm

Create a VM on a RHEL+KVM hypervisor.

Requirements

Expects a working RHEL+KVM hypervisor to target
Either physical virtualization or nested virtualization

Role Variables

Variable	Required	Default	Description
`kvm_vm_hostname`	✔️		The FQDN for the VM
`kvm_vm_public_ip`	✔️		The reachable public IP for the VM
`kvm_vm_root_pwd`	✔️		Password for the root user of the VM
`kvm_vm_base_img`	✔️		Name of the base image located in /var/lib/libvirt/images on the KVM hypervisor
`kvm_vm_vcpus`	❌	`1`	Number of vCPUS to assign to the VM
`kvm_vm_ram`	❌	`1024`	Amount of ram to give to the VM in megabytes
`kvm_vm_os_disk_name`	❌	`{{ kvm_vm_hostname }}`	Name of the OS disk in /var/lib/libvirt/images
`kvm_vm_os_disk_size`	❌	`10G`	Size of OS disk for the VM
`kvm_vm_nics`	✔️	`see example playbook`	Dictionary of NICs to create for the VM

Dependencies

None

Example Playbook

- hosts: kvm
  tags: provision
  vars:
    kvm_vm_hostname: "vm1.example.com"
    kvm_vm_public_ip: 192.168.122.10
    kvm_vm_root_pwd: "p@ssw0rd"
    kvm_vm_base_img: rhel-guest-image-7.qcow2
    kvm_vm_vcpus: "2"
    kvm_vm_ram: "4096"
    kvm_vm_os_disk_name: "{{ kvm_vm_hostname }}"
    kvm_vm_os_disk_size: "10G"
    kvm_vm_nics:
      - name: eth0
        bootproto: static
        onboot: yes
        ip: "{{ kvm_vm_public_ip }}"
        prefix: "24"
        gateway: "192.168.122.1"
        dns_server: "192.168.122.1"
        config: "--type network --source default --model virtio"
  tasks:
    - name: Create KVM VM
      include_role:
        name: RedHatGov.kvm-vm