mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-04-24 11:21:25 -07:00
ca56a248d8
* Add Routing Engine Facts - Map routing engine output information to routing_engines facts dict. - Add fact 'has_2RE', which is a quick way to determine how many REs the chassis has. * Fix a typo * Fix more typos * Add slot number to routing_engine dict * Add facts about the installed chassis modules * Fix typo * Fixed another typo * Fix Path * Change path again. * More Typos * Add some deubgging * Add additional information for hardware components. - Return information about the Routing Engines. - Return a fact to easily determine if the device has two routing engines. - Return information about the hardware modules. * Addressed pep8 stardard failures. * Add unit test fixtures. * Rename fixture. * Fix unit test failures. - Rename the fixture file to what the unit test expects. - Strip out junos namespace attributes. Rename file to match what the unit test expects. * Scrubbed the routing engine serial numbers. * Add unit test facts for new tests. - Add unit test for ansible_net_routing_engines fact - Add unit test for ansible_net_modules fact - Add unit test for ansible_net_has_2RE * Fixed spacing.
378 lines
11 KiB
Python
378 lines
11 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# (c) 2017, Ansible by Red Hat, inc
|
|
# 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': 'network'}
|
|
|
|
|
|
DOCUMENTATION = """
|
|
---
|
|
module: junos_facts
|
|
version_added: "2.1"
|
|
author: "Nathaniel Case (@qalthos)"
|
|
short_description: Collect facts from remote devices running Juniper Junos
|
|
description:
|
|
- Collects fact information from a remote device running the Junos
|
|
operating system. By default, the module will collect basic fact
|
|
information from the device to be included with the hostvars.
|
|
Additional fact information can be collected based on the
|
|
configured set of arguments.
|
|
extends_documentation_fragment: junos
|
|
options:
|
|
gather_subset:
|
|
description:
|
|
- When supplied, this argument will restrict the facts collected
|
|
to a given subset. Possible values for this argument include
|
|
all, hardware, config, and interfaces. Can specify a list of
|
|
values to include a larger subset. Values can also be used
|
|
with an initial C(M(!)) to specify that a specific subset should
|
|
not be collected. To maintain backward compatbility old style facts
|
|
can be retrieved using all value, this reqires junos-eznc to be installed
|
|
as a prerequisite.
|
|
required: false
|
|
default: "!config"
|
|
version_added: "2.3"
|
|
config_format:
|
|
description:
|
|
- The I(config_format) argument specifies the format of the configuration
|
|
when serializing output from the device. This argument is applicable
|
|
only when C(config) value is present in I(gather_subset).
|
|
The I(config_format) should be supported by the junos version running on
|
|
device.
|
|
required: false
|
|
default: text
|
|
choices: ['xml', 'set', 'text', 'json']
|
|
version_added: "2.3"
|
|
requirements:
|
|
- ncclient (>=v0.5.2)
|
|
notes:
|
|
- Ensure I(config_format) used to retrieve configuration from device
|
|
is supported by junos version running on device.
|
|
- This module requires the netconf system service be enabled on
|
|
the remote device being managed.
|
|
- Tested against vSRX JUNOS version 15.1X49-D15.4, vqfx-10000 JUNOS Version 15.1X53-D60.4.
|
|
"""
|
|
|
|
EXAMPLES = """
|
|
- name: collect default set of facts
|
|
junos_facts:
|
|
|
|
- name: collect default set of facts and configuration
|
|
junos_facts:
|
|
gather_subset: config
|
|
"""
|
|
|
|
RETURN = """
|
|
ansible_facts:
|
|
description: Returns the facts collect from the device
|
|
returned: always
|
|
type: dict
|
|
"""
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible.module_utils.junos import junos_argument_spec, check_args, get_param
|
|
from ansible.module_utils.junos import get_configuration
|
|
from ansible.module_utils.pycompat24 import get_exception
|
|
from ansible.module_utils.netconf import send_request
|
|
from ansible.module_utils.six import iteritems
|
|
|
|
|
|
try:
|
|
from lxml.etree import Element, SubElement, tostring
|
|
except ImportError:
|
|
from xml.etree.ElementTree import Element, SubElement, tostring
|
|
|
|
try:
|
|
from jnpr.junos import Device
|
|
from jnpr.junos.exception import ConnectError
|
|
HAS_PYEZ = True
|
|
except ImportError:
|
|
HAS_PYEZ = False
|
|
|
|
USE_PERSISTENT_CONNECTION = True
|
|
|
|
|
|
class FactsBase(object):
|
|
|
|
def __init__(self, module):
|
|
self.module = module
|
|
self.facts = dict()
|
|
|
|
def populate(self):
|
|
raise NotImplementedError
|
|
|
|
def cli(self, command):
|
|
reply = command(self.module, command)
|
|
output = reply.find('.//output')
|
|
if not output:
|
|
self.module.fail_json(msg='failed to retrieve facts for command %s' % command)
|
|
return str(output.text).strip()
|
|
|
|
def rpc(self, rpc):
|
|
return send_request(self.module, Element(rpc))
|
|
|
|
def get_text(self, ele, tag):
|
|
try:
|
|
return str(ele.find(tag).text).strip()
|
|
except AttributeError:
|
|
pass
|
|
|
|
|
|
class Default(FactsBase):
|
|
|
|
def populate(self):
|
|
reply = self.rpc('get-software-information')
|
|
data = reply.find('.//software-information')
|
|
|
|
self.facts.update({
|
|
'hostname': self.get_text(data, 'host-name'),
|
|
'version': self.get_text(data, 'junos-version'),
|
|
'model': self.get_text(data, 'product-model')
|
|
})
|
|
|
|
reply = self.rpc('get-chassis-inventory')
|
|
data = reply.find('.//chassis-inventory/chassis')
|
|
self.facts['serialnum'] = self.get_text(data, 'serial-number')
|
|
|
|
|
|
class Config(FactsBase):
|
|
|
|
def populate(self):
|
|
config_format = self.module.params['config_format']
|
|
reply = get_configuration(self.module, format=config_format)
|
|
|
|
if config_format == 'xml':
|
|
config = tostring(reply.find('configuration')).strip()
|
|
|
|
elif config_format == 'text':
|
|
config = self.get_text(reply, 'configuration-text')
|
|
|
|
elif config_format == 'json':
|
|
config = str(reply.text).strip()
|
|
|
|
elif config_format == 'set':
|
|
config = self.get_text(reply, 'configuration-set')
|
|
|
|
self.facts['config'] = config
|
|
|
|
|
|
class Hardware(FactsBase):
|
|
|
|
def populate(self):
|
|
|
|
reply = self.rpc('get-system-memory-information')
|
|
data = reply.find('.//system-memory-information/system-memory-summary-information')
|
|
|
|
self.facts.update({
|
|
'memfree_mb': int(self.get_text(data, 'system-memory-free')),
|
|
'memtotal_mb': int(self.get_text(data, 'system-memory-total'))
|
|
})
|
|
|
|
reply = self.rpc('get-system-storage')
|
|
data = reply.find('.//system-storage-information')
|
|
|
|
filesystems = list()
|
|
for obj in data:
|
|
filesystems.append(self.get_text(obj, 'filesystem-name'))
|
|
self.facts['filesystems'] = filesystems
|
|
|
|
reply = self.rpc('get-route-engine-information')
|
|
data = reply.find('.//route-engine-information')
|
|
|
|
routing_engines = dict()
|
|
for obj in data:
|
|
slot = self.get_text(obj, 'slot')
|
|
routing_engines.update({slot: {}})
|
|
routing_engines[slot].update({'slot': slot})
|
|
for child in obj:
|
|
if child.text != "\n":
|
|
routing_engines[slot].update({child.tag.replace("-", "_"): child.text})
|
|
|
|
self.facts['routing_engines'] = routing_engines
|
|
|
|
if len(data) > 1:
|
|
self.facts['has_2RE'] = True
|
|
else:
|
|
self.facts['has_2RE'] = False
|
|
|
|
reply = self.rpc('get-chassis-inventory')
|
|
data = reply.findall('.//chassis-module')
|
|
|
|
modules = list()
|
|
for obj in data:
|
|
mod = dict()
|
|
for child in obj:
|
|
if child.text != "\n":
|
|
mod.update({child.tag.replace("-", "_"): child.text})
|
|
modules.append(mod)
|
|
|
|
self.facts['modules'] = modules
|
|
|
|
|
|
class Interfaces(FactsBase):
|
|
|
|
def populate(self):
|
|
ele = Element('get-interface-information')
|
|
SubElement(ele, 'detail')
|
|
reply = send_request(self.module, ele)
|
|
|
|
interfaces = {}
|
|
|
|
for item in reply[0]:
|
|
name = self.get_text(item, 'name')
|
|
obj = {
|
|
'oper-status': self.get_text(item, 'oper-status'),
|
|
'admin-status': self.get_text(item, 'admin-status'),
|
|
'speed': self.get_text(item, 'speed'),
|
|
'macaddress': self.get_text(item, 'hardware-physical-address'),
|
|
'mtu': self.get_text(item, 'mtu'),
|
|
'type': self.get_text(item, 'if-type'),
|
|
}
|
|
|
|
interfaces[name] = obj
|
|
|
|
self.facts['interfaces'] = interfaces
|
|
|
|
|
|
class Facts(FactsBase):
|
|
def _connect(self, module):
|
|
host = get_param(module, 'host')
|
|
|
|
kwargs = {
|
|
'port': get_param(module, 'port') or 830,
|
|
'user': get_param(module, 'username')
|
|
}
|
|
|
|
if get_param(module, 'password'):
|
|
kwargs['passwd'] = get_param(module, 'password')
|
|
|
|
if get_param(module, 'ssh_keyfile'):
|
|
kwargs['ssh_private_key_file'] = get_param(module, 'ssh_keyfile')
|
|
|
|
kwargs['gather_facts'] = False
|
|
|
|
try:
|
|
device = Device(host, **kwargs)
|
|
device.open()
|
|
device.timeout = get_param(module, 'timeout') or 10
|
|
except ConnectError:
|
|
exc = get_exception()
|
|
module.fail_json('unable to connect to %s: %s' % (host, str(exc)))
|
|
|
|
return device
|
|
|
|
def populate(self):
|
|
|
|
device = self._connect(self.module)
|
|
facts = dict(device.facts)
|
|
|
|
if '2RE' in facts:
|
|
facts['has_2RE'] = facts['2RE']
|
|
del facts['2RE']
|
|
|
|
facts['version_info'] = dict(facts['version_info'])
|
|
if 'junos_info' in facts:
|
|
for key, value in facts['junos_info'].items():
|
|
if 'object' in value:
|
|
value['object'] = dict(value['object'])
|
|
|
|
return facts
|
|
|
|
FACT_SUBSETS = dict(
|
|
default=Default,
|
|
hardware=Hardware,
|
|
config=Config,
|
|
interfaces=Interfaces
|
|
)
|
|
|
|
VALID_SUBSETS = frozenset(FACT_SUBSETS.keys())
|
|
|
|
|
|
def main():
|
|
""" Main entry point for AnsibleModule
|
|
"""
|
|
argument_spec = dict(
|
|
gather_subset=dict(default=['!config'], type='list'),
|
|
config_format=dict(default='text', choices=['xml', 'text', 'set', 'json']),
|
|
)
|
|
|
|
argument_spec.update(junos_argument_spec)
|
|
|
|
module = AnsibleModule(argument_spec=argument_spec,
|
|
supports_check_mode=True)
|
|
|
|
warnings = list()
|
|
check_args(module, warnings)
|
|
|
|
gather_subset = module.params['gather_subset']
|
|
ofacts = False
|
|
|
|
runable_subsets = set()
|
|
exclude_subsets = set()
|
|
|
|
for subset in gather_subset:
|
|
if subset == 'all':
|
|
runable_subsets.update(VALID_SUBSETS)
|
|
ofacts = True
|
|
continue
|
|
|
|
if subset.startswith('!'):
|
|
subset = subset[1:]
|
|
if subset == 'all':
|
|
exclude_subsets.update(VALID_SUBSETS)
|
|
ofacts = False
|
|
continue
|
|
exclude = True
|
|
else:
|
|
exclude = False
|
|
|
|
if subset not in VALID_SUBSETS:
|
|
module.fail_json(msg='Subset must be one of [%s], got %s' %
|
|
(', '.join(VALID_SUBSETS), subset))
|
|
|
|
if exclude:
|
|
exclude_subsets.add(subset)
|
|
else:
|
|
runable_subsets.add(subset)
|
|
|
|
if not runable_subsets:
|
|
runable_subsets.update(VALID_SUBSETS)
|
|
|
|
runable_subsets.difference_update(exclude_subsets)
|
|
runable_subsets.add('default')
|
|
|
|
facts = dict()
|
|
facts['gather_subset'] = list(runable_subsets)
|
|
|
|
instances = list()
|
|
for key in runable_subsets:
|
|
instances.append(FACT_SUBSETS[key](module))
|
|
|
|
for inst in instances:
|
|
inst.populate()
|
|
facts.update(inst.facts)
|
|
|
|
ansible_facts = dict()
|
|
for key, value in iteritems(facts):
|
|
key = 'ansible_net_%s' % key
|
|
ansible_facts[key] = value
|
|
|
|
if ofacts:
|
|
if HAS_PYEZ:
|
|
ansible_facts.update(Facts(module).populate())
|
|
else:
|
|
warnings += ['junos-eznc is required to gather old style facts but does not appear to be installed. '
|
|
'It can be installed using `pip install junos-eznc`']
|
|
|
|
module.exit_json(ansible_facts=ansible_facts, warnings=warnings)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|