mirror of https://github.com/ansible/ansible.git
Add ovirt_clusters and ovirt_clusters_facts modules (#3138)
* Add ovirt_clusters and ovirt_clusters_facts modules * Add return values examples * Improve documentation * Added all cluster parameterspull/18777/head
Ondra Machacek
8 years ago
committed by
Matt Clay
parent
c385c6746a
commit
c12b705df8
@ -0,0 +1,560 @@
|
|||||||
|
#!/usr/bin/python
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
#
|
||||||
|
# Copyright (c) 2016 Red Hat, Inc.
|
||||||
|
#
|
||||||
|
# This file is part of Ansible
|
||||||
|
#
|
||||||
|
# Ansible is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# Ansible is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU General Public License
|
||||||
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
#
|
||||||
|
|
||||||
|
import traceback
|
||||||
|
|
||||||
|
try:
|
||||||
|
import ovirtsdk4.types as otypes
|
||||||
|
except ImportError:
|
||||||
|
pass
|
||||||
|
|
||||||
|
from ansible.module_utils.basic import AnsibleModule
|
||||||
|
from ansible.module_utils.ovirt import (
|
||||||
|
BaseModule,
|
||||||
|
check_sdk,
|
||||||
|
create_connection,
|
||||||
|
equal,
|
||||||
|
ovirt_full_argument_spec,
|
||||||
|
search_by_name,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
DOCUMENTATION = '''
|
||||||
|
---
|
||||||
|
module: ovirt_clusters
|
||||||
|
short_description: Module to manage clusters in oVirt
|
||||||
|
version_added: "2.3"
|
||||||
|
author: "Ondra Machacek (@machacekondra)"
|
||||||
|
description:
|
||||||
|
- "Module to manage clusters in oVirt"
|
||||||
|
options:
|
||||||
|
name:
|
||||||
|
description:
|
||||||
|
- "Name of the the cluster to manage."
|
||||||
|
required: true
|
||||||
|
state:
|
||||||
|
description:
|
||||||
|
- "Should the cluster be present or absent"
|
||||||
|
choices: ['present', 'absent']
|
||||||
|
default: present
|
||||||
|
datacenter:
|
||||||
|
description:
|
||||||
|
- "Datacenter name where cluster reside."
|
||||||
|
description:
|
||||||
|
description:
|
||||||
|
- "Description of the cluster."
|
||||||
|
comment:
|
||||||
|
description:
|
||||||
|
- "Comment of the cluster."
|
||||||
|
network:
|
||||||
|
description:
|
||||||
|
- "Management network of cluster to access cluster hosts."
|
||||||
|
ballooning:
|
||||||
|
description:
|
||||||
|
- "If (True) enable memory balloon optimization. Memory balloon is used to
|
||||||
|
re-distribute / reclaim the host memory based on VM needs
|
||||||
|
in a dynamic way."
|
||||||
|
virt:
|
||||||
|
description:
|
||||||
|
- "If (True), hosts in this cluster will be used to run virtual machines."
|
||||||
|
gluster:
|
||||||
|
description:
|
||||||
|
- "If (True), hosts in this cluster will be used as Gluster Storage
|
||||||
|
server nodes, and not for running virtual machines."
|
||||||
|
- "By default the cluster is created for virtual machine hosts."
|
||||||
|
threads_as_cores:
|
||||||
|
description:
|
||||||
|
- "If (True) the exposed host threads would be treated as cores
|
||||||
|
which can be utilized by virtual machines."
|
||||||
|
ksm:
|
||||||
|
description:
|
||||||
|
- "I (True) MoM enables to run Kernel Same-page Merging (KSM) when
|
||||||
|
necessary and when it can yield a memory saving benefit that
|
||||||
|
outweighs its CPU cost."
|
||||||
|
ksm_numa:
|
||||||
|
description:
|
||||||
|
- "If (True) enables KSM C(ksm) for best berformance inside NUMA nodes."
|
||||||
|
ha_reservation:
|
||||||
|
description:
|
||||||
|
- "If (True) enable the oVirt to monitor cluster capacity for highly
|
||||||
|
available virtual machines."
|
||||||
|
trusted_service:
|
||||||
|
description:
|
||||||
|
- "If (True) enable integration with an OpenAttestation server."
|
||||||
|
vm_reason:
|
||||||
|
description:
|
||||||
|
- "If (True) enable an optional reason field when a virtual machine
|
||||||
|
is shut down from the Manager, allowing the administrator to
|
||||||
|
provide an explanation for the maintenance."
|
||||||
|
host_reason:
|
||||||
|
description:
|
||||||
|
- "If (True) enable an optional reason field when a host is placed
|
||||||
|
into maintenance mode from the Manager, allowing the administrator
|
||||||
|
to provide an explanation for the maintenance."
|
||||||
|
memory_policy:
|
||||||
|
description:
|
||||||
|
- "I(disabled) - Disables memory page sharing."
|
||||||
|
- "I(server) - Sets the memory page sharing threshold to 150% of the system memory on each host."
|
||||||
|
- "I(desktop) - Sets the memory page sharing threshold to 200% of the system memory on each host."
|
||||||
|
choices: ['disabled', 'server', 'desktop']
|
||||||
|
rng_sources:
|
||||||
|
description:
|
||||||
|
- "List that specify the random number generator devices that all hosts in the cluster will use."
|
||||||
|
- "Supported generators are: I(hwrng) and I(random)."
|
||||||
|
spice_proxy:
|
||||||
|
description:
|
||||||
|
- "The proxy by which the SPICE client will connect to virtual machines."
|
||||||
|
- "The address must be in the following format: I(protocol://[host]:[port])"
|
||||||
|
fence_enabled:
|
||||||
|
description:
|
||||||
|
- "If (True) enables fencing on the cluster."
|
||||||
|
- "Fencing is enabled by default."
|
||||||
|
fence_skip_if_sd_active:
|
||||||
|
description:
|
||||||
|
- "If (True) any hosts in the cluster that are Non Responsive
|
||||||
|
and still connected to storage will not be fenced."
|
||||||
|
fence_skip_if_connectivity_broken:
|
||||||
|
description:
|
||||||
|
- "If (True) fencing will be temporarily disabled if the percentage
|
||||||
|
of hosts in the cluster that are experiencing connectivity issues
|
||||||
|
is greater than or equal to the defined threshold."
|
||||||
|
- "The threshold can be specified by C(fence_connectivity_threshold)."
|
||||||
|
fence_connectivity_threshold:
|
||||||
|
description:
|
||||||
|
- "The threshold used by C(fence_skip_if_connectivity_broken)."
|
||||||
|
resilience_policy:
|
||||||
|
description:
|
||||||
|
- "The resilience policy defines how the virtual machines are prioritized in the migration."
|
||||||
|
- "Following values are supported:"
|
||||||
|
- "C(do_not_migrate) - Prevents virtual machines from being migrated. "
|
||||||
|
- "C(migrate) - Migrates all virtual machines in order of their defined priority."
|
||||||
|
- "C(migrate_highly_available) - Migrates only highly available virtual machines to prevent overloading other hosts."
|
||||||
|
choices: ['do_not_migrate', 'migrate', 'migrate_highly_available']
|
||||||
|
migration_bandwidth:
|
||||||
|
description:
|
||||||
|
- "The bandwidth settings define the maximum bandwidth of both outgoing and incoming migrations per host."
|
||||||
|
- "Following bandwith options are supported:"
|
||||||
|
- "C(auto) - Bandwidth is copied from the I(rate limit) [Mbps] setting in the data center host network QoS."
|
||||||
|
- "C(hypervisor_default) - Bandwidth is controlled by local VDSM setting on sending host."
|
||||||
|
- "C(custom) - Defined by user (in Mbps)."
|
||||||
|
choices: ['auto', 'hypervisor_default', 'custom']
|
||||||
|
migration_bandwidth_limit:
|
||||||
|
description:
|
||||||
|
- "Set the I(custom) migration bandwidth limit."
|
||||||
|
- "This parameter is used only when C(migration_bandwidth) is I(custom)."
|
||||||
|
migration_auto_converge:
|
||||||
|
description:
|
||||||
|
- "If (True) auto-convergence is used during live migration of virtual machines."
|
||||||
|
- "Used only when C(migration_policy) is set to I(legacy)."
|
||||||
|
- "Following options are supported:"
|
||||||
|
- "C(true) - Override the global setting to I(true)."
|
||||||
|
- "C(false) - Override the global setting to I(false)."
|
||||||
|
- "C(inherit) - Use value which is set globally."
|
||||||
|
choices: ['true', 'false', 'inherit']
|
||||||
|
migration_compressed:
|
||||||
|
description:
|
||||||
|
- "If (True) compression is used during live migration of the virtual machine."
|
||||||
|
- "Used only when C(migration_policy) is set to I(legacy)."
|
||||||
|
- "Following options are supported:"
|
||||||
|
- "C(true) - Override the global setting to I(true)."
|
||||||
|
- "C(false) - Override the global setting to I(false)."
|
||||||
|
- "C(inherit) - Use value which is set globally."
|
||||||
|
choices: ['true', 'false', 'inherit']
|
||||||
|
migration_policy:
|
||||||
|
description:
|
||||||
|
- "A migration policy defines the conditions for live migrating
|
||||||
|
virtual machines in the event of host failure."
|
||||||
|
- "Following policies are supported:"
|
||||||
|
- "C(legacy) - Legacy behavior of 3.6 version."
|
||||||
|
- "C(minimal_downtime) - Virtual machines should not experience any significant downtime."
|
||||||
|
- "C(suspend_workload) - Virtual machines may experience a more significant downtime."
|
||||||
|
choices: ['legacy', 'minimal_downtime', 'suspend_workload']
|
||||||
|
serial_policy:
|
||||||
|
description:
|
||||||
|
- "Specify a serial number policy for the virtual machines in the cluster."
|
||||||
|
- "Following options are supported:"
|
||||||
|
- "C(vm) - Sets the virtual machine's UUID as its serial number."
|
||||||
|
- "C(host) - Sets the host's UUID as the virtual machine's serial number."
|
||||||
|
- "C(custom) - Allows you to specify a custom serial number in C(serial_policy_value)."
|
||||||
|
serial_policy_value:
|
||||||
|
description:
|
||||||
|
- "Allows you to specify a custom serial number."
|
||||||
|
- "This parameter is used only when C(serial_policy) is I(custom)."
|
||||||
|
scheduling_policy:
|
||||||
|
description:
|
||||||
|
- "Name of the scheduling policy to be used for cluster."
|
||||||
|
cpu_arch:
|
||||||
|
description:
|
||||||
|
- "CPU architecture of cluster."
|
||||||
|
choices: ['x86_64', 'ppc64', 'undefined']
|
||||||
|
cpu_type:
|
||||||
|
description:
|
||||||
|
- "CPU codename. For example I(Intel SandyBridge Family)."
|
||||||
|
switch_type:
|
||||||
|
description:
|
||||||
|
- "Type of switch to be used by all networks in given cluster.
|
||||||
|
Either I(legacy) which is using linux brigde or I(ovs) using
|
||||||
|
Open vSwitch."
|
||||||
|
choices: ['legacy', 'ovs']
|
||||||
|
compatibility_version:
|
||||||
|
description:
|
||||||
|
- "The compatibility version of the cluster. All hosts in this
|
||||||
|
cluster must support at least this compatibility version."
|
||||||
|
extends_documentation_fragment: ovirt
|
||||||
|
'''
|
||||||
|
|
||||||
|
EXAMPLES = '''
|
||||||
|
# Examples don't contain auth parameter for simplicity,
|
||||||
|
# look at ovirt_auth module to see how to reuse authentication:
|
||||||
|
|
||||||
|
# Create cluster
|
||||||
|
- ovirt_clusters:
|
||||||
|
datacenter: mydatacenter
|
||||||
|
name: mycluster
|
||||||
|
cpu_type: Intel SandyBridge Family
|
||||||
|
description: mycluster
|
||||||
|
compatibility_version: 4.0
|
||||||
|
|
||||||
|
# Create virt service cluster:
|
||||||
|
- ovirt_clusters:
|
||||||
|
datacenter: mydatacenter
|
||||||
|
name: mycluster
|
||||||
|
cpu_type: Intel Nehalem Family
|
||||||
|
description: mycluster
|
||||||
|
switch_type: legacy
|
||||||
|
compatibility_version: 4.0
|
||||||
|
ballooning: true
|
||||||
|
gluster: false
|
||||||
|
threads_as_cores: true
|
||||||
|
ha_reservation: true
|
||||||
|
trusted_service: false
|
||||||
|
host_reason: false
|
||||||
|
vm_reason: true
|
||||||
|
ksm_numa: true
|
||||||
|
memory_policy: server
|
||||||
|
rng_sources:
|
||||||
|
- hwrng
|
||||||
|
- random
|
||||||
|
|
||||||
|
# Remove cluster
|
||||||
|
- ovirt_clusters:
|
||||||
|
state: absent
|
||||||
|
name: mycluster
|
||||||
|
'''
|
||||||
|
|
||||||
|
RETURN = '''
|
||||||
|
id:
|
||||||
|
description: ID of the cluster which is managed
|
||||||
|
returned: On success if cluster is found.
|
||||||
|
type: str
|
||||||
|
sample: 7de90f31-222c-436c-a1ca-7e655bd5b60c
|
||||||
|
cluster:
|
||||||
|
description: "Dictionary of all the cluster attributes. Cluster attributes can be found on your oVirt instance
|
||||||
|
at following url: https://ovirt.example.com/ovirt-engine/api/model#types/cluster."
|
||||||
|
returned: On success if cluster is found.
|
||||||
|
'''
|
||||||
|
|
||||||
|
|
||||||
|
class ClustersModule(BaseModule):
|
||||||
|
|
||||||
|
def __get_major(self, full_version):
|
||||||
|
if full_version is None:
|
||||||
|
return None
|
||||||
|
if isinstance(full_version, otypes.Version):
|
||||||
|
return full_version.major
|
||||||
|
return int(full_version.split('.')[0])
|
||||||
|
|
||||||
|
def __get_minor(self, full_version):
|
||||||
|
if full_version is None:
|
||||||
|
return None
|
||||||
|
if isinstance(full_version, otypes.Version):
|
||||||
|
return full_version.minor
|
||||||
|
return int(full_version.split('.')[1])
|
||||||
|
|
||||||
|
def param(self, name, default=None):
|
||||||
|
return self._module.params.get(name, default)
|
||||||
|
|
||||||
|
def _get_memory_policy(self):
|
||||||
|
memory_policy = self.param('memory_policy')
|
||||||
|
if memory_policy == 'desktop':
|
||||||
|
return 200
|
||||||
|
elif memory_policy == 'server':
|
||||||
|
return 150
|
||||||
|
elif memory_policy == 'disabled':
|
||||||
|
return 100
|
||||||
|
|
||||||
|
def _get_policy_id(self):
|
||||||
|
# These are hardcoded IDs, once there is API, please fix this.
|
||||||
|
# legacy - 00000000-0000-0000-0000-000000000000
|
||||||
|
# minimal downtime - 80554327-0569-496b-bdeb-fcbbf52b827b
|
||||||
|
# suspend workload if needed - 80554327-0569-496b-bdeb-fcbbf52b827c
|
||||||
|
migration_policy = self.param('migration_policy')
|
||||||
|
if migration_policy == 'legacy':
|
||||||
|
return '00000000-0000-0000-0000-000000000000'
|
||||||
|
elif migration_policy == 'minimal_downtime':
|
||||||
|
return '80554327-0569-496b-bdeb-fcbbf52b827b'
|
||||||
|
elif migration_policy == 'suspend_workload':
|
||||||
|
return '80554327-0569-496b-bdeb-fcbbf52b827c'
|
||||||
|
|
||||||
|
def _get_sched_policy(self):
|
||||||
|
sched_policy = None
|
||||||
|
if self.param('serial_policy'):
|
||||||
|
sched_policies_service = self._connection.system_service().scheduling_policies_service()
|
||||||
|
sched_policy = search_by_name(sched_policies_service, self.param('scheduling_policy'))
|
||||||
|
if not sched_policy:
|
||||||
|
raise Exception("Scheduling policy '%s' was not found" % self.param('scheduling_policy'))
|
||||||
|
|
||||||
|
return sched_policy
|
||||||
|
|
||||||
|
def build_entity(self):
|
||||||
|
sched_policy = self._get_sched_policy()
|
||||||
|
return otypes.Cluster(
|
||||||
|
name=self.param('name'),
|
||||||
|
comment=self.param('comment'),
|
||||||
|
description=self.param('description'),
|
||||||
|
ballooning_enabled=self.param('ballooning'),
|
||||||
|
gluster_service=self.param('gluster'),
|
||||||
|
virt_service=self.param('virt'),
|
||||||
|
threads_as_cores=self.param('threads_as_cores'),
|
||||||
|
ha_reservation=self.param('ha_reservation'),
|
||||||
|
trusted_service=self.param('trusted_service'),
|
||||||
|
optional_reason=self.param('vm_reason'),
|
||||||
|
maintenance_reason_required=self.param('host_reason'),
|
||||||
|
scheduling_policy=otypes.SchedulingPolicy(
|
||||||
|
id=sched_policy.id,
|
||||||
|
) if sched_policy else None,
|
||||||
|
serial_number=otypes.SerialNumber(
|
||||||
|
policy=otypes.SerialNumberPolicy(self.param('serial_policy')),
|
||||||
|
value=self.param('serial_policy_value'),
|
||||||
|
) if (
|
||||||
|
self.param('serial_policy') is not None or
|
||||||
|
self.param('serial_policy_value') is not None
|
||||||
|
) else None,
|
||||||
|
migration=otypes.MigrationOptions(
|
||||||
|
auto_converge=otypes.InheritableBoolean(
|
||||||
|
self.param('migration_auto_converge'),
|
||||||
|
) if self.param('migration_auto_converge') else None,
|
||||||
|
bandwidth=otypes.MigrationBandwidth(
|
||||||
|
assignment_method=otypes.MigrationBandwidthAssignmentMethod(
|
||||||
|
self.param('migration_bandwidth'),
|
||||||
|
) if self.param('migration_bandwidth') else None,
|
||||||
|
custom_value=self.param('migration_bandwidth_limit'),
|
||||||
|
) if (
|
||||||
|
self.param('migration_bandwidth') or
|
||||||
|
self.param('migration_bandwidth_limit')
|
||||||
|
) else None,
|
||||||
|
compressed=otypes.InheritableBoolean(
|
||||||
|
self.param('migration_compressed'),
|
||||||
|
) if self.param('migration_compressed') else None,
|
||||||
|
policy=otypes.MigrationPolicy(
|
||||||
|
id=self._get_policy_id()
|
||||||
|
) if self.param('migration_policy') else None,
|
||||||
|
) if (
|
||||||
|
self.param('migration_bandwidth') is not None or
|
||||||
|
self.param('migration_bandwidth_limit') is not None or
|
||||||
|
self.param('migration_auto_converge') is not None or
|
||||||
|
self.param('migration_compressed') is not None or
|
||||||
|
self.param('migration_policy') is not None
|
||||||
|
) else None,
|
||||||
|
error_handling=otypes.ErrorHandling(
|
||||||
|
on_error=otypes.MigrateOnError(
|
||||||
|
self.param('resilience_policy')
|
||||||
|
),
|
||||||
|
) if self.param('resilience_policy') else None,
|
||||||
|
fencing_policy=otypes.FencingPolicy(
|
||||||
|
enabled=(
|
||||||
|
self.param('fence_enabled') or
|
||||||
|
self.param('fence_skip_if_connectivity_broken') or
|
||||||
|
self.param('fence_skip_if_sd_active')
|
||||||
|
),
|
||||||
|
skip_if_connectivity_broken=otypes.SkipIfConnectivityBroken(
|
||||||
|
enabled=self.param('fence_skip_if_connectivity_broken'),
|
||||||
|
threshold=self.param('fence_connectivity_threshold'),
|
||||||
|
) if (
|
||||||
|
self.param('fence_skip_if_connectivity_broken') is not None or
|
||||||
|
self.param('fence_connectivity_threshold') is not None
|
||||||
|
) else None,
|
||||||
|
skip_if_sd_active=otypes.SkipIfSdActive(
|
||||||
|
enabled=self.param('fence_skip_if_sd_active'),
|
||||||
|
) if self.param('fence_skip_if_sd_active') else None,
|
||||||
|
) if (
|
||||||
|
self.param('fence_enabled') is not None or
|
||||||
|
self.param('fence_skip_if_sd_active') is not None or
|
||||||
|
self.param('fence_skip_if_connectivity_broken') is not None or
|
||||||
|
self.param('fence_connectivity_threshold') is not None
|
||||||
|
) else None,
|
||||||
|
display=otypes.Display(
|
||||||
|
proxy=self.param('spice_proxy'),
|
||||||
|
) if self.param('spice_proxy') else None,
|
||||||
|
required_rng_sources=[
|
||||||
|
otypes.RngSource(rng) for rng in self.param('rng_sources')
|
||||||
|
] if self.param('rng_sources') else None,
|
||||||
|
memory_policy=otypes.MemoryPolicy(
|
||||||
|
over_commit=otypes.MemoryOverCommit(
|
||||||
|
percent=self._get_memory_policy(),
|
||||||
|
),
|
||||||
|
) if self.param('memory_policy') else None,
|
||||||
|
ksm=otypes.Ksm(
|
||||||
|
enabled=self.param('ksm') or self.param('ksm_numa'),
|
||||||
|
merge_across_nodes=not self.param('ksm_numa'),
|
||||||
|
) if (
|
||||||
|
self.param('ksm_numa') is not None or
|
||||||
|
self.param('ksm') is not None
|
||||||
|
) else None,
|
||||||
|
data_center=otypes.DataCenter(
|
||||||
|
name=self.param('datacenter'),
|
||||||
|
) if self.param('datacenter') else None,
|
||||||
|
management_network=otypes.Network(
|
||||||
|
name=self.param('network'),
|
||||||
|
) if self.param('network') else None,
|
||||||
|
cpu=otypes.Cpu(
|
||||||
|
architecture=self.param('cpu_arch'),
|
||||||
|
type=self.param('cpu_type'),
|
||||||
|
) if (
|
||||||
|
self.param('cpu_arch') or self.param('cpu_type')
|
||||||
|
) else None,
|
||||||
|
version=otypes.Version(
|
||||||
|
major=self.__get_major(self.param('compatibility_version')),
|
||||||
|
minor=self.__get_minor(self.param('compatibility_version')),
|
||||||
|
) if self.param('compatibility_version') else None,
|
||||||
|
switch_type=otypes.SwitchType(
|
||||||
|
self.param('switch_type')
|
||||||
|
) if self.param('switch_type') else None,
|
||||||
|
)
|
||||||
|
|
||||||
|
def update_check(self, entity):
|
||||||
|
return (
|
||||||
|
equal(self.param('comment'), entity.comment) and
|
||||||
|
equal(self.param('description'), entity.description) and
|
||||||
|
equal(self.param('switch_type'), str(entity.switch_type)) and
|
||||||
|
equal(self.param('cpu_arch'), str(entity.cpu.architecture)) and
|
||||||
|
equal(self.param('cpu_type'), entity.cpu.type) and
|
||||||
|
equal(self.param('ballooning'), entity.ballooning_enabled) and
|
||||||
|
equal(self.param('gluster'), entity.gluster_service) and
|
||||||
|
equal(self.param('virt'), entity.virt_service) and
|
||||||
|
equal(self.param('threads_as_cores'), entity.threads_as_cores) and
|
||||||
|
equal(self.param('ksm_numa'), not entity.ksm.merge_across_nodes and entity.ksm.enabled) and
|
||||||
|
equal(self.param('ksm'), entity.ksm.merge_across_nodes and entity.ksm.enabled) and
|
||||||
|
equal(self.param('ha_reservation'), entity.ha_reservation) and
|
||||||
|
equal(self.param('trusted_service'), entity.trusted_service) and
|
||||||
|
equal(self.param('host_reason'), entity.maintenance_reason_required) and
|
||||||
|
equal(self.param('vm_reason'), entity.optional_reason) and
|
||||||
|
equal(self.param('spice_proxy'), getattr(entity.display, 'proxy', None)) and
|
||||||
|
equal(self.param('fence_enabled'), entity.fencing_policy.enabled) and
|
||||||
|
equal(self.param('fence_skip_if_sd_active'), entity.fencing_policy.skip_if_sd_active.enabled) and
|
||||||
|
equal(self.param('fence_skip_if_connectivity_broken'), entity.fencing_policy.skip_if_connectivity_broken.enabled) and
|
||||||
|
equal(self.param('fence_connectivity_threshold'), entity.fencing_policy.skip_if_connectivity_broken.threshold) and
|
||||||
|
equal(self.param('resilience_policy'), str(entity.error_handling.on_error)) and
|
||||||
|
equal(self.param('migration_bandwidth'), str(entity.migration.bandwidth.assignment_method)) and
|
||||||
|
equal(self.param('migration_auto_converge'), str(entity.migration.auto_converge)) and
|
||||||
|
equal(self.param('migration_compressed'), str(entity.migration.compressed)) and
|
||||||
|
equal(self.param('serial_policy'), str(entity.serial_number.policy)) and
|
||||||
|
equal(self.param('serial_policy_value'), entity.serial_number.value) and
|
||||||
|
equal(self.param('scheduling_policy'), self._get_sched_policy().name) and
|
||||||
|
equal(self._get_policy_id(), entity.migration.policy.id) and
|
||||||
|
equal(self._get_memory_policy(), entity.memory_policy.over_commit.percent) and
|
||||||
|
equal(self.__get_minor(self.param('compatibility_version')), self.__get_minor(entity.version)) and
|
||||||
|
equal(self.__get_major(self.param('compatibility_version')), self.__get_major(entity.version)) and
|
||||||
|
equal(
|
||||||
|
self.param('migration_bandwidth_limit') if self.param('migration_bandwidth') == 'custom' else None,
|
||||||
|
entity.migration.bandwidth.custom_value
|
||||||
|
) and
|
||||||
|
equal(
|
||||||
|
sorted(self.param('rng_sources')) if self.param('rng_sources') else None,
|
||||||
|
sorted([
|
||||||
|
str(source) for source in entity.required_rng_sources
|
||||||
|
])
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
argument_spec = ovirt_full_argument_spec(
|
||||||
|
state=dict(
|
||||||
|
choices=['present', 'absent'],
|
||||||
|
default='present',
|
||||||
|
),
|
||||||
|
name=dict(default=None, required=True),
|
||||||
|
ballooning=dict(default=None, type='bool', aliases=['balloon']),
|
||||||
|
gluster=dict(default=None, type='bool'),
|
||||||
|
virt=dict(default=None, type='bool'),
|
||||||
|
threads_as_cores=dict(default=None, type='bool'),
|
||||||
|
ksm_numa=dict(default=None, type='bool'),
|
||||||
|
ksm=dict(default=None, type='bool'),
|
||||||
|
ha_reservation=dict(default=None, type='bool'),
|
||||||
|
trusted_service=dict(default=None, type='bool'),
|
||||||
|
vm_reason=dict(default=None, type='bool'),
|
||||||
|
host_reason=dict(default=None, type='bool'),
|
||||||
|
memory_policy=dict(default=None, choices=['disabled', 'server', 'desktop']),
|
||||||
|
rng_sources=dict(default=None, type='list'),
|
||||||
|
spice_proxy=dict(default=None),
|
||||||
|
fence_enabled=dict(default=None, type='bool'),
|
||||||
|
fence_skip_if_sd_active=dict(default=None, type='bool'),
|
||||||
|
fence_skip_if_connectivity_broken=dict(default=None, type='bool'),
|
||||||
|
fence_connectivity_threshold=dict(default=None, type='int'),
|
||||||
|
resilience_policy=dict(default=None, choices=['migrate_highly_available', 'migrate', 'do_not_migrate']),
|
||||||
|
migration_bandwidth=dict(default=None, choices=['auto', 'hypervisor_default', 'custom']),
|
||||||
|
migration_bandwidth_limit=dict(default=None, type='int'),
|
||||||
|
migration_auto_converge=dict(default=None, choices=['true', 'false', 'inherit']),
|
||||||
|
migration_compressed=dict(default=None, choices=['true', 'false', 'inherit']),
|
||||||
|
migration_policy=dict(default=None, choices=['legacy', 'minimal_downtime', 'suspend_workload']),
|
||||||
|
serial_policy=dict(default=None, choices=['vm', 'host', 'custom']),
|
||||||
|
serial_policy_value=dict(default=None),
|
||||||
|
scheduling_policy=dict(default=None),
|
||||||
|
datacenter=dict(default=None),
|
||||||
|
description=dict(default=None),
|
||||||
|
comment=dict(default=None),
|
||||||
|
network=dict(default=None),
|
||||||
|
cpu_arch=dict(default=None, choices=['ppc64', 'undefined', 'x86_64']),
|
||||||
|
cpu_type=dict(default=None),
|
||||||
|
switch_type=dict(default=None, choices=['legacy', 'ovs']),
|
||||||
|
compatibility_version=dict(default=None),
|
||||||
|
)
|
||||||
|
module = AnsibleModule(
|
||||||
|
argument_spec=argument_spec,
|
||||||
|
supports_check_mode=True,
|
||||||
|
)
|
||||||
|
check_sdk(module)
|
||||||
|
|
||||||
|
try:
|
||||||
|
connection = create_connection(module.params.pop('auth'))
|
||||||
|
clusters_service = connection.system_service().clusters_service()
|
||||||
|
clusters_module = ClustersModule(
|
||||||
|
connection=connection,
|
||||||
|
module=module,
|
||||||
|
service=clusters_service,
|
||||||
|
)
|
||||||
|
|
||||||
|
state = module.params['state']
|
||||||
|
if state == 'present':
|
||||||
|
ret = clusters_module.create()
|
||||||
|
elif state == 'absent':
|
||||||
|
ret = clusters_module.remove()
|
||||||
|
|
||||||
|
module.exit_json(**ret)
|
||||||
|
except Exception as e:
|
||||||
|
module.fail_json(msg=str(e), exception=traceback.format_exc())
|
||||||
|
finally:
|
||||||
|
connection.close(logout=False)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
main()
|
||||||
@ -0,0 +1,99 @@
|
|||||||
|
#!/usr/bin/python
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
#
|
||||||
|
# Copyright (c) 2016 Red Hat, Inc.
|
||||||
|
#
|
||||||
|
# This file is part of Ansible
|
||||||
|
#
|
||||||
|
# Ansible is free software: you can redistribute it and/or modify
|
||||||
|
# it under the terms of the GNU General Public License as published by
|
||||||
|
# the Free Software Foundation, either version 3 of the License, or
|
||||||
|
# (at your option) any later version.
|
||||||
|
#
|
||||||
|
# Ansible is distributed in the hope that it will be useful,
|
||||||
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
# GNU General Public License for more details.
|
||||||
|
#
|
||||||
|
# You should have received a copy of the GNU General Public License
|
||||||
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
#
|
||||||
|
|
||||||
|
import traceback
|
||||||
|
|
||||||
|
from ansible.module_utils.basic import AnsibleModule
|
||||||
|
from ansible.module_utils.ovirt import (
|
||||||
|
check_sdk,
|
||||||
|
create_connection,
|
||||||
|
get_dict_of_struct,
|
||||||
|
ovirt_full_argument_spec,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
DOCUMENTATION = '''
|
||||||
|
---
|
||||||
|
module: ovirt_clusters_facts
|
||||||
|
short_description: Retrieve facts about one or more oVirt clusters
|
||||||
|
author: "Ondra Machacek (@machacekondra)"
|
||||||
|
version_added: "2.3"
|
||||||
|
description:
|
||||||
|
- "Retrieve facts about one or more oVirt clusters."
|
||||||
|
notes:
|
||||||
|
- "This module creates a new top-level C(ovirt_clusters) fact, which
|
||||||
|
contains a list of clusters."
|
||||||
|
options:
|
||||||
|
pattern:
|
||||||
|
description:
|
||||||
|
- "Search term which is accepted by oVirt search backend."
|
||||||
|
- "For example to search cluster X from datacenter Y use following pattern:
|
||||||
|
name=X and datacenter=Y"
|
||||||
|
extends_documentation_fragment: ovirt
|
||||||
|
'''
|
||||||
|
|
||||||
|
EXAMPLES = '''
|
||||||
|
# Examples don't contain auth parameter for simplicity,
|
||||||
|
# look at ovirt_auth module to see how to reuse authentication:
|
||||||
|
|
||||||
|
# Gather facts about all clusters which names start with C<production>:
|
||||||
|
- ovirt_clusters_facts:
|
||||||
|
pattern: name=production*
|
||||||
|
- debug:
|
||||||
|
var: ovirt_clusters
|
||||||
|
'''
|
||||||
|
|
||||||
|
RETURN = '''
|
||||||
|
ovirt_clusters:
|
||||||
|
description: "List of dictionaries describing the clusters. Cluster attribues are mapped to dictionary keys,
|
||||||
|
all clusters attributes can be found at following url: https://ovirt.example.com/ovirt-engine/api/model#types/cluster."
|
||||||
|
returned: On success.
|
||||||
|
type: list
|
||||||
|
'''
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
argument_spec = ovirt_full_argument_spec(
|
||||||
|
pattern=dict(default='', required=False),
|
||||||
|
)
|
||||||
|
module = AnsibleModule(argument_spec)
|
||||||
|
check_sdk(module)
|
||||||
|
|
||||||
|
try:
|
||||||
|
connection = create_connection(module.params.pop('auth'))
|
||||||
|
clusters_service = connection.system_service().clusters_service()
|
||||||
|
clusters = clusters_service.list(search=module.params['pattern'])
|
||||||
|
module.exit_json(
|
||||||
|
changed=False,
|
||||||
|
ansible_facts=dict(
|
||||||
|
ovirt_clusters=[
|
||||||
|
get_dict_of_struct(c) for c in clusters
|
||||||
|
],
|
||||||
|
),
|
||||||
|
)
|
||||||
|
except Exception as e:
|
||||||
|
module.fail_json(msg=str(e), exception=traceback.format_exc())
|
||||||
|
finally:
|
||||||
|
connection.close(logout=False)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
main()
|
||||||
Loading…
Reference in New Issue