Server IP : 85.214.239.14 / Your IP : 18.118.1.63 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /lib/python3/dist-packages/ansible_collections/frr/frr/plugins/cliconf/ |
Upload File : |
# # (c) 2018 Red Hat Inc. # # 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 <http://www.gnu.org/licenses/>. # from __future__ import absolute_import, division, print_function __metaclass__ = type DOCUMENTATION = """ --- author: Ansible Networking Team (@ansible-network) name: frr short_description: Use frr cliconf to run command on Free Range Routing platform description: - This frr plugin provides low level abstraction apis for sending and receiving CLI commands from FRR network devices. version_added: "1.0.0" """ import json import re from ansible.errors import AnsibleConnectionFailure from ansible.module_utils._text import to_text from ansible.module_utils.common._collections_compat import Mapping 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_collections.ansible.netcommon.plugins.plugin_utils.cliconf_base import ( CliconfBase, enable_mode, ) class Cliconf(CliconfBase): def get_supported_protocols(self): supported_protocols = {} protocols = [ "bgp", "isis", "ospf", "ldp", "ospf6", "pim", "rip", "ripm", "zebra", ] daemons = self.get("show daemons") data = to_text(daemons, errors="surrogate_or_strict").strip() for item in protocols: supported_protocols[item] = True if item in data else False return supported_protocols def get_device_info(self): device_info = {} device_info["network_os"] = "frr" reply = self.get("show version") data = to_text(reply, errors="surrogate_or_strict").strip() match = re.search(r"FRRouting (\S+) \((\S+)\)", data) if match: device_info["network_os_version"] = match.group(1) if match.group(2): device_info["network_os_hostname"] = match.group(2) return device_info def get_option_values(self): return { "format": ["text"], "diff_match": ["line", "strict", "exact", "none"], "diff_replace": ["line", "block"], "output": [], } def get_device_operations(self): return { "supports_diff_replace": False, "supports_commit": False, "supports_rollback": False, "supports_defaults": False, "supports_onbox_diff": False, "supports_commit_comment": False, "supports_multiline_delimiter": False, "supports_diff_match": False, "supports_diff_ignore_lines": False, "supports_generate_diff": True, "supports_replace": False, } def get_capabilities(self): result = super(Cliconf, self).get_capabilities() result["rpc"] += ["get_diff", "run_commands"] result["device_operations"] = self.get_device_operations() result["supported_protocols"] = self.get_supported_protocols() result.update(self.get_option_values()) return json.dumps(result) def get_diff( self, candidate=None, running=None, diff_match="line", diff_ignore_lines=None, path=None, diff_replace="line", ): 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) candidate_obj.load(candidate) if running and diff_match != "none": # running configuration running_obj = NetworkConfig(indent=1, contents=running, ignore_lines=diff_ignore_lines) configdiffobjs = candidate_obj.difference( running_obj, path=path, match=diff_match, replace=diff_replace, ) else: configdiffobjs = candidate_obj.items diff["config_diff"] = dumps(configdiffobjs, "commands") if configdiffobjs else "" return diff @enable_mode def get_config(self, source="running", flags=None, format=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 source == "running": cmd = "show running-config " else: cmd = "show startup-config " cmd += " ".join(to_list(flags)) cmd = cmd.strip() return self.send_command(cmd) @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: 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, newline=True, 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, newline=newline, check_all=check_all, ) 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