mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-05-25 02:19:10 -07:00
e2cac8cc93
Some users have problems using the VMware modules because they use the vCenter as target, and Ansible uses SSH to connect to the targets. Eventually we need to update the VMware guide to explain how the modules work, but the first fix is to update the examples. (We should backport to v2.6 and v2.5 too)
128 lines
4 KiB
Python
128 lines
4 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2018, Abhijeet Kasurde <akasurde@redhat.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 = r'''
|
|
---
|
|
module: vmware_host_dns_facts
|
|
short_description: Gathers facts about an ESXi host's DNS configuration information
|
|
description:
|
|
- This module can be used to gather facts about an ESXi host's DNS configuration information when ESXi hostname or Cluster name is given.
|
|
- All parameters and VMware object names are case sensitive.
|
|
version_added: '2.5'
|
|
author:
|
|
- Abhijeet Kasurde (@Akasurde)
|
|
notes:
|
|
- Tested on vSphere 6.5
|
|
requirements:
|
|
- python >= 2.6
|
|
- PyVmomi
|
|
options:
|
|
cluster_name:
|
|
description:
|
|
- Name of the cluster from which the ESXi host belong to.
|
|
- If C(esxi_hostname) is not given, this parameter is required.
|
|
esxi_hostname:
|
|
description:
|
|
- ESXi hostname to gather facts from.
|
|
- If C(cluster_name) is not given, this parameter is required.
|
|
extends_documentation_fragment: vmware.documentation
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Gather DNS facts about all ESXi Hosts in given Cluster
|
|
vmware_host_dns_facts:
|
|
hostname: '{{ vcenter_hostname }}'
|
|
username: '{{ vcenter_username }}'
|
|
password: '{{ vcenter_password }}'
|
|
cluster_name: cluster_name
|
|
delegate_to: localhost
|
|
|
|
- name: Gather DNS facts about ESXi Host
|
|
vmware_host_dns_facts:
|
|
hostname: '{{ vcenter_hostname }}'
|
|
username: '{{ vcenter_username }}'
|
|
password: '{{ vcenter_password }}'
|
|
esxi_hostname: '{{ esxi_hostname }}'
|
|
delegate_to: localhost
|
|
'''
|
|
|
|
RETURN = r'''
|
|
hosts_dns_facts:
|
|
description: metadata about DNS config from given cluster / host system
|
|
returned: always
|
|
type: dict
|
|
sample: {
|
|
"DC0_C0_H0": {
|
|
"dhcp": true,
|
|
"domain_name": "localdomain",
|
|
"host_name": "localhost",
|
|
"ip_address": [
|
|
"8.8.8.8"
|
|
],
|
|
"search_doamin": [
|
|
"localdomain"
|
|
],
|
|
"virtual_nic_device": "vmk0"
|
|
}
|
|
}
|
|
'''
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible.module_utils.vmware import vmware_argument_spec, PyVmomi
|
|
|
|
|
|
class VmwareDnsFactsManager(PyVmomi):
|
|
def __init__(self, module):
|
|
super(VmwareDnsFactsManager, self).__init__(module)
|
|
cluster_name = self.params.get('cluster_name', None)
|
|
esxi_host_name = self.params.get('esxi_hostname', None)
|
|
self.hosts = self.get_all_host_objs(cluster_name=cluster_name, esxi_host_name=esxi_host_name)
|
|
|
|
def gather_dns_facts(self):
|
|
hosts_facts = {}
|
|
for host in self.hosts:
|
|
host_facts = {}
|
|
dns_config = host.config.network.dnsConfig
|
|
host_facts['dhcp'] = dns_config.dhcp
|
|
host_facts['virtual_nic_device'] = dns_config.virtualNicDevice
|
|
host_facts['host_name'] = dns_config.hostName
|
|
host_facts['domain_name'] = dns_config.domainName
|
|
host_facts['ip_address'] = [ip for ip in dns_config.address]
|
|
host_facts['search_doamin'] = [domain for domain in dns_config.searchDomain]
|
|
hosts_facts[host.name] = host_facts
|
|
return hosts_facts
|
|
|
|
|
|
def main():
|
|
argument_spec = vmware_argument_spec()
|
|
argument_spec.update(
|
|
cluster_name=dict(type='str', required=False),
|
|
esxi_hostname=dict(type='str', required=False),
|
|
)
|
|
|
|
module = AnsibleModule(
|
|
argument_spec=argument_spec,
|
|
required_one_of=[
|
|
['cluster_name', 'esxi_hostname'],
|
|
]
|
|
)
|
|
|
|
vmware_dns_config = VmwareDnsFactsManager(module)
|
|
module.exit_json(changed=False, hosts_dns_facts=vmware_dns_config.gather_dns_facts())
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|