VMware: Fix module vmware_host (#46225)

* Add folder_name alias

The parameter should be named folder_name instead of folder to be
consistent with the other parameters cluster_name and datacenter_name.

* Fix 'A specified parameter was not correct: cnxSpec' error

The play fails when re-connecting a host with the cnxSpec argument
defined.

Just remove the cnxSpec argument definition. It isn't necessary when
re-connecting an existing host in vCenter (6.5).

* Fix ESXi host add/remove/re-connect errors

An ESXi host cannot be added, removed, or re-connected under a folder.

ESXi hosts connected under a folder, instead of a cluster, have an
object type of ComputeResource instead of HostSystem and the HostSystem
object is the first entry in the host parameter list of the
ComputeResource object.

Separate between cluster and folder actions.
This commit is contained in:
Christian Kotte 2019-02-25 09:38:33 +01:00 committed by Abhijeet Kasurde
parent e18d5ea8b3
commit 2f44ac4edc
2 changed files with 661 additions and 141 deletions

View file

@ -3,6 +3,7 @@
# Copyright: (c) 2015, Joseph Callen <jcallen () csc.com>
# Copyright: (c) 2017, Ansible Project
# Copyright: (c) 2018, Christian Kotte <christian.kotte@gmx.de>
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
from __future__ import absolute_import, division, print_function
@ -17,19 +18,24 @@ ANSIBLE_METADATA = {
DOCUMENTATION = r'''
---
module: vmware_host
short_description: Add / Remove ESXi host to / from vCenter
short_description: Add, remove, or move an ESXi host to, from, or within vCenter
description:
- This module can be used to add / remove / reconnect an ESXi host to / from vCenter.
- This module can be used to add, reconnect, or remove an ESXi host to or from vCenter.
- This module can also be used to move an ESXi host to a cluster or folder, or vice versa, within the same datacenter.
version_added: '2.0'
author:
- Joseph Callen (@jcpowermac)
- Russell Teague (@mtnbikenc)
- Maxime de Roucy (@tchernomax)
- Christian Kotte (@ckotte)
notes:
- Tested on vSphere 5.5, 6.0 and 6.5
- Tested on vSphere 5.5, 6.0, 6.5 and 6.7
requirements:
- python >= 2.6
- PyVmomi
- ssl
- socket
- hashlib
options:
datacenter_name:
description:
@ -37,12 +43,14 @@ options:
- Aliases added in version 2.6.
required: yes
aliases: ['datacenter']
type: str
cluster_name:
description:
- Name of the cluster to add the host.
- If C(folder) is not set, then this parameter is required.
- Aliases added in version 2.6.
aliases: ['cluster']
type: str
folder:
description:
- Name of the folder under which host to add.
@ -55,24 +63,28 @@ options:
- " - '/Site2/dc2/Asia-Cluster/host'"
- " - '/dc3/Asia-Cluster/host'"
version_added: "2.6"
aliases: ['folder_name']
type: str
add_connected:
description:
- If set to C(True), then the host should be connected as soon as it is added.
- This parameter is ignored if state is set to a value other than C(present).
default: True
type: 'bool'
type: bool
version_added: "2.6"
esxi_hostname:
description:
- ESXi hostname to manage.
required: yes
type: str
esxi_username:
description:
- ESXi username.
- Required for adding a host.
- Optional for reconnect.
- Optional for reconnect. If both C(esxi_username) and C(esxi_password) are used
- Unused for removing.
- No longer a required parameter from version 2.5.
type: str
esxi_password:
description:
- ESXi password.
@ -80,23 +92,53 @@ options:
- Optional for reconnect.
- Unused for removing.
- No longer a required parameter from version 2.5.
type: str
state:
description:
- If set to C(present), then add the host if host is absent.
- If set to C(present), then do nothing if host already exists.
- If set to C(absent), then remove the host if host is present.
- If set to C(absent), then do nothing if host already does not exists.
- If set to C(add_or_reconnect), then add the host if it's absent else reconnect it.
- If set to C(reconnect), then reconnect the host if it's present else fail.
- If set to C(present), add the host if host is absent.
- If set to C(present), update the location of the host if host already exists.
- If set to C(absent), remove the host if host is present.
- If set to C(absent), do nothing if host already does not exists.
- If set to C(add_or_reconnect), add the host if it's absent else reconnect it and update the location.
- If set to C(reconnect), then reconnect the host if it's present and update the location.
default: present
choices: ['present', 'absent', 'add_or_reconnect', 'reconnect']
type: str
esxi_ssl_thumbprint:
description:
- "Specifying the hostsystem certificate's thumbprint."
- "Use following command to get hostsystem certificate's thumbprint - "
- "# openssl x509 -in /etc/vmware/ssl/rui.crt -fingerprint -sha1 -noout"
- Only used if C(fetch_thumbprint) isn't set to C(true).
version_added: 2.5
default: ''
type: str
aliases: ['ssl_thumbprint']
fetch_ssl_thumbprint:
description:
- Fetch the thumbprint of the host's SSL certificate.
- This basically disables the host certificate verification (check if it was signed by a recognized CA).
- Disable this option if you want to allow only hosts with valid certificates to be added to vCenter.
- If this option is set to C(false) and the certificate can't be verified, an add or reconnect will fail.
- Unused when C(esxi_ssl_thumbprint) is set.
- Optional for reconnect, but only used if C(esxi_username) and C(esxi_password) are used.
- Unused for removing.
type: bool
version_added: 2.8
default: True
force_connection:
description:
- Force the connection if the host is already being managed by another vCenter server.
type: bool
version_added: 2.8
default: True
reconnect_disconnected:
description:
- Reconnect disconnected hosts.
- This is only used if C(state) is set to C(present) and if the host already exists.
type: bool
version_added: 2.8
default: True
extends_documentation_fragment: vmware.documentation
'''
@ -106,8 +148,8 @@ EXAMPLES = r'''
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
datacenter: datacenter_name
cluster: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
@ -119,7 +161,7 @@ EXAMPLES = r'''
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
datacenter: datacenter_name
folder: '/Site2/Asia-Cluster/host'
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
@ -133,8 +175,8 @@ EXAMPLES = r'''
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
datacenter: datacenter_name
cluster: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
@ -146,8 +188,8 @@ EXAMPLES = r'''
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
datacenter: datacenter_name
cluster: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
state: reconnect
delegate_to: localhost
@ -157,8 +199,8 @@ EXAMPLES = r'''
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
datacenter: datacenter_name
cluster: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
@ -172,23 +214,30 @@ result:
description: metadata about the new host system added
returned: on successful addition
type: str
sample: "'vim.ComputeResource:domain-s222'"
sample: "Host already connected to vCenter 'vcenter01' in cluster 'cluster01'"
'''
try:
from pyVmomi import vim, vmodl
import ssl
import socket
import hashlib
except ImportError:
pass
from ansible.module_utils.basic import AnsibleModule
from ansible.module_utils._text import to_native
from ansible.module_utils.vmware import (PyVmomi, TaskError, vmware_argument_spec,
wait_for_task, find_host_by_cluster_datacenter)
from ansible.module_utils.vmware import (
PyVmomi, TaskError, vmware_argument_spec,
wait_for_task, find_host_by_cluster_datacenter, find_hostsystem_by_name
)
class VMwareHost(PyVmomi):
"""Class to manage vCenter connection"""
def __init__(self, module):
super(VMwareHost, self).__init__(module)
self.vcenter = module.params['hostname']
self.datacenter_name = module.params['datacenter_name']
self.cluster_name = module.params['cluster_name']
self.folder_name = module.params['folder']
@ -197,25 +246,32 @@ class VMwareHost(PyVmomi):
self.esxi_password = module.params['esxi_password']
self.state = module.params['state']
self.esxi_ssl_thumbprint = module.params.get('esxi_ssl_thumbprint', '')
self.cluster = self.folder = self.host = None
self.force_connection = module.params.get('force_connection')
self.fetch_ssl_thumbprint = module.params.get('fetch_ssl_thumbprint')
self.reconnect_disconnected = module.params.get('reconnect_disconnected')
self.host_update = self.host = self.cluster = self.folder = self.host_parent_compute_resource = None
def process_state(self):
# Currently state_update_host is not implemented.
"""Check the current state"""
host_states = {
'absent': {
'present': self.state_remove_host,
'update': self.state_remove_host,
'absent': self.state_exit_unchanged,
},
'present': {
'present': self.state_exit_unchanged,
'update': self.state_update_host,
'absent': self.state_add_host,
},
'add_or_reconnect': {
'present': self.state_reconnect_host,
'update': self.state_update_host,
'absent': self.state_add_host,
},
'reconnect': {
'present': self.state_reconnect_host,
'update': self.state_update_host,
}
}
@ -228,156 +284,508 @@ class VMwareHost(PyVmomi):
except Exception as e:
self.module.fail_json(msg=to_native(e))
def check_host_state(self):
"""Check current state"""
# Check if the host is already connected to vCenter
self.host_update = find_hostsystem_by_name(self.content, self.esxi_hostname)
if self.host_update:
# The host name is unique in vCenter; A host with the same name cannot exist in another datacenter
# However, the module will fail later if the target folder/cluster is in another datacenter as the host
# Check if the host is connected under the target cluster
if self.cluster_name:
self.host, self.cluster = self.search_cluster(self.datacenter_name, self.cluster_name, self.esxi_hostname)
if self.host:
state = 'present'
else:
state = 'update'
# Check if the host is connected under the target folder
elif self.folder_name:
self.folder = self.search_folder(self.folder_name)
for child in self.folder.childEntity:
if not child or not isinstance(child, vim.ComputeResource):
continue
try:
if isinstance(child.host[0], vim.HostSystem) and child.name == self.esxi_hostname:
self.host_parent_compute_resource = child
self.host = child.host[0]
break
except IndexError:
continue
if self.host:
state = 'present'
else:
state = 'update'
else:
state = 'absent'
return state
def search_folder(self, folder_name):
"""
Search folder in vCenter
Returns: folder object
"""
search_index = self.content.searchIndex
folder_obj = search_index.FindByInventoryPath(folder_name)
if not (folder_obj and isinstance(folder_obj, vim.Folder)):
self.module.fail_json(msg="Folder '%s' not found" % folder_name)
return folder_obj
def search_cluster(self, datacenter_name, cluster_name, esxi_hostname):
"""
Search cluster in vCenter
Returns: host and cluster object
"""
return find_host_by_cluster_datacenter(
self.module, self.content, datacenter_name, cluster_name, esxi_hostname
)
def state_exit_unchanged(self):
"""Exit with status message"""
if self.reconnect_disconnected and self.host_update.runtime.connectionState == 'disconnected':
self.state_reconnect_host()
else:
if self.folder_name:
result = "Host already connected to vCenter '%s' in folder '%s'" % (self.vcenter, self.folder_name)
elif self.cluster_name:
result = "Host already connected to vCenter '%s' in cluster '%s'" % (self.vcenter, self.cluster_name)
self.module.exit_json(changed=False, result=str(result))
def state_add_host(self):
"""Add ESXi host to a cluster of folder in vCenter"""
changed = True
result = None
if self.module.check_mode:
result = "Host would be connected to vCenter '%s'" % self.vcenter
else:
host_connect_spec = self.get_host_connect_spec()
as_connected = self.params.get('add_connected')
esxi_license = None
resource_pool = None
task = None
if self.folder_name:
self.folder = self.search_folder(self.folder_name)
try:
task = self.folder.AddStandaloneHost(
spec=host_connect_spec, compResSpec=resource_pool,
addConnected=as_connected, license=esxi_license
)
except vim.fault.InvalidLogin as invalid_login:
self.module.fail_json(
msg="Cannot authenticate with the host : %s" % to_native(invalid_login)
)
except vim.fault.HostConnectFault as connect_fault:
self.module.fail_json(
msg="An error occurred during connect : %s" % to_native(connect_fault)
)
except vim.fault.DuplicateName as duplicate_name:
self.module.fail_json(
msg="The folder already contains a host with the same name : %s" %
to_native(duplicate_name)
)
except vmodl.fault.InvalidArgument as invalid_argument:
self.module.fail_json(
msg="An argument was specified incorrectly : %s" % to_native(invalid_argument)
)
except vim.fault.AlreadyBeingManaged as already_managed:
self.module.fail_json(
msg="The host is already being managed by another vCenter server : %s" %
to_native(already_managed)
)
except vmodl.fault.NotEnoughLicenses as not_enough_licenses:
self.module.fail_json(
msg="There are not enough licenses to add this host : %s" % to_native(not_enough_licenses)
)
except vim.fault.NoHost as no_host:
self.module.fail_json(
msg="Unable to contact the host : %s" % to_native(no_host)
)
except vmodl.fault.NotSupported as not_supported:
self.module.fail_json(
msg="The folder is not a host folder : %s" % to_native(not_supported)
)
except vim.fault.NotSupportedHost as host_not_supported:
self.module.fail_json(
msg="The host is running a software version that is not supported : %s" %
to_native(host_not_supported)
)
except vim.fault.AgentInstallFailed as agent_install:
self.module.fail_json(
msg="Error during vCenter agent installation : %s" % to_native(agent_install)
)
except vim.fault.AlreadyConnected as already_connected:
self.module.fail_json(
msg="The host is already connected to the vCenter server : %s" % to_native(already_connected)
)
except vim.fault.SSLVerifyFault as ssl_fault:
self.module.fail_json(
msg="The host certificate could not be authenticated : %s" % to_native(ssl_fault)
)
elif self.cluster_name:
self.host, self.cluster = self.search_cluster(
self.datacenter_name,
self.cluster_name,
self.esxi_hostname
)
try:
task = self.cluster.AddHost_Task(
spec=host_connect_spec, asConnected=as_connected,
resourcePool=resource_pool, license=esxi_license
)
except vim.fault.InvalidLogin as invalid_login:
self.module.fail_json(
msg="Cannot authenticate with the host : %s" % to_native(invalid_login)
)
except vim.fault.HostConnectFault as connect_fault:
self.module.fail_json(
msg="An error occurred during connect : %s" % to_native(connect_fault)
)
except vim.fault.DuplicateName as duplicate_name:
self.module.fail_json(
msg="The cluster already contains a host with the same name : %s" %
to_native(duplicate_name)
)
except vim.fault.AlreadyBeingManaged as already_managed:
self.module.fail_json(
msg="The host is already being managed by another vCenter server : %s" %
to_native(already_managed)
)
except vmodl.fault.NotEnoughLicenses as not_enough_licenses:
self.module.fail_json(
msg="There are not enough licenses to add this host : %s" % to_native(not_enough_licenses)
)
except vim.fault.NoHost as no_host:
self.module.fail_json(
msg="Unable to contact the host : %s" % to_native(no_host)
)
except vim.fault.NotSupportedHost as host_not_supported:
self.module.fail_json(
msg="The host is running a software version that is not supported; "
"It may still be possible to add the host as a stand-alone host : %s" %
to_native(host_not_supported)
)
except vim.fault.TooManyHosts as too_many_hosts:
self.module.fail_json(
msg="No additional hosts can be added to the cluster : %s" % to_native(too_many_hosts)
)
except vim.fault.AgentInstallFailed as agent_install:
self.module.fail_json(
msg="Error during vCenter agent installation : %s" % to_native(agent_install)
)
except vim.fault.AlreadyConnected as already_connected:
self.module.fail_json(
msg="The host is already connected to the vCenter server : %s" % to_native(already_connected)
)
except vim.fault.SSLVerifyFault as ssl_fault:
self.module.fail_json(
msg="The host certificate could not be authenticated : %s" % to_native(ssl_fault)
)
try:
changed, result = wait_for_task(task)
result = "Host connected to vCenter '%s'" % self.vcenter
except TaskError as task_error:
self.module.fail_json(
msg="Failed to add host to vCenter '%s' : %s" % (self.vcenter, to_native(task_error))
)
self.module.exit_json(changed=changed, result=result)
def get_host_connect_spec(self):
"""
Function to return Host connection specification
Returns: host connection specification
"""
host_connect_spec = vim.host.ConnectSpec()
host_connect_spec.hostName = self.esxi_hostname
host_connect_spec.userName = self.esxi_username
host_connect_spec.password = self.esxi_password
host_connect_spec.force = True
host_connect_spec.sslThumbprint = self.esxi_ssl_thumbprint
host_connect_spec.force = self.force_connection
# Get the thumbprint of the SSL certificate
if self.fetch_ssl_thumbprint and self.esxi_ssl_thumbprint == '':
# We need to grab the thumbprint manually because it's not included in
# the task error via an SSLVerifyFault exception anymore
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.settimeout(1)
wrapped_socket = ssl.wrap_socket(sock)
try:
wrapped_socket.connect((self.esxi_hostname, 443))
except socket.error as socket_error:
self.module.fail_json(msg="Cannot connect to host : %s" % socket_error)
else:
der_cert_bin = wrapped_socket.getpeercert(True)
# thumb_md5 = hashlib.md5(der_cert_bin).hexdigest()
thumb_sha1 = self.format_number(hashlib.sha1(der_cert_bin).hexdigest())
# thumb_sha256 = hashlib.sha256(der_cert_bin).hexdigest()
wrapped_socket.close()
host_connect_spec.sslThumbprint = thumb_sha1
else:
host_connect_spec.sslThumbprint = self.esxi_ssl_thumbprint
return host_connect_spec
def add_host_to_vcenter(self):
host_connect_spec = self.get_host_connect_spec()
as_connected = self.params.get('add_connected')
esxi_license = None
resource_pool = None
@staticmethod
def format_number(number):
"""Format number"""
string = str(number)
return ':'.join(a + b for a, b in zip(string[::2], string[1::2]))
for count in range(0, 2):
try:
task = None
if self.folder:
task = self.folder.AddStandaloneHost(spec=host_connect_spec, addConnected=as_connected)
elif self.cluster:
task = self.cluster.AddHost_Task(host_connect_spec, as_connected, resource_pool, esxi_license)
success, result = wait_for_task(task)
return success, result
except TaskError as task_error_exception:
task_error = task_error_exception.args[0]
if len(task_error_exception.args) == 2:
host_thumbprint = task_error_exception.args[1]
else:
host_thumbprint = None
if self.esxi_ssl_thumbprint == '' and host_thumbprint:
# User has not specified SSL Thumbprint for ESXi host,
# try to grab it using SSLVerifyFault exception
host_connect_spec.sslThumbprint = host_thumbprint
else:
self.module.fail_json(msg="Failed to add host %s to vCenter: %s" % (self.esxi_hostname,
to_native(task_error)))
except vmodl.fault.NotSupported:
self.module.fail_json(msg="Failed to add host %s to vCenter as host is"
" being added to a folder %s whose childType"
" property does not contain"
" \"ComputeResource\"." % (self.esxi_hostname, self.folder_name))
except Exception as generic_exc:
self.module.fail_json(msg="Failed to add host %s to vCenter: %s" % (self.esxi_hostname,
to_native(generic_exc)))
def state_reconnect_host(self):
"""Reconnect host to vCenter"""
changed = True
result = None
self.module.fail_json(msg="Failed to add host %s to vCenter" % self.esxi_hostname)
if self.module.check_mode:
result = "Host would be reconnected to vCenter '%s'" % self.vcenter
else:
self.reconnect_host(self.host)
result = "Host reconnected to vCenter '%s'" % self.vcenter
self.module.exit_json(changed=changed, result=str(result))
def reconnect_host_to_vcenter(self):
def reconnect_host(self, host_object):
"""Reconnect host to vCenter"""
reconnecthost_args = {}
reconnecthost_args['reconnectSpec'] = vim.HostSystem.ReconnectSpec()
reconnecthost_args['reconnectSpec'].syncState = True
if self.esxi_username is not None or self.esxi_password is not None:
if self.esxi_username and self.esxi_password:
# Build the connection spec as well and fetch thumbprint if enabled
# Usefull if you reinstalled a host and it uses a new self-signed certificate
reconnecthost_args['cnxSpec'] = self.get_host_connect_spec()
for count in range(0, 2):
try:
task = self.host.ReconnectHost_Task(**reconnecthost_args)
success, result = wait_for_task(task)
return success, result
except TaskError as task_error_exception:
task_error = task_error_exception.args[0]
if self.esxi_ssl_thumbprint == '' and isinstance(task_error, vim.fault.SSLVerifyFault):
# User has not specified SSL Thumbprint for ESXi host,
# try to grab it using SSLVerifyFault exception
reconnecthost_args['cnxSpec'].sslThumbprint = task_error.thumbprint
else:
self.module.fail_json(msg="Failed to reconnect host %s to vCenter: %s" % (self.esxi_hostname,
to_native(task_error.msg)))
self.module.fail_json(msg="Failed to reconnect host %s to vCenter" % self.esxi_hostname)
else:
try:
task = self.host.ReconnectHost_Task(**reconnecthost_args)
success, result = wait_for_task(task)
return success, result
except TaskError as task_error_exception:
task_error = task_error_exception.args[0]
self.module.fail_json(msg="Failed to reconnect host %s to vCenter due to %s" % (self.esxi_hostname,
to_native(task_error.msg)))
def state_exit_unchanged(self):
self.module.exit_json(changed=False)
try:
task = host_object.ReconnectHost_Task(**reconnecthost_args)
except vim.fault.InvalidLogin as invalid_login:
self.module.fail_json(
msg="Cannot authenticate with the host : %s" % to_native(invalid_login)
)
except vim.fault.InvalidState as invalid_state:
self.module.fail_json(
msg="The host is not disconnected : %s" % to_native(invalid_state)
)
except vim.fault.InvalidName as invalid_name:
self.module.fail_json(
msg="The host name is invalid : %s" % to_native(invalid_name)
)
except vim.fault.HostConnectFault as connect_fault:
self.module.fail_json(
msg="An error occurred during reconnect : %s" % to_native(connect_fault)
)
except vmodl.fault.NotSupported as not_supported:
self.module.fail_json(
msg="No host can be added to this group : %s" % to_native(not_supported)
)
except vim.fault.AlreadyBeingManaged as already_managed:
self.module.fail_json(
msg="The host is already being managed by another vCenter server : %s" % to_native(already_managed)
)
except vmodl.fault.NotEnoughLicenses as not_enough_licenses:
self.module.fail_json(
msg="There are not enough licenses to add this host : %s" % to_native(not_enough_licenses)
)
except vim.fault.NoHost as no_host:
self.module.fail_json(
msg="Unable to contact the host : %s" % to_native(no_host)
)
except vim.fault.NotSupportedHost as host_not_supported:
self.module.fail_json(
msg="The host is running a software version that is not supported : %s" %
to_native(host_not_supported)
)
except vim.fault.SSLVerifyFault as ssl_fault:
self.module.fail_json(
msg="The host certificate could not be authenticated : %s" % to_native(ssl_fault)
)
try:
changed, result = wait_for_task(task)
except TaskError as task_error:
self.module.fail_json(
msg="Failed to reconnect host to vCenter '%s' due to %s" %
(self.vcenter, to_native(task_error))
)
def state_remove_host(self):
"""Remove host from vCenter"""
changed = True
result = None
if not self.module.check_mode:
if not self.host.runtime.inMaintenanceMode:
maintenance_mode_task = self.host.EnterMaintenanceMode_Task(300, True, None)
changed, result = wait_for_task(maintenance_mode_task)
if changed:
task = self.host.Destroy_Task()
if self.module.check_mode:
result = "Host would be removed from vCenter '%s'" % self.vcenter
else:
# Check parent type
parent_type = self.get_parent_type(self.host_update)
if parent_type == 'cluster':
self.put_host_in_maintenance_mode(self.host_update)
try:
if self.folder_name:
task = self.host_parent_compute_resource.Destroy_Task()
elif self.cluster_name:
task = self.host.Destroy_Task()
except vim.fault.VimFault as vim_fault:
self.module.fail_json(msg=vim_fault)
try:
changed, result = wait_for_task(task)
else:
raise Exception(result)
result = "Host removed from vCenter '%s'" % self.vcenter
except TaskError as task_error:
self.module.fail_json(
msg="Failed to remove the host from vCenter '%s' : %s" % (self.vcenter, to_native(task_error))
)
self.module.exit_json(changed=changed, result=str(result))
def put_host_in_maintenance_mode(self, host_object):
"""Put host in maintenance mode, if not already"""
if not host_object.runtime.inMaintenanceMode:
try:
try:
maintenance_mode_task = host_object.EnterMaintenanceMode_Task(300, True, None)
except vim.fault.InvalidState as invalid_state:
self.module.fail_json(
msg="The host is already in maintenance mode : %s" % to_native(invalid_state)
)
except vim.fault.Timedout as timed_out:
self.module.fail_json(
msg="The maintenance mode operation timed out : %s" % to_native(timed_out)
)
except vim.fault.Timedout as timed_out:
self.module.fail_json(
msg="The maintenance mode operation was canceled : %s" % to_native(timed_out)
)
wait_for_task(maintenance_mode_task)
except TaskError as task_err:
self.module.fail_json(
msg="Failed to put the host in maintenance mode : %s" % to_native(task_err)
)
def get_parent_type(self, host_object):
"""
Get the type of the parent object
Returns: string with 'folder' or 'cluster'
"""
object_type = None
# check 'vim.ClusterComputeResource' first because it's also an
# instance of 'vim.ComputeResource'
if isinstance(host_object.parent, vim.ClusterComputeResource):
object_type = 'cluster'
elif isinstance(host_object.parent, vim.ComputeResource):
object_type = 'folder'
return object_type
def state_update_host(self):
self.module.exit_json(changed=False, msg="Currently not implemented.")
def state_add_host(self):
"""Move host to a cluster or a folder, or vice versa"""
changed = True
result = None
reconnect = False
if not self.module.check_mode:
changed, result = self.add_host_to_vcenter()
self.module.exit_json(changed=changed, result=str(result))
# Check if the host is disconnected if reconnect disconnected hosts is true
if self.reconnect_disconnected and self.host_update.runtime.connectionState == 'disconnected':
reconnect = True
def state_reconnect_host(self):
changed = True
result = None
# Check parent type
parent_type = self.get_parent_type(self.host_update)
if not self.module.check_mode:
changed, result = self.reconnect_host_to_vcenter()
self.module.exit_json(changed=changed, result=str(result))
if self.folder_name:
if self.module.check_mode:
if reconnect or self.state == 'add_or_reconnect' or self.state == 'reconnect':
result = "Host would be reconnected and moved to folder '%s'" % self.folder_name
else:
result = "Host would be moved to folder '%s'" % self.folder_name
else:
# Reconnect the host if disconnected or if specified by state
if reconnect or self.state == 'add_or_reconnect' or self.state == 'reconnect':
self.reconnect_host(self.host_update)
try:
try:
if parent_type == 'folder':
# Move ESXi host from folder to folder
task = self.folder.MoveIntoFolder_Task([self.host_update.parent])
elif parent_type == 'cluster':
self.put_host_in_maintenance_mode(self.host_update)
# Move ESXi host from cluster to folder
task = self.folder.MoveIntoFolder_Task([self.host_update])
except vim.fault.DuplicateName as duplicate_name:
self.module.fail_json(
msg="The folder already contains an object with the specified name : %s" %
to_native(duplicate_name)
)
except vim.fault.InvalidFolder as invalid_folder:
self.module.fail_json(
msg="The parent of this folder is in the list of objects : %s" %
to_native(invalid_folder)
)
except vim.fault.InvalidState as invalid_state:
self.module.fail_json(
msg="Failed to move host, this can be due to either of following :"
" 1. The host is not part of the same datacenter, 2. The host is not in maintenance mode : %s" %
to_native(invalid_state)
)
except vmodl.fault.NotSupported as not_supported:
self.module.fail_json(
msg="The target folder is not a host folder : %s" %
to_native(not_supported)
)
except vim.fault.DisallowedOperationOnFailoverHost as failover_host:
self.module.fail_json(
msg="The host is configured as a failover host : %s" %
to_native(failover_host)
)
except vim.fault.VmAlreadyExistsInDatacenter as already_exists:
self.module.fail_json(
msg="The host's virtual machines are already registered to a host in "
"the destination datacenter : %s" % to_native(already_exists)
)
changed, result = wait_for_task(task)
except TaskError as task_error_exception:
task_error = task_error_exception.args[0]
self.module.fail_json(
msg="Failed to move host %s to folder %s due to %s" %
(self.esxi_hostname, self.folder_name, to_native(task_error))
)
if reconnect or self.state == 'add_or_reconnect' or self.state == 'reconnect':
result = "Host reconnected and moved to folder '%s'" % self.folder_name
else:
result = "Host moved to folder '%s'" % self.folder_name
elif self.cluster_name:
if self.module.check_mode:
result = "Host would be moved to cluster '%s'" % self.cluster_name
else:
if parent_type == 'cluster':
# Put host in maintenance mode if moved from another cluster
self.put_host_in_maintenance_mode(self.host_update)
resource_pool = None
try:
try:
task = self.cluster.MoveHostInto_Task(
host=self.host_update, resourcePool=resource_pool
)
except vim.fault.TooManyHosts as too_many_hosts:
self.module.fail_json(
msg="No additional hosts can be added to the cluster : %s" % to_native(too_many_hosts)
)
except vim.fault.InvalidState as invalid_state:
self.module.fail_json(
msg="The host is already part of a cluster and is not in maintenance mode : %s" %
to_native(invalid_state)
)
except vmodl.fault.InvalidArgument as invalid_argument:
self.module.fail_json(
msg="Failed to move host, this can be due to either of following :"
" 1. The host is is not a part of the same datacenter as the cluster,"
" 2. The source and destination clusters are the same : %s" %
to_native(invalid_argument)
)
changed, result = wait_for_task(task)
except TaskError as task_error_exception:
task_error = task_error_exception.args[0]
self.module.fail_json(
msg="Failed to move host to cluster '%s' due to : %s" %
(self.cluster_name, to_native(task_error))
)
if reconnect or self.state == 'add_or_reconnect' or self.state == 'reconnect':
result = "Host reconnected and moved to cluster '%s'" % self.cluster_name
else:
result = "Host moved to cluster '%s'" % self.cluster_name
def check_host_state(self):
if self.cluster_name:
self.host, self.cluster = find_host_by_cluster_datacenter(self.module, self.content,
self.datacenter_name, self.cluster_name,
self.esxi_hostname)
elif self.folder_name:
si = self.content.searchIndex
folder_obj = si.FindByInventoryPath(self.folder_name)
if folder_obj and isinstance(folder_obj, vim.Folder):
self.folder = folder_obj
if self.folder is None:
self.module.fail_json(msg="Failed to get host system details from"
" the given folder %s" % self.folder_name,
details="This could either mean that the value of folder is"
" invalid or the provided folder does not exists.")
for child in self.folder.childEntity:
if child and isinstance(child, vim.HostSystem) and child.name == self.esxi_hostname:
self.host = child
if self.host is None:
return 'absent'
else:
return 'present'
self.module.exit_json(changed=changed, msg=str(result))
def main():
"""Main"""
argument_spec = vmware_argument_spec()
argument_spec.update(
datacenter_name=dict(type='str', required=True, aliases=['datacenter']),
@ -385,12 +793,15 @@ def main():
esxi_hostname=dict(type='str', required=True),
esxi_username=dict(type='str'),
esxi_password=dict(type='str', no_log=True),
esxi_ssl_thumbprint=dict(type='str', default=''),
esxi_ssl_thumbprint=dict(type='str', default='', aliases=['ssl_thumbprint']),
fetch_ssl_thumbprint=dict(type='bool', default=True),
state=dict(default='present',
choices=['present', 'absent', 'add_or_reconnect', 'reconnect'],
type='str'),
folder=dict(type='str'),
folder=dict(type='str', aliases=['folder_name']),
add_connected=dict(type='bool', default=True),
force_connection=dict(type='bool', default=True),
reconnect_disconnected=dict(type='bool', default=True),
)
module = AnsibleModule(

View file

@ -54,6 +54,19 @@
- debug: var=ccr1
- name: get a list of hosts from vcsim
uri:
url: http://{{ vcsim }}:5000/govc_find?filter=H
register: hosts
- name: get a host
set_fact:
host1: "{{ hosts.json[0] | basename }}"
- debug: var=host1
# fetch_ssl_thumbprint needs to be disabled because the host only exists in vcsim
# Testcase: Add Host
- name: add host
vmware_host:
@ -66,6 +79,7 @@
esxi_password: "{{ vcsim_instance.json.password }}"
datacenter_name: "{{ dc1 }}"
cluster_name: "{{ ccr1 }}"
fetch_ssl_thumbprint: False
state: present
register: add_host_result
@ -92,6 +106,7 @@
esxi_password: "{{ vcsim_instance.json.password }}"
datacenter_name: "{{ dc1 }}"
cluster_name: "{{ ccr1 }}"
fetch_ssl_thumbprint: False
state: present
register: readd_host_result
@ -112,6 +127,7 @@
esxi_password: "{{ vcsim_instance.json.password }}"
datacenter_name: "{{ dc1 }}"
cluster_name: "{{ ccr1 }}"
fetch_ssl_thumbprint: False
state: add_or_reconnect
register: add_or_reconnect_host_result
@ -126,6 +142,99 @@
- add_or_reconnect_host_result is changed
- "{% for host in host_list.json if ((host | basename) == 'test_host_system_0002') -%} True {%- else -%} False {%- endfor %}"
## Testcase: Add Host to folder
#
# It's not possible to connect an ESXi host via vcsim.
#
# - name: Create host folder
# vcenter_folder:
# hostname: "{{ vcsim }}"
# username: "{{ vcsim_instance.json.username }}"
# password: "{{ vcsim_instance.json.password }}"
# validate_certs: no
# datacenter: "{{ dc1 }}"
# folder_name: "Staging"
# folder_type: host
# state: present
# register: folder_results
#
# - debug: msg="{{ folder_results }}"
#
# - name: ensure folder is present
# assert:
# that:
# - folder_results.changed
#
# - name: Create host folder again
# vcenter_folder:
# hostname: "{{ vcsim }}"
# username: "{{ vcsim_instance.json.username }}"
# password: "{{ vcsim_instance.json.password }}"
# validate_certs: no
# datacenter: "{{ dc1 }}"
# folder_name: "Staging"
# folder_type: host
# state: present
# register: folder_results
#
# - debug: msg="{{ folder_results }}"
#
# - name: ensure folder is present
# assert:
# that:
# - folder_results.changed == False
#
# - name: Add host to folder in check mode
# vmware_host:
# hostname: "{{ vcsim }}"
# username: "{{ vcsim_instance.json.username }}"
# password: "{{ vcsim_instance.json.password }}"
# validate_certs: no
# esxi_hostname: test_host_system_0003
# esxi_username: "{{ vcsim_instance.json.username }}"
# esxi_password: "{{ vcsim_instance.json.password }}"
# datacenter_name: "{{ dc1 }}"
# folder_name: "Staging"
# state: present
# register: add_host_to_folder_result
# check_mode: yes
#
# - name: get a list of host system from vcsim after adding host system
# uri:
# url: http://{{ vcsim }}:5000/govc_find?filter=H
# register: host_list
#
# - name: ensure host system is not present
# assert:
# that:
# - add_host_to_folder_result is changed
# - not ("{% for host in host_list.json if ((host | basename) == 'test_host_system_0003') -%} True {%- else -%} False {%- endfor %}")
#
# - name: Add host to folder
# vmware_host:
# hostname: "{{ vcsim }}"
# username: "{{ vcsim_instance.json.username }}"
# password: "{{ vcsim_instance.json.password }}"
# validate_certs: no
# esxi_hostname: test_host_system_0003
# esxi_username: "{{ vcsim_instance.json.username }}"
# esxi_password: "{{ vcsim_instance.json.password }}"
# datacenter_name: "{{ dc1 }}"
# folder_name: "Staging"
# state: present
# register: add_host_to_folder_result
#
# - name: get a list of host system from vcsim after adding host system
# uri:
# url: http://{{ vcsim }}:5000/govc_find?filter=H
# register: host_list
#
# - name: ensure host system is present
# assert:
# that:
# - add_host_to_folder_result is changed
# - "{% for host in host_list.json if ((host | basename) == 'test_host_system_0003') -%} True {%- else -%} False {%- endfor %}"
## Testcase: Reconnect Host
#
# ReconnectHost_Task need to be implemented in vcsim for this test to work