diff --git a/library/vsphere_facts b/library/vsphere_facts new file mode 100755 index 0000000000..bc202d30c6 --- /dev/null +++ b/library/vsphere_facts @@ -0,0 +1,138 @@ +#!/usr/bin/python +# -*- coding: utf-8 -*- + +# Copyright 2012 Dag Wieers +# +# 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 . + +DOCUMENTATION = ''' +--- +author: Dag Wieers +module: vsphere_facts +short_description: Gather facts for a guest on VMWare vSphere +description: + - This module gathers facts for a specific guest on VMWare vSphere. + These facts include hardware and network related information useful + for provisioning (e.g. macaddress, uuid). + - This module requires the pysphere python module. +version_added: "0.8" +options: + host: + description: + - The vSphere server from the cluster the virtual server is located on. + required: true + login: + description: + - The login name to authenticate on the vSphere cluster. + required: true + password: + description: + - The password to authenticate on the vSphere cluster. + required: true + guest: + description: + - The virtual server to gather facts for on the vSphere cluster. + required: true +examples: + - code: | + local_action: vsphere_facts host=$esxserver login=$esxlogin password=$esxpassword guest=$inventory_hostname_short + only_if: "'$cmdb_hwmodel'.startswith('VMWare ') + description: Task to gather facts from a vSphere cluster only if the system is a VMWare guest + - code: + - hw_eth0: + - addresstype: "assigned" + label: "Network adapter 1" + macaddress: "00:11:22:33:44:55" + macaddress_dash: "00-11-22-33-44-55" + summary: "VLAN-321" + hw_guest_full_name: "Red Hat Enterprise Linux 6 (64-bit)" + hw_guest_id: "rhel6_64Guest" + hw_memtotal_mb: 2048 + hw_name: "centos6" + hw_processor_count: 1 + hw_product_uuid: "ef50bac8-2845-40ff-81d9-675315501dac" + description: Typical output of a vsphere_facts run on a guest +notes: + - This module ought to be run from a system that can access vSphere directly. + Either by using C(local_action), or C(using delegate)_to. +''' + +import sys +try: + import pysphere +except ImportError: + print "failed=True msg='pysphere python module unavailable'" + sys.exit(1) + +def main(): + + module = AnsibleModule( + argument_spec=dict( + host = dict(required=True), + login = dict(required=True), + password = dict(required=True), + guest = dict(required=True), + ) + ) + + host = module.params['host'] + login = module.params['login'] + password = module.params['password'] + guest = module.params['guest'] + + server = pysphere.VIServer() + try: +# server.connect(host, login, password, trace_file='debug.txt') + server.connect(host, login, password) + except Exception, e: + module.fail_json(rc=1, msg='Failed to connect to %s: %s' % (host, e)) + + try: + vm = server.get_vm_by_name(guest) + except pysphere.resources.vi_exception.VIException, e: + module.fail_json(rc=2, msg=e.message) + + data = vm.get_properties() + facts = { + 'hw_name': vm.properties.name, + 'hw_guest_full_name': vm.properties.config.guestFullName, + 'hw_guest_id': vm.properties.config.guestId, + 'hw_product_uuid': vm.properties.config.uuid, + 'hw_processor_count': vm.properties.config.hardware.numCPU, + 'hw_memtotal_mb': vm.properties.config.hardware.memoryMB, + } + + ifidx = 0 + for entry in vm.properties.config.hardware.device: + + if not hasattr(entry, 'macAddress'): continue + + factname = 'hw_eth' + str(ifidx) + facts[factname] = { + 'addresstype': entry.addressType, + 'label': entry.deviceInfo.label, + 'macaddress': entry.macAddress, + 'macaddress_dash': entry.macAddress.replace(':', '-'), + 'summary': entry.deviceInfo.summary, + } + + ifidx += 1 + + module.exit_json(ansible_facts=facts) + +# this is magic, see lib/ansible/module_common.py +#<> +main()