community.general.ovirt – oVirt/RHEV platform management

Note

This plugin is part of the community.general collection (version 2.5.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.ovirt.

DEPRECATED

Removed in

version 3.0.0

Why

This module is for deprecated version of ovirt.

Alternative

Use ovirt_vm from the ovirt.ovirt collection instead

Synopsis

  • This module only supports oVirt/RHEV version 3. A newer module ovirt.ovirt.ovirt_vm supports oVirt/RHV version 4.

  • Allows you to create new instances, either from scratch or an image, in addition to deleting or stopping instances on the oVirt/RHEV platform.

Requirements

The below requirements are needed on the host that executes this module.

  • ovirt-engine-sdk-python

Parameters

Parameter Choices/Defaults Comments
disk_alloc
string
    Choices:
  • preallocated
  • thin ←
Define whether disk is thin or preallocated.
disk_int
string
    Choices:
  • ide
  • virtio ←
Interface type of the disk.
image
string
The template to use for the instance.
instance_cores
string
Default:
1
Define the instance's number of cores.

aliases: vmcores
instance_cpus
string
Default:
1
The instance's number of CPUs.

aliases: vmcpus
instance_disksize
string
Size of the instance's disk in GB.

aliases: vm_disksize
instance_dns
string
Define the instance's Primary DNS server.

aliases: dns
instance_domain
string
Define the instance's Domain.

aliases: domain
instance_gateway
string
Define the instance's Gateway.

aliases: gateway
instance_hostname
string
Define the instance's Hostname.

aliases: hostname
instance_ip
string
Define the instance's IP.

aliases: ip
instance_key
string
Define the instance's Authorized key.

aliases: key
instance_mem
string
The instance's amount of memory in MB.

aliases: vmmem
instance_name
string / required
The name of the instance to use.

aliases: vmname
instance_netmask
string
Define the instance's Netmask.

aliases: netmask
instance_network
string
Default:
"rhevm"
The logical network the machine should belong to.

aliases: vmnetwork
instance_nic
string
The name of the network interface in oVirt/RHEV.

aliases: vmnic
instance_os
string
Type of Operating System.

aliases: vmos
instance_rootpw
string
Define the instance's Root password.

aliases: rootpw
instance_type
string
    Choices:
  • desktop
  • server ←
  • high_performance
Define whether the instance is a server, desktop or high_performance.
high_performance is supported since Ansible 2.5 and oVirt/RHV 4.2.

aliases: vmtype
password
string / required
Password of the user to authenticate with.
region
string
The oVirt/RHEV datacenter where you want to deploy to.
resource_type
string
    Choices:
  • new
  • template
Whether you want to deploy an image or create an instance from scratch.
sdomain
string
The Storage Domain where you want to create the instance's disk on.
state
string
    Choices:
  • absent
  • present ←
  • restart
  • shutdown
  • started
Create, terminate or remove instances.
url
string / required
The url of the oVirt instance.
user
string / required
The user to authenticate with.
zone
string
Deploy the image to this oVirt cluster.

Examples

- name: Basic example to provision from image
  community.general.ovirt:
    user: admin@internal
    url: https://ovirt.example.com
    instance_name: ansiblevm04
    password: secret
    image: centos_64
    zone: cluster01
    resource_type: template

- name: Full example to create new instance from scratch
  community.general.ovirt:
    instance_name: testansible
    resource_type: new
    instance_type: server
    user: admin@internal
    password: secret
    url: https://ovirt.example.com
    instance_disksize: 10
    zone: cluster01
    region: datacenter1
    instance_cpus: 1
    instance_nic: nic1
    instance_network: rhevm
    instance_mem: 1000
    disk_alloc: thin
    sdomain: FIBER01
    instance_cores: 1
    instance_os: rhel_6x64
    disk_int: virtio

- name: Stopping an existing instance
  community.general.ovirt:
    instance_name: testansible
    state: stopped
    user: admin@internal
    password: secret
    url: https://ovirt.example.com

- name: Start an existing instance
  community.general.ovirt:
    instance_name: testansible
    state: started
    user: admin@internal
    password: secret
    url: https://ovirt.example.com

- name: Start an instance with cloud init information
  community.general.ovirt:
    instance_name: testansible
    state: started
    user: admin@internal
    password: secret
    url: https://ovirt.example.com
    hostname: testansible
    domain: ansible.local
    ip: 192.0.2.100
    netmask: 255.255.255.0
    gateway: 192.0.2.1
    rootpw: bigsecret

Status

  • This module will be removed in version 3.0.0. [deprecated]

  • For more information see DEPRECATED.

Authors

  • Vincent Van der Kussen (@vincentvdk)