mirror of https://github.com/ansible/ansible.git
VMware: add new module vmware_guest_network (#52075)
Diane Wang
5 years ago
committed by
Abhijeet Kasurde
parent
5b953581b4
commit
9c140d26d5
@ -0,0 +1,461 @@
|
|||||||
|
#!/usr/bin/python
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
# Copyright: (c) 2019, Ansible Project
|
||||||
|
# Copyright: (c) 2019, Diane Wang <dianew@vmware.com>
|
||||||
|
# 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
|
||||||
|
__metaclass__ = type
|
||||||
|
|
||||||
|
ANSIBLE_METADATA = {
|
||||||
|
'metadata_version': '1.1',
|
||||||
|
'status': ['preview'],
|
||||||
|
'supported_by': 'community'
|
||||||
|
}
|
||||||
|
|
||||||
|
DOCUMENTATION = '''
|
||||||
|
---
|
||||||
|
module: vmware_guest_network
|
||||||
|
short_description: Manage network adapters of specified virtual machine in given vCenter infrastructure
|
||||||
|
description:
|
||||||
|
- This module is used to add, reconfigure, remove network adapter of given virtual machine.
|
||||||
|
- All parameters and VMware object names are case sensitive.
|
||||||
|
version_added: '2.9'
|
||||||
|
author:
|
||||||
|
- Diane Wang (@Tomorrow9) <dianew@vmware.com>
|
||||||
|
notes:
|
||||||
|
- Tested on vSphere 6.0, 6.5 and 6.7
|
||||||
|
requirements:
|
||||||
|
- "python >= 2.6"
|
||||||
|
- PyVmomi
|
||||||
|
options:
|
||||||
|
name:
|
||||||
|
description:
|
||||||
|
- Name of the virtual machine.
|
||||||
|
- This is a required parameter, if parameter C(uuid) is not supplied.
|
||||||
|
type: str
|
||||||
|
uuid:
|
||||||
|
description:
|
||||||
|
- UUID of the instance to gather facts if known, this is VMware's unique identifier.
|
||||||
|
- This is a required parameter, if parameter C(name) is not supplied.
|
||||||
|
type: str
|
||||||
|
folder:
|
||||||
|
description:
|
||||||
|
- Destination folder, absolute or relative path to find an existing guest.
|
||||||
|
- This is a required parameter, only if multiple VMs are found with same name.
|
||||||
|
- The folder should include the datacenter. ESXi server's datacenter is ha-datacenter.
|
||||||
|
- 'Examples:'
|
||||||
|
- ' folder: /ha-datacenter/vm'
|
||||||
|
- ' folder: ha-datacenter/vm'
|
||||||
|
- ' folder: /datacenter1/vm'
|
||||||
|
- ' folder: datacenter1/vm'
|
||||||
|
- ' folder: /datacenter1/vm/folder1'
|
||||||
|
- ' folder: datacenter1/vm/folder1'
|
||||||
|
- ' folder: /folder1/datacenter1/vm'
|
||||||
|
- ' folder: folder1/datacenter1/vm'
|
||||||
|
- ' folder: /folder1/datacenter1/vm/folder2'
|
||||||
|
type: str
|
||||||
|
cluster:
|
||||||
|
description:
|
||||||
|
- The name of cluster where the virtual machine will run.
|
||||||
|
- This is a required parameter, if C(esxi_hostname) is not set.
|
||||||
|
- C(esxi_hostname) and C(cluster) are mutually exclusive parameters.
|
||||||
|
type: str
|
||||||
|
esxi_hostname:
|
||||||
|
description:
|
||||||
|
- The ESXi hostname where the virtual machine will run.
|
||||||
|
- This is a required parameter, if C(cluster) is not set.
|
||||||
|
- C(esxi_hostname) and C(cluster) are mutually exclusive parameters.
|
||||||
|
type: str
|
||||||
|
datacenter:
|
||||||
|
default: ha-datacenter
|
||||||
|
description:
|
||||||
|
- The datacenter name to which virtual machine belongs to.
|
||||||
|
type: str
|
||||||
|
gather_network_facts:
|
||||||
|
description:
|
||||||
|
- If set to C(True), return settings of all network adapters, other parameters are ignored.
|
||||||
|
- If set to C(False), will add, reconfigure or remove network adapters according to the parameters in C(networks).
|
||||||
|
type: bool
|
||||||
|
default: False
|
||||||
|
networks:
|
||||||
|
type: list
|
||||||
|
description:
|
||||||
|
- A list of network adapters.
|
||||||
|
- C(mac) or C(label) or C(device_type) is required to reconfigure or remove an existing network adapter.
|
||||||
|
- 'If there are multiple network adapters with the same C(device_type), you should set C(label) or C(mac) to match
|
||||||
|
one of them, or will apply changes on all network adapters with the C(device_type) specified.'
|
||||||
|
- 'C(mac), C(label), C(device_type) is the order of precedence from greatest to least if all set.'
|
||||||
|
- 'Valid attributes are:'
|
||||||
|
- ' - C(mac) (string): MAC address of the existing network adapter to be reconfigured or removed.'
|
||||||
|
- ' - C(label) (string): Label of the existing network adapter to be reconfigured or removed, e.g., "Network adapter 1".'
|
||||||
|
- ' - C(device_type) (string): Valid virtual network device types are:
|
||||||
|
C(e1000), C(e1000e), C(pcnet32), C(vmxnet2), C(vmxnet3) (default), C(sriov).
|
||||||
|
Used to add new network adapter, reconfigure or remove the existing network adapter with this type.
|
||||||
|
If C(mac) and C(label) not specified or not find network adapter by C(mac) or C(label) will use this parameter.'
|
||||||
|
- ' - C(name) (string): Name of the portgroup or distributed virtual portgroup for this interface.
|
||||||
|
When specifying distributed virtual portgroup make sure given C(esxi_hostname) or C(cluster) is associated with it.'
|
||||||
|
- ' - C(vlan) (integer): VLAN number for this interface.'
|
||||||
|
- ' - C(dvswitch_name) (string): Name of the distributed vSwitch.
|
||||||
|
This value is required if multiple distributed portgroups exists with the same name.'
|
||||||
|
- ' - C(state) (string): State of the network adapter.'
|
||||||
|
- ' If set to C(present), then will do reconfiguration for the specified network adapter.'
|
||||||
|
- ' If set to C(new), then will add the specified network adapter.'
|
||||||
|
- ' If set to C(absent), then will remove this network adapter.'
|
||||||
|
- ' - C(manual_mac) (string): Manual specified MAC address of the network adapter when creating, or reconfiguring.
|
||||||
|
If not specified when creating new network adapter, mac address will be generated automatically.
|
||||||
|
When reconfigure MAC address, VM should be in powered off state.'
|
||||||
|
- ' - C(connected) (bool): Indicates that virtual network adapter connects to the associated virtual machine.'
|
||||||
|
- ' - C(start_connected) (bool): Indicates that virtual network adapter starts with associated virtual machine powers on.'
|
||||||
|
extends_documentation_fragment: vmware.documentation
|
||||||
|
'''
|
||||||
|
|
||||||
|
EXAMPLES = '''
|
||||||
|
- name: Change network adapter settings of virtual machine
|
||||||
|
vmware_guest_network:
|
||||||
|
hostname: "{{ vcenter_hostname }}"
|
||||||
|
username: "{{ vcenter_username }}"
|
||||||
|
password: "{{ vcenter_password }}"
|
||||||
|
datacenter: "{{ datacenter_name }}"
|
||||||
|
validate_certs: no
|
||||||
|
name: test-vm
|
||||||
|
gather_network_facts: false
|
||||||
|
networks:
|
||||||
|
- name: "VM Network"
|
||||||
|
state: new
|
||||||
|
manual_mac: "00:50:56:11:22:33"
|
||||||
|
- state: present
|
||||||
|
device_type: e1000e
|
||||||
|
manual_mac: "00:50:56:44:55:66"
|
||||||
|
- state: present
|
||||||
|
label: "Network adapter 3"
|
||||||
|
connected: false
|
||||||
|
- state: absent
|
||||||
|
mac: "00:50:56:44:55:77"
|
||||||
|
delegate_to: localhost
|
||||||
|
register: network_facts
|
||||||
|
'''
|
||||||
|
|
||||||
|
RETURN = """
|
||||||
|
network_data:
|
||||||
|
description: metadata about the virtual machine's network adapter after managing them
|
||||||
|
returned: always
|
||||||
|
type: dict
|
||||||
|
sample: {
|
||||||
|
"0": {
|
||||||
|
"label": "Network Adapter 1",
|
||||||
|
"name": "VM Network",
|
||||||
|
"device_type": "E1000E",
|
||||||
|
"mac_addr": "00:50:56:89:dc:05",
|
||||||
|
"unit_number": 7,
|
||||||
|
"wake_onlan": false,
|
||||||
|
"allow_guest_ctl": true,
|
||||||
|
"connected": true,
|
||||||
|
"start_connected": true,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
"""
|
||||||
|
|
||||||
|
import re
|
||||||
|
|
||||||
|
try:
|
||||||
|
from pyVmomi import vim
|
||||||
|
except ImportError:
|
||||||
|
pass
|
||||||
|
|
||||||
|
from ansible.module_utils.basic import AnsibleModule
|
||||||
|
from ansible.module_utils.common.network import is_mac
|
||||||
|
from ansible.module_utils._text import to_native, to_text
|
||||||
|
from ansible.module_utils.vmware import PyVmomi, vmware_argument_spec, wait_for_task, find_obj, get_all_objs, get_parent_datacenter
|
||||||
|
|
||||||
|
|
||||||
|
class PyVmomiHelper(PyVmomi):
|
||||||
|
def __init__(self, module):
|
||||||
|
super(PyVmomiHelper, self).__init__(module)
|
||||||
|
self.change_detected = False
|
||||||
|
self.config_spec = vim.vm.ConfigSpec()
|
||||||
|
self.config_spec.deviceChange = []
|
||||||
|
self.nic_device_type = dict(
|
||||||
|
pcnet32=vim.vm.device.VirtualPCNet32,
|
||||||
|
vmxnet2=vim.vm.device.VirtualVmxnet2,
|
||||||
|
vmxnet3=vim.vm.device.VirtualVmxnet3,
|
||||||
|
e1000=vim.vm.device.VirtualE1000,
|
||||||
|
e1000e=vim.vm.device.VirtualE1000e,
|
||||||
|
sriov=vim.vm.device.VirtualSriovEthernetCard,
|
||||||
|
)
|
||||||
|
|
||||||
|
def get_device_type(self, device_type=None):
|
||||||
|
""" Get network adapter device type """
|
||||||
|
if device_type and device_type in list(self.nic_device_type.keys()):
|
||||||
|
return self.nic_device_type[device_type]()
|
||||||
|
else:
|
||||||
|
self.module.fail_json(msg='Invalid network device_type %s' % device_type)
|
||||||
|
|
||||||
|
def get_network_device(self, vm=None, mac=None, device_type=None, device_label=None):
|
||||||
|
"""
|
||||||
|
Get network adapter
|
||||||
|
"""
|
||||||
|
nic_devices = []
|
||||||
|
nic_device = None
|
||||||
|
if vm is None:
|
||||||
|
if device_type:
|
||||||
|
return nic_devices
|
||||||
|
else:
|
||||||
|
return nic_device
|
||||||
|
|
||||||
|
for device in vm.config.hardware.device:
|
||||||
|
if mac:
|
||||||
|
if isinstance(device, vim.vm.device.VirtualEthernetCard):
|
||||||
|
if device.macAddress == mac:
|
||||||
|
nic_device = device
|
||||||
|
break
|
||||||
|
elif device_type:
|
||||||
|
if isinstance(device, self.nic_device_type[device_type]):
|
||||||
|
nic_devices.append(device)
|
||||||
|
elif device_label:
|
||||||
|
if isinstance(device, vim.vm.device.VirtualEthernetCard):
|
||||||
|
if device.deviceInfo.label == device_label:
|
||||||
|
nic_device = device
|
||||||
|
break
|
||||||
|
if device_type:
|
||||||
|
return nic_devices
|
||||||
|
else:
|
||||||
|
return nic_device
|
||||||
|
|
||||||
|
def get_network_device_by_mac(self, vm=None, mac=None):
|
||||||
|
""" Get network adapter with the specified mac address"""
|
||||||
|
return self.get_network_device(vm=vm, mac=mac)
|
||||||
|
|
||||||
|
def get_network_devices_by_type(self, vm=None, device_type=None):
|
||||||
|
""" Get network adapter list with the name type """
|
||||||
|
return self.get_network_device(vm=vm, device_type=device_type)
|
||||||
|
|
||||||
|
def get_network_device_by_label(self, vm=None, device_label=None):
|
||||||
|
""" Get network adapter with the specified label """
|
||||||
|
return self.get_network_device(vm=vm, device_label=device_label)
|
||||||
|
|
||||||
|
def create_network_adapter(self, device_info):
|
||||||
|
nic = vim.vm.device.VirtualDeviceSpec()
|
||||||
|
nic.device = self.get_device_type(device_type=device_info.get('device_type', 'vmxnet3'))
|
||||||
|
nic.device.deviceInfo = vim.Description()
|
||||||
|
nic.device.deviceInfo.summary = device_info['name']
|
||||||
|
nic.device.backing = vim.vm.device.VirtualEthernetCard.NetworkBackingInfo()
|
||||||
|
nic.device.backing.deviceName = device_info['name']
|
||||||
|
nic.device.connectable = vim.vm.device.VirtualDevice.ConnectInfo()
|
||||||
|
nic.device.connectable.startConnected = device_info.get('start_connected', True)
|
||||||
|
nic.device.connectable.allowGuestControl = True
|
||||||
|
nic.device.connectable.connected = device_info.get('connected', True)
|
||||||
|
if 'manual_mac' in device_info:
|
||||||
|
nic.device.addressType = 'manual'
|
||||||
|
nic.device.macAddress = device_info['manual_mac']
|
||||||
|
else:
|
||||||
|
nic.device.addressType = 'generated'
|
||||||
|
|
||||||
|
return nic
|
||||||
|
|
||||||
|
def get_network_facts(self, vm_obj):
|
||||||
|
network_facts = dict()
|
||||||
|
if vm_obj is None:
|
||||||
|
return network_facts
|
||||||
|
|
||||||
|
nic_index = 0
|
||||||
|
for nic in vm_obj.config.hardware.device:
|
||||||
|
nic_type = None
|
||||||
|
if isinstance(nic, vim.vm.device.VirtualPCNet32):
|
||||||
|
nic_type = 'PCNet32'
|
||||||
|
elif isinstance(nic, vim.vm.device.VirtualVmxnet2):
|
||||||
|
nic_type = 'VMXNET2'
|
||||||
|
elif isinstance(nic, vim.vm.device.VirtualVmxnet3):
|
||||||
|
nic_type = 'VMXNET3'
|
||||||
|
elif isinstance(nic, vim.vm.device.VirtualE1000):
|
||||||
|
nic_type = 'E1000'
|
||||||
|
elif isinstance(nic, vim.vm.device.VirtualE1000e):
|
||||||
|
nic_type = 'E1000E'
|
||||||
|
elif isinstance(nic, vim.vm.device.VirtualSriovEthernetCard):
|
||||||
|
nic_type = 'SriovEthernetCard'
|
||||||
|
if nic_type is not None:
|
||||||
|
network_facts[nic_index] = dict(
|
||||||
|
device_type=nic_type,
|
||||||
|
label=nic.deviceInfo.label,
|
||||||
|
name=nic.deviceInfo.summary,
|
||||||
|
mac_addr=nic.macAddress,
|
||||||
|
unit_number=nic.unitNumber,
|
||||||
|
wake_onlan=nic.wakeOnLanEnabled,
|
||||||
|
allow_guest_ctl=nic.connectable.allowGuestControl,
|
||||||
|
connected=nic.connectable.connected,
|
||||||
|
start_connected=nic.connectable.startConnected,
|
||||||
|
)
|
||||||
|
nic_index += 1
|
||||||
|
|
||||||
|
return network_facts
|
||||||
|
|
||||||
|
def sanitize_network_params(self):
|
||||||
|
network_list = []
|
||||||
|
valid_state = ['new', 'present', 'absent']
|
||||||
|
if len(self.params['networks']) != 0:
|
||||||
|
for network in self.params['networks']:
|
||||||
|
if 'state' not in network or network['state'].lower() not in valid_state:
|
||||||
|
self.module.fail_json(msg="Network adapter state not specified or invalid: '%s', valid values: "
|
||||||
|
"%s" % (network.get('state', ''), valid_state))
|
||||||
|
# add new network adapter but no name specified
|
||||||
|
if network['state'].lower() == 'new' and 'name' not in network and 'vlan' not in network:
|
||||||
|
self.module.fail_json(msg="Please specify at least network name or VLAN name for adding new network adapter.")
|
||||||
|
if network['state'].lower() == 'new' and 'mac' in network:
|
||||||
|
self.module.fail_json(msg="networks.mac is used for vNIC reconfigure, but networks.state is set to 'new'.")
|
||||||
|
if network['state'].lower() == 'present' and 'mac' not in network and 'label' not in network and 'device_type' not in network:
|
||||||
|
self.module.fail_json(msg="Should specify 'mac', 'label' or 'device_type' parameter to reconfigure network adapter")
|
||||||
|
if 'connected' in network:
|
||||||
|
if not isinstance(network['connected'], bool):
|
||||||
|
self.module.fail_json(msg="networks.connected parameter should be boolean.")
|
||||||
|
if network['state'].lower() == 'new' and not network['connected']:
|
||||||
|
network['start_connected'] = False
|
||||||
|
if 'start_connected' in network:
|
||||||
|
if not isinstance(network['start_connected'], bool):
|
||||||
|
self.module.fail_json(msg="networks.start_connected parameter should be boolean.")
|
||||||
|
if network['state'].lower() == 'new' and not network['start_connected']:
|
||||||
|
network['connected'] = False
|
||||||
|
# specified network not exist
|
||||||
|
if 'name' in network and not self.network_exists_by_name(self.content, network['name']):
|
||||||
|
self.module.fail_json(msg="Network '%(name)s' does not exist." % network)
|
||||||
|
elif 'vlan' in network:
|
||||||
|
objects = get_all_objs(self.content, [vim.dvs.DistributedVirtualPortgroup])
|
||||||
|
dvps = [x for x in objects if to_text(get_parent_datacenter(x).name) == to_text(self.params['datacenter'])]
|
||||||
|
for dvp in dvps:
|
||||||
|
if hasattr(dvp.config.defaultPortConfig, 'vlan') and \
|
||||||
|
isinstance(dvp.config.defaultPortConfig.vlan.vlanId, int) and \
|
||||||
|
str(dvp.config.defaultPortConfig.vlan.vlanId) == str(network['vlan']):
|
||||||
|
network['name'] = dvp.config.name
|
||||||
|
break
|
||||||
|
if 'dvswitch_name' in network and \
|
||||||
|
dvp.config.distributedVirtualSwitch.name == network['dvswitch_name'] and \
|
||||||
|
dvp.config.name == network['vlan']:
|
||||||
|
network['name'] = dvp.config.name
|
||||||
|
break
|
||||||
|
if dvp.config.name == network['vlan']:
|
||||||
|
network['name'] = dvp.config.name
|
||||||
|
break
|
||||||
|
else:
|
||||||
|
self.module.fail_json(msg="VLAN '%(vlan)s' does not exist." % network)
|
||||||
|
|
||||||
|
if 'device_type' in network and network['device_type'] not in list(self.nic_device_type.keys()):
|
||||||
|
self.module.fail_json(msg="Device type specified '%s' is invalid. "
|
||||||
|
"Valid types %s " % (network['device_type'], list(self.nic_device_type.keys())))
|
||||||
|
|
||||||
|
if ('mac' in network and not is_mac(network['mac'])) or \
|
||||||
|
('manual_mac' in network and not is_mac(network['manual_mac'])):
|
||||||
|
self.module.fail_json(msg="Device MAC address '%s' or manual set MAC address %s is invalid. "
|
||||||
|
"Please provide correct MAC address." % (network['mac'], network['manual_mac']))
|
||||||
|
|
||||||
|
network_list.append(network)
|
||||||
|
|
||||||
|
return network_list
|
||||||
|
|
||||||
|
def get_network_config_spec(self, vm_obj, network_list):
|
||||||
|
# create network adapter config spec for adding, editing, removing
|
||||||
|
for network in network_list:
|
||||||
|
# add new network adapter
|
||||||
|
if network['state'].lower() == 'new':
|
||||||
|
nic_spec = self.create_network_adapter(network)
|
||||||
|
nic_spec.operation = vim.vm.device.VirtualDeviceSpec.Operation.add
|
||||||
|
self.change_detected = True
|
||||||
|
self.config_spec.deviceChange.append(nic_spec)
|
||||||
|
# reconfigure network adapter or remove network adapter
|
||||||
|
else:
|
||||||
|
nic_devices = []
|
||||||
|
if 'mac' in network:
|
||||||
|
nic = self.get_network_device_by_mac(vm_obj, mac=network['mac'])
|
||||||
|
if nic is not None:
|
||||||
|
nic_devices.append(nic)
|
||||||
|
if 'label' in network and len(nic_devices) == 0:
|
||||||
|
nic = self.get_network_device_by_label(vm_obj, device_label=network['label'])
|
||||||
|
if nic is not None:
|
||||||
|
nic_devices.append(nic)
|
||||||
|
if 'device_type' in network and len(nic_devices) == 0:
|
||||||
|
nic_devices = self.get_network_devices_by_type(vm_obj, device_type=network['device_type'])
|
||||||
|
if len(nic_devices) != 0:
|
||||||
|
for nic_device in nic_devices:
|
||||||
|
nic_spec = vim.vm.device.VirtualDeviceSpec()
|
||||||
|
if network['state'].lower() == 'present':
|
||||||
|
nic_spec.operation = vim.vm.device.VirtualDeviceSpec.Operation.edit
|
||||||
|
nic_spec.device = nic_device
|
||||||
|
if 'start_connected' in network and nic_device.connectable.startConnected != network['start_connected']:
|
||||||
|
nic_device.connectable.startConnected = network['start_connected']
|
||||||
|
self.change_detected = True
|
||||||
|
if 'connected' in network and nic_device.connectable.connected != network['connected']:
|
||||||
|
nic_device.connectable.connected = network['connected']
|
||||||
|
self.change_detected = True
|
||||||
|
if 'name' in network and nic_device.deviceInfo.summary != network['name']:
|
||||||
|
nic_device.deviceInfo.summary = network['name']
|
||||||
|
self.change_detected = True
|
||||||
|
if 'manual_mac' in network and nic_device.macAddress != network['manual_mac']:
|
||||||
|
if vm_obj.runtime.powerState != vim.VirtualMachinePowerState.poweredOff:
|
||||||
|
self.module.fail_json(msg='Expected power state is poweredOff to reconfigure MAC address')
|
||||||
|
nic_device.addressType = 'manual'
|
||||||
|
nic_device.macAddress = network['manual_mac']
|
||||||
|
self.change_detected = True
|
||||||
|
if self.change_detected:
|
||||||
|
self.config_spec.deviceChange.append(nic_spec)
|
||||||
|
elif network['state'].lower() == 'absent':
|
||||||
|
nic_spec.operation = vim.vm.device.VirtualDeviceSpec.Operation.remove
|
||||||
|
nic_spec.device = nic_device
|
||||||
|
self.change_detected = True
|
||||||
|
self.config_spec.deviceChange.append(nic_spec)
|
||||||
|
else:
|
||||||
|
self.module.fail_json(msg='Unable to find the specified network adapter: %s' % network)
|
||||||
|
|
||||||
|
def reconfigure_vm_network(self, vm_obj):
|
||||||
|
network_list = self.sanitize_network_params()
|
||||||
|
# gather network adapter facts only
|
||||||
|
if (self.params['gather_network_facts'] is not None and self.params['gather_network_facts']) or len(network_list) == 0:
|
||||||
|
results = {'changed': False, 'failed': False, 'network_data': self.get_network_facts(vm_obj)}
|
||||||
|
# do reconfigure then gather facts
|
||||||
|
else:
|
||||||
|
self.get_network_config_spec(vm_obj, network_list)
|
||||||
|
try:
|
||||||
|
task = vm_obj.ReconfigVM_Task(spec=self.config_spec)
|
||||||
|
wait_for_task(task)
|
||||||
|
except vim.fault.InvalidDeviceSpec as e:
|
||||||
|
self.module.fail_json(msg="Failed to configure network adapter on given virtual machine due to invalid"
|
||||||
|
" device spec : %s" % to_native(e.msg),
|
||||||
|
details="Please check ESXi server logs for more details.")
|
||||||
|
except vim.fault.RestrictedVersion as e:
|
||||||
|
self.module.fail_json(msg="Failed to reconfigure virtual machine due to"
|
||||||
|
" product versioning restrictions: %s" % to_native(e.msg))
|
||||||
|
if task.info.state == 'error':
|
||||||
|
results = {'changed': self.change_detected, 'failed': True, 'msg': task.info.error.msg}
|
||||||
|
else:
|
||||||
|
network_facts = self.get_network_facts(vm_obj)
|
||||||
|
results = {'changed': self.change_detected, 'failed': False, 'network_data': network_facts}
|
||||||
|
|
||||||
|
return results
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
argument_spec = vmware_argument_spec()
|
||||||
|
argument_spec.update(
|
||||||
|
name=dict(type='str'),
|
||||||
|
uuid=dict(type='str'),
|
||||||
|
folder=dict(type='str'),
|
||||||
|
datacenter=dict(type='str', default='ha-datacenter'),
|
||||||
|
esxi_hostname=dict(type='str'),
|
||||||
|
cluster=dict(type='str'),
|
||||||
|
gather_network_facts=dict(type='bool', default=False),
|
||||||
|
networks=dict(type='list', default=[])
|
||||||
|
)
|
||||||
|
|
||||||
|
module = AnsibleModule(argument_spec=argument_spec, required_one_of=[['name', 'uuid']])
|
||||||
|
pyv = PyVmomiHelper(module)
|
||||||
|
vm = pyv.get_vm()
|
||||||
|
if not vm:
|
||||||
|
module.fail_json(msg='Unable to find the specified virtual machine uuid: %s, name: %s '
|
||||||
|
% ((module.params.get('uuid')), (module.params.get('name'))))
|
||||||
|
|
||||||
|
result = pyv.reconfigure_vm_network(vm)
|
||||||
|
if result['failed']:
|
||||||
|
module.fail_json(**result)
|
||||||
|
else:
|
||||||
|
module.exit_json(**result)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
main()
|
||||||
@ -0,0 +1,3 @@
|
|||||||
|
cloud/vcenter
|
||||||
|
shippable/vcenter/group1
|
||||||
|
needs/target/prepare_vmware_tests
|
||||||
@ -0,0 +1,87 @@
|
|||||||
|
# Test code for the vmware_guest_network module
|
||||||
|
# Copyright: (c) 2019, Diane Wang (Tomorrow9) <dianew@vmware.com>
|
||||||
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||||
|
|
||||||
|
- when: vcsim is not defined
|
||||||
|
block:
|
||||||
|
- import_role:
|
||||||
|
name: prepare_vmware_tests
|
||||||
|
vars:
|
||||||
|
setup_attach_host: true
|
||||||
|
setup_datastore: true
|
||||||
|
setup_virtualmachines: true
|
||||||
|
|
||||||
|
- name: gather network adapters' facts of the virtual machine
|
||||||
|
vmware_guest_network:
|
||||||
|
validate_certs: False
|
||||||
|
hostname: "{{ vcenter_hostname }}"
|
||||||
|
username: "{{ vcenter_username }}"
|
||||||
|
password: "{{ vcenter_password }}"
|
||||||
|
name: "{{ infra.vm_list[0] }}"
|
||||||
|
gather_network_facts: true
|
||||||
|
register: netadapter_facts
|
||||||
|
- debug: var=netadapter_facts
|
||||||
|
- name: get number of existing netowrk adapters
|
||||||
|
set_fact:
|
||||||
|
netadapter_num: "{{ netadapter_facts.network_data | length }}"
|
||||||
|
|
||||||
|
- name: add new network adapters to virtual machine
|
||||||
|
vmware_guest_network:
|
||||||
|
validate_certs: False
|
||||||
|
hostname: "{{ vcenter_hostname }}"
|
||||||
|
username: "{{ vcenter_username }}"
|
||||||
|
password: "{{ vcenter_password }}"
|
||||||
|
name: "{{ infra.vm_list[0] }}"
|
||||||
|
networks:
|
||||||
|
- name: "VM Network"
|
||||||
|
state: new
|
||||||
|
device_type: e1000e
|
||||||
|
manual_mac: "00:50:56:58:59:60"
|
||||||
|
- name: "VM Network"
|
||||||
|
state: new
|
||||||
|
device_type: vmxnet3
|
||||||
|
manual_mac: "00:50:56:58:59:61"
|
||||||
|
register: add_netadapter
|
||||||
|
- debug: var=add_netadapter
|
||||||
|
- name: assert the new netowrk adapters were added to VM
|
||||||
|
assert:
|
||||||
|
that:
|
||||||
|
- "add_netadapter.changed == true"
|
||||||
|
- "{{ add_netadapter.network_data | length | int }} == {{ netadapter_num | int + 2 }}"
|
||||||
|
|
||||||
|
- name: delete one specified network adapter
|
||||||
|
vmware_guest_network:
|
||||||
|
validate_certs: False
|
||||||
|
hostname: "{{ vcenter_hostname }}"
|
||||||
|
username: "{{ vcenter_username }}"
|
||||||
|
password: "{{ vcenter_password }}"
|
||||||
|
name: "{{ infra.vm_list[0] }}"
|
||||||
|
networks:
|
||||||
|
- state: absent
|
||||||
|
mac: "00:50:56:58:59:60"
|
||||||
|
register: del_netadapter
|
||||||
|
- debug: var=del_netadapter
|
||||||
|
- name: assert the network adapter was removed
|
||||||
|
assert:
|
||||||
|
that:
|
||||||
|
- "del_netadapter.changed == true"
|
||||||
|
- "{{ del_netadapter.network_data | length | int }} == {{ netadapter_num | int + 1 }}"
|
||||||
|
|
||||||
|
- name: disconnect one specified network adapter
|
||||||
|
vmware_guest_network:
|
||||||
|
validate_certs: False
|
||||||
|
hostname: "{{ vcenter_hostname }}"
|
||||||
|
username: "{{ vcenter_username }}"
|
||||||
|
password: "{{ vcenter_password }}"
|
||||||
|
name: "{{ infra.vm_list[0] }}"
|
||||||
|
networks:
|
||||||
|
- state: present
|
||||||
|
mac: "00:50:56:58:59:61"
|
||||||
|
connected: false
|
||||||
|
register: disc_netadapter
|
||||||
|
- debug: var=disc_netadapter
|
||||||
|
- name: assert the network adapter was disconnected
|
||||||
|
assert:
|
||||||
|
that:
|
||||||
|
- "disc_netadapter.changed == true"
|
||||||
|
- "{{ disc_netadapter.network_data[netadapter_num]['connected'] }} == false"
|
||||||
Loading…
Reference in New Issue