Try SpotterRHEV/oVirt automation
| "added in version" 2.2 of ansible.builtin"
Authors: Timothy Vandenbrande (@TimothyVandenbrande)
preview | supported by community
pipInstall with pip install ansible==2.9.27
This module only supports oVirt/RHEV version 3.
A newer module M(ovirt_vm) supports oVirt/RHV version 4.
Allows you to create/remove/update or powermanage virtual machines on a RHEV/oVirt platform.
- name: Basic get info from VM
rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: demo
state: info
- name: Basic create example from image
rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: demo
cluster: centos
image: centos7_x64
state: present
- name: Power management
rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
cluster: RH
name: uptime_server
image: centos7_x64
state: down
- name: Multi disk, multi nic create example
rhevm:
server: rhevm01
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
cluster: RH
name: server007
type: server
vmcpu: 4
vmmem: 2
ifaces:
- name: eth0
vlan: vlan2202
- name: eth1
vlan: vlan36
- name: eth2
vlan: vlan38
- name: eth3
vlan: vlan2202
disks:
- name: root
size: 10
domain: ssd-san
- name: swap
size: 10
domain: 15kiscsi-san
- name: opt
size: 10
domain: 15kiscsi-san
- name: var
size: 10
domain: 10kiscsi-san
- name: home
size: 10
domain: sata-san
boot_order:
- network
- hd
state: present
- name: Add a CD to the disk cd_drive
rhevm:
user: '{{ rhev.admin.name }}'
password: '{{ rhev.admin.pass }}'
name: server007
cd_drive: rhev-tools-setup.iso
state: cd
- name: New host deployment + host network configuration
rhevm:
password: '{{ rhevm.admin.pass }}'
name: ovirt_node007
type: host
cluster: rhevm01
ifaces:
- name: em1
- name: em2
- name: p3p1
ip: 172.31.224.200
netmask: 255.255.254.0
- name: p3p2
ip: 172.31.225.200
netmask: 255.255.254.0
- name: bond0
bond:
- em1
- em2
network: rhevm
ip: 172.31.222.200
netmask: 255.255.255.0
management: yes
- name: bond0.36
network: vlan36
ip: 10.2.36.200
netmask: 255.255.254.0
gateway: 10.2.36.254
- name: bond0.2202
network: vlan2202
- name: bond0.38
network: vlan38
state: present
name:
description:
- The name of the VM.
type: str
port:
default: 443
description:
- The port on which the API is reachable.
type: int
type:
choices:
- desktop
- host
- server
default: server
description:
- To define if the VM is a server or desktop.
type: str
user:
default: admin@internal
description:
- The user to authenticate with.
type: str
disks:
description:
- This option uses complex arguments and is a list of disks with the options name,
size and domain.
type: list
image:
description:
- The template to use for the VM.
type: str
osver:
default: rhel_6x64
description:
- The operating system option in RHEV/oVirt.
type: str
state:
choices:
- absent
- cd
- down
- info
- ping
- present
- restarted
- up
default: present
description:
- This serves to create/remove/update or powermanage your VM.
type: str
vm_ha:
default: true
description:
- To make your VM High Available.
type: bool
vmcpu:
default: 2
description:
- The number of CPUs you want in your VM.
type: int
vmmem:
default: 1
description:
- The amount of memory you want your VM to use (in GB).
type: int
ifaces:
aliases:
- interfaces
- nics
description:
- This option uses complex arguments and is a list of interfaces with the options
name and vlan.
type: list
mempol:
default: 1
description:
- The minimum amount of memory you wish to reserve for this system.
type: int
server:
default: 127.0.0.1
description:
- The name/IP of your RHEV-m/oVirt instance.
type: str
vmhost:
description:
- The host you wish your VM to run on.
type: str
cluster:
description:
- The RHEV/oVirt cluster in which you want you VM to start.
type: str
timeout:
description:
- The timeout you wish to define for power actions.
- When I(state = 'up').
- When I(state = 'down').
- When I(state = 'restarted').
type: int
cd_drive:
description:
- The CD you wish to have mounted on the VM when I(state = 'CD').
type: str
del_prot:
default: true
description:
- This option sets the delete protection checkbox.
type: bool
password:
description:
- The password for user authentication.
type: str
cpu_share:
default: 0
description:
- This parameter is used to configure the CPU share.
type: int
boot_order:
default:
- hd
- network
description:
- This option uses complex arguments and is a list of items that specify the bootorder.
type: list
datacenter:
default: Default
description:
- The RHEV/oVirt datacenter in which you want you VM to start.
type: str
insecure_api:
default: false
description:
- A boolean switch to make a secure or insecure connection to the server.
type: bool
vm:
description: Returns all of the VMs variables and execution.
returned: always
sample: '{ "boot_order": [ "hd", "network" ], "changed": true, "changes": [ "Delete
Protection" ], "cluster": "C1", "cpu_share": "0", "created": false, "datacenter":
"Default", "del_prot": true, "disks": [ { "domain": "ssd-san", "name": "OS", "size":
40 } ], "eth0": "00:00:5E:00:53:00", "eth1": "00:00:5E:00:53:01", "eth2": "00:00:5E:00:53:02",
"exists": true, "failed": false, "ifaces": [ { "name": "eth0", "vlan": "Management"
}, { "name": "eth1", "vlan": "Internal" }, { "name": "eth2", "vlan": "External"
} ], "image": false, "mempol": "0", "msg": [ "VM exists", "cpu_share was already
set to 0", "VM high availability was already set to True", "The boot order has
already been set", "VM delete protection has been set to True", "Disk web2_Disk0_OS
already exists", "The VM starting host was already set to host416" ], "name":
"web2", "type": "server", "uuid": "4ba5a1be-e60b-4368-9533-920f156c817b", "vm_ha":
true, "vmcpu": "4", "vmhost": "host416", "vmmem": "16" }'
type: dict