ovirt.ovirt.ovirt_affinity_group – Module to manage affinity groups in oVirt/RHV¶
Note
This plugin is part of the ovirt.ovirt collection (version 1.3.0).
To install it use: ansible-galaxy collection install ovirt.ovirt
.
To use it in a playbook, specify: ovirt.ovirt.ovirt_affinity_group
.
New in version 1.0.0: of ovirt.ovirt
Synopsis¶
This module manage affinity groups in oVirt/RHV. It can also manage assignments of those groups to VMs.
Requirements¶
The below requirements are needed on the host that executes this module.
python >= 2.7
ovirt-engine-sdk-python >= 4.4.0
Parameters¶
Notes¶
Note
In order to use this module you have to install oVirt Python SDK. To ensure it’s installed with correct version you can create the following task: pip: name=ovirt-engine-sdk-python version=4.4.0
Examples¶
# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:
- name: Create(if not exists) and assign affinity group to VMs vm1 and vm2 and host host1
ovirt.ovirt.ovirt_affinity_group:
name: mygroup
cluster: mycluster
vm_enforcing: true
vm_rule: positive
host_enforcing: true
host_rule: positive
vms:
- vm1
- vm2
hosts:
- host1
- name: Detach VMs from affinity group and disable VM rule
ovirt.ovirt.ovirt_affinity_group:
name: mygroup
cluster: mycluster
vm_enforcing: false
vm_rule: disabled
host_enforcing: true
host_rule: positive
vms: []
hosts:
- host1
- host2
- name: Remove affinity group
ovirt.ovirt.ovirt_affinity_group:
state: absent
cluster: mycluster
name: mygroup
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Authors¶
Ondra Machacek (@machacekondra)
Martin Necas (@mnecas)