ANSIBLE.OVIRT(3)                ANSIBLE MODULES               ANSIBLE.OVIRT(3)



NAME
       ovirt - oVirt/RHEV platform management

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

OPTIONS
       disk_alloc
              define if disk is thin or preallocated Choices:
              thin,preallocated. (default: thin)

       disk_int
              interface type of the disk Choices: virtio,ide. (default:
              virtio)

       image  template to use for the instance

       instance_cores
              define the instance's number of cores (default: yes

       instance_cpus
              the instance's number of cpu's (default: yes

       instance_disksize
              size of the instance's disk in GB

       instance_mem
              the instance's amount of memory in MB

       instance_name
              the name of the instance to use(required)

       instance_network
              the logical network the machine should belong to (default:
              rhevm)

       instance_nic
              name of the network interface in oVirt/RHEV

       instance_os
              type of Operating System

       instance_type
              define if the instance is a server or desktop Choices:
              server,desktop. (default: server)

       password
              password of the user to authenticate with(required)

       region the oVirt/RHEV datacenter where you want to deploy to

       resource_type
              whether you want to deploy an image or create an instance from
              scratch.  Choices: new,template.

       sdomain
              the Storage Domain where you want to create the instance's disk
              on.

       state  create, terminate or remove instances Choices:
              present,absent,shutdown,started,restarted. (default: present)

       url    the url of the oVirt instance(required)

       user   the user to authenticate with(required)

       zone   deploy the image to this oVirt cluster.

EXAMPLES
       # Basic example provisioning from image.

       action: ovirt >
           user=admin@internal
           url=https://ovirt.example.com
           instance_name=ansiblevm04
           password=secret
           image=centos_64
           zone=cluster01
           resource_type=template"

       # Full example to create new instance from scratch
       action: 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"

       # stopping an instance
       action: ovirt >
           instance_name=testansible
           state=stopped
           user=admin@internal
           password=secret
           url=https://ovirt.example.com

       # starting an instance
       action: ovirt >
           instance_name=testansible
           state=started
           user=admin@internal
           password=secret
           url=https://ovirt.example.com





AUTHOR
       Vincent Van der Kussen

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#ovirt



1.4.5                             2014-02-12                  ANSIBLE.OVIRT(3)
