community.general.ovirt – oVirt/RHEV platform management
community.general.ovirt – oVirt/RHEV platform management
Note
This plugin is part of the community.general collection (version 1.3.2).
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 theovirt.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 |
|
Define whether disk is thin or preallocated. |
disk_int string |
|
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.
|
instance_cpus string |
Default: 1 |
The instance's number of CPUs.
|
instance_disksize string |
Size of the instance's disk in GB.
| |
instance_dns string |
Define the instance's Primary DNS server.
| |
instance_domain string |
Define the instance's Domain.
| |
instance_gateway string |
Define the instance's Gateway.
| |
instance_hostname string |
Define the instance's Hostname.
| |
instance_ip string |
Define the instance's IP.
| |
instance_key string |
Define the instance's Authorized key.
| |
instance_mem string |
The instance's amount of memory in MB.
| |
instance_name string / required |
The name of the instance to use.
| |
instance_netmask string |
Define the instance's Netmask.
| |
instance_network string |
Default: "rhevm" |
The logical network the machine should belong to.
|
instance_nic string |
The name of the network interface in oVirt/RHEV.
| |
instance_os string |
Type of Operating System.
| |
instance_rootpw string |
Define the instance's Root password.
| |
instance_type string |
|
Define whether the instance is a server, desktop or high_performance. high_performance is supported since Ansible 2.5 and oVirt/RHV 4.2.
|
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 |
|
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 |
|
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)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/ovirt_module.html