community / community.general / 6.6.8 / module / rhevm RHEV/oVirt automation Authors: Timothy Vandenbrande (@TimothyVandenbrande)community.general.rhevm (6.6.8) — module
Install with ansible-galaxy collection install community.general:==6.6.8
collections: - name: community.general version: 6.6.8
This module only supports oVirt/RHEV version 3.
A newer module M(ovirt.ovirt.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 community.general.rhevm: server: rhevm01 user: '{{ rhev.admin.name }}' password: '{{ rhev.admin.pass }}' name: demo state: info
- name: Basic create example from image community.general.rhevm: server: rhevm01 user: '{{ rhev.admin.name }}' password: '{{ rhev.admin.pass }}' name: demo cluster: centos image: centos7_x64 state: present
- name: Power management community.general.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 community.general.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 community.general.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 community.general.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: true - 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. elements: str 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. elements: str 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: default: '' 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. required: true 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. elements: str 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