FileMgr

✏️ /usr/lib/python3.9/site-packages/ansible_collections/community/network/plugins/cliconf/icx.py

✕ Tutup

# Copyright: (c) 2019, Ansible Project
# 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

DOCUMENTATION = '''
---
author: Ruckus Wireless (@Commscope)
name: icx
short_description: Use icx cliconf to run command on Ruckus ICX platform
description:
  - This icx plugin provides low level abstraction APIs for
    sending and receiving CLI commands from Ruckus ICX network devices.
'''

import re
import time
import json
import os

from itertools import chain
from ansible.errors import AnsibleConnectionFailure
from ansible.module_utils._text import to_text
from ansible.module_utils.six import iteritems
from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.config import NetworkConfig, dumps
from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.utils import to_list
from ansible.plugins.cliconf import CliconfBase, enable_mode
from ansible.module_utils.common._collections_compat import Mapping

class Cliconf(CliconfBase):

@enable_mode
    def get_config(self, source='running', flags=None, format=None, compare=None):
        if source not in ('running', 'startup'):
            raise ValueError("fetching configuration from %s is not supported" % source)

if format:
            raise ValueError("'format' value %s is not supported for get_config" % format)

if not flags:
            flags = []

if compare is False:
            return ''
        else:
            if source == 'running':
                cmd = 'show running-config '
            else:
                cmd = 'show configuration '

cmd += ' '.join(to_list(flags))
            cmd = cmd.strip()

return self.send_command(cmd)

def get_diff(self, candidate=None, running=None, diff_match='line', diff_ignore_lines=None, path=None, diff_replace='line'):
        """
        Generate diff between candidate and running configuration. If the
        remote host supports onbox diff capabilities ie. supports_onbox_diff in that case
        candidate and running configurations are not required to be passed as argument.
        In case if onbox diff capability is not supported candidate argument is mandatory
        and running argument is optional.
        :param candidate: The configuration which is expected to be present on remote host.
        :param running: The base configuration which is used to generate diff.
        :param diff_match: Instructs how to match the candidate configuration with current device configuration
                      Valid values are 'line', 'strict', 'exact', 'none'.
                      'line' - commands are matched line by line
                      'strict' - command lines are matched with respect to position
                      'exact' - command lines must be an equal match
                      'none' - will not compare the candidate configuration with the running configuration
        :param diff_ignore_lines: Use this argument to specify one or more lines that should be
                                  ignored during the diff.  This is used for lines in the configuration
                                  that are automatically updated by the system.  This argument takes
                                  a list of regular expressions or exact line matches.
        :param path: The ordered set of parents that uniquely identify the section or hierarchy
                     the commands should be checked against.  If the parents argument
                     is omitted, the commands are checked against the set of top
                    level or global commands.
        :param diff_replace: Instructs on the way to perform the configuration on the device.
                        If the replace argument is set to I(line) then the modified lines are
                        pushed to the device in configuration mode.  If the replace argument is
                        set to I(block) then the entire command block is pushed to the device in
                        configuration mode if any line is not correct.
        :return: Configuration diff in  json format.
               {
                   'config_diff': '',
                   'banner_diff': {}
               }

"""
        diff = {}
        device_operations = self.get_device_operations()
        option_values = self.get_option_values()

if candidate is None and device_operations['supports_generate_diff']:
            raise ValueError("candidate configuration is required to generate diff")

if diff_match not in option_values['diff_match']:
            raise ValueError("'match' value %s in invalid, valid values are %s" % (diff_match, ', '.join(option_values['diff_match'])))

if diff_replace not in option_values['diff_replace']:
            raise ValueError("'replace' value %s in invalid, valid values are %s" % (diff_replace, ', '.join(option_values['diff_replace'])))

# prepare candidate configuration
        candidate_obj = NetworkConfig(indent=1)
        want_src, want_banners = self._extract_banners(candidate)
        candidate_obj.load(want_src)

if running and diff_match != 'none':
            # running configuration
            have_src, have_banners = self._extract_banners(running)

running_obj = NetworkConfig(indent=1, contents=have_src, ignore_lines=diff_ignore_lines)
            configdiffobjs = candidate_obj.difference(running_obj, path=path, match=diff_match, replace=diff_replace)

else:
            configdiffobjs = candidate_obj.items
            have_banners = {}

diff['config_diff'] = dumps(configdiffobjs, 'commands') if configdiffobjs else ''

banners = self._diff_banners(want_banners, have_banners)
        diff['banner_diff'] = banners if banners else {}
        return diff

@enable_mode
    def edit_config(self, candidate=None, commit=True, replace=None, comment=None):
        resp = {}
        operations = self.get_device_operations()
        self.check_edit_config_capability(operations, candidate, commit, replace, comment)

results = []
        requests = []
        if commit:
            prompt = self._connection.get_prompt()
            if (b'(config-if' in prompt) or (b'(config' in prompt) or (b'(config-lag-if' in prompt):
                self.send_command('end')

self.send_command('configure terminal')

for line in to_list(candidate):
                if not isinstance(line, Mapping):
                    line = {'command': line}

cmd = line['command']
                if cmd != 'end' and cmd[0] != '!':
                    results.append(self.send_command(**line))
                    requests.append(cmd)

self.send_command('end')
        else:
            raise ValueError('check mode is not supported')

resp['request'] = requests
        resp['response'] = results
        return resp

def get(self, command=None, prompt=None, answer=None, sendonly=False, output=None, check_all=False):
        if not command:
            raise ValueError('must provide value of command to execute')
        if output:
            raise ValueError("'output' value %s is not supported for get" % output)

return self.send_command(command=command, prompt=prompt, answer=answer, sendonly=sendonly, check_all=check_all)

def scp(self, command=None, scp_user=None, scp_pass=None):
        if not command:
            raise ValueError('must provide value of command to execute')
        prompt = ["User name:", "Password:"]
        if scp_pass is None:
            answer = [scp_user, self._connection._play_context.password]
        else:
            answer = [scp_user, scp_pass]
        return self.send_command(command=command, prompt=prompt, answer=answer, sendonly=False, check_all=True)

def get_device_info(self):
        device_info = {}

device_info['network_os'] = 'icx'
        reply = self.get(command='show version')
        data = to_text(reply, errors='surrogate_or_strict').strip()

match = re.search(r'Version (\S+)', data)
        if match:
            device_info['network_os_version'] = match.group(1).strip(',')

match = re.search(r'^Cisco (.+) \(revision', data, re.M)
        if match:
            device_info['network_os_model'] = match.group(1)

match = re.search(r'^(.+) uptime', data, re.M)
        if match:
            device_info['network_os_hostname'] = match.group(1)

return device_info

def get_device_operations(self):
        return {
            'supports_diff_replace': True,
            'supports_commit': False,
            'supports_rollback': False,
            'supports_defaults': True,
            'supports_onbox_diff': False,
            'supports_commit_comment': False,
            'supports_multiline_delimiter': True,
            'supports_diff_match': True,
            'supports_diff_ignore_lines': True,
            'supports_generate_diff': True,
            'supports_replace': False
        }

def get_option_values(self):
        return {
            'format': ['text'],
            'diff_match': ['line', 'strict', 'exact', 'none'],
            'diff_replace': ['line', 'block'],
            'output': []
        }

def get_capabilities(self):
        result = dict()
        result['rpc'] = self.get_base_rpc() + ['edit_banner', 'get_diff', 'run_commands', 'get_defaults_flag']
        result['network_api'] = 'cliconf'
        result['device_operations'] = self.get_device_operations()
        result.update(self.get_option_values())
        return json.dumps(result)

def edit_banner(self, candidate=None, multiline_delimiter="@", commit=True):
        """
        Edit banner on remote device
        :param banners: Banners to be loaded in json format
        :param multiline_delimiter: Line delimiter for banner
        :param commit: Boolean value that indicates if the device candidate
               configuration should be  pushed in the running configuration or discarded.
        :param diff: Boolean flag to indicate if configuration that is applied on remote host should
                     generated and returned in response or not
        :return: Returns response of executing the configuration command received
             from remote host
        """
        resp = {}
        banners_obj = json.loads(candidate)
        results = []
        requests = []
        if commit:
            for key, value in iteritems(banners_obj):
                key += ' %s' % multiline_delimiter
                self.send_command('config terminal', sendonly=True)
                for cmd in [key, value, multiline_delimiter]:
                    obj = {'command': cmd, 'sendonly': True}
                    results.append(self.send_command(**obj))
                    requests.append(cmd)

self.send_command('end', sendonly=True)
                time.sleep(0.1)
                results.append(self.send_command('\n'))
                requests.append('\n')

resp['request'] = requests
        resp['response'] = results

return resp

def run_commands(self, commands=None, check_rc=True):
        if commands is None:
            raise ValueError("'commands' value is required")

responses = list()
        for cmd in to_list(commands):
            if not isinstance(cmd, Mapping):
                cmd = {'command': cmd}

output = cmd.pop('output', None)
            if output:
                raise ValueError("'output' value %s is not supported for run_commands" % output)

try:
                out = self.send_command(**cmd)
            except AnsibleConnectionFailure as e:
                if check_rc:
                    raise
                out = getattr(e, 'err', to_text(e))

responses.append(out)

return responses

def _extract_banners(self, config):
        banners = {}
        banner_cmds = re.findall(r'^banner (\w+)', config, re.M)
        for cmd in banner_cmds:
            regex = r'banner %s \$(.+?)(?=\$)' % cmd
            match = re.search(regex, config, re.S)
            if match:
                key = 'banner %s' % cmd
                banners[key] = match.group(1).strip()

for cmd in banner_cmds:
            regex = r'banner %s \$(.+?)(?=\$)' % cmd
            match = re.search(regex, config, re.S)
            if match:
                config = config.replace(str(match.group(1)), '')

config = re.sub(r'banner \w+ \$\$', '!! banner removed', config)
        return config, banners

def _diff_banners(self, want, have):
        candidate = {}
        for key, value in iteritems(want):
            if value != have.get(key):
                candidate[key] = value
        return candidate

Batal

⬅ plugins 19 item

Nama	Tipe	Ukuran	Diubah	Perm	Aksi
📁 __pycache__	dir	—	16/09/24 06:47	0755	📂
🐍 __init__.py	py	0 B	08/11/23 12:12	0644	✏️ ⬇
🐍 aireos.py	py	3.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 apconos.py	py	2.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 aruba.py	py	3.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ce.py	py	4.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 cnos.py	py	4.7 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 edgeos.py	py	3.9 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 edgeswitch.py	py	4.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 enos.py	py	3.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 eric_eccli.py	py	3.4 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 exos.py	py	9.8 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 icx.py	py	12.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ironware.py	py	3.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 netvisor.py	py	2.5 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 nos.py	py	3.8 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 slxos.py	py	3.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 voss.py	py	9.7 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 weos4.py	py	6.7 KB	08/11/23 12:12	0644	✏️ ⬇

✏️ Rename

🔑 Ubah Permission