#!/usr/bin/python # -*- coding: utf-8 -*- # Copyright: (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 DOCUMENTATION = """ module: eos_interface author: Ganesh Nalawade (@ganeshrn) short_description: (deprecated, removed after 2022-06-01) Manage Interface on Arista EOS network devices description: - This module provides declarative management of Interfaces on Arista EOS network devices. version_added: 1.0.0 deprecated: alternative: eos_interfaces why: Updated modules released with more functionality removed_at_date: '2022-06-01' notes: - Tested against EOS 4.15 options: name: description: - Name of the Interface to be configured on remote device. The name of interface should be in expanded format and not abbreviated. type: str description: description: - Description of Interface upto 240 characters. type: str enabled: description: - Interface link status. If the value is I(True) the interface state will be enabled, else if value is I(False) interface will be in disable (shutdown) state. default: true type: bool speed: description: - This option configures autoneg and speed/duplex/flowcontrol for the interface given in C(name) option. type: str mtu: description: - Set maximum transmission unit size in bytes of transmit packet for the interface given in C(name) option. type: str tx_rate: description: - Transmit rate in bits per second (bps) for the interface given in C(name) option. - This is state check parameter only. - Supports conditionals, see L(Conditionals in Networking Modules,../network/user_guide/network_working_with_command_output.html) type: str rx_rate: description: - Receiver rate in bits per second (bps) for the interface given in C(name) option. - This is state check parameter only. - Supports conditionals, see L(Conditionals in Networking Modules,../network/user_guide/network_working_with_command_output.html) type: str neighbors: description: - Check the operational state of given interface C(name) for LLDP neighbor. - The following suboptions are available. type: list elements: dict suboptions: host: description: - LLDP neighbor host for given interface C(name). type: str port: description: - LLDP neighbor port to which given interface C(name) is connected. type: str aggregate: description: - List of Interfaces definitions. Each of the entry in aggregate list should define name of interface C(name) and other options as required. type: list elements: dict suboptions: name: description: - Name of the Interface to be configured on remote device. The name of interface should be in expanded format and not abbreviated. type: str required: true description: description: - Description of Interface upto 240 characters. type: str enabled: description: - Interface link status. If the value is I(True) the interface state will be enabled, else if value is I(False) interface will be in disable (shutdown) state. type: bool speed: description: - This option configures autoneg and speed/duplex/flowcontrol for the interface given in C(name) option. type: str mtu: description: - Set maximum transmission unit size in bytes of transmit packet for the interface given in C(name) option. type: str tx_rate: description: - Transmit rate in bits per second (bps) for the interface given in C(name) option. - This is state check parameter only. - Supports conditionals, see L(Conditionals in Networking Modules,../network/user_guide/network_working_with_command_output.html) type: str rx_rate: description: - Receiver rate in bits per second (bps) for the interface given in C(name) option. - This is state check parameter only. - Supports conditionals, see L(Conditionals in Networking Modules,../network/user_guide/network_working_with_command_output.html) type: str neighbors: description: - Check the operational state of given interface C(name) for LLDP neighbor. - The following suboptions are available. type: list elements: dict suboptions: host: description: - LLDP neighbor host for given interface C(name). type: str port: description: - LLDP neighbor port to which given interface C(name) is connected. type: str delay: description: - Time in seconds to wait before checking for the operational state on remote device. This wait is applicable for operational state argument which are I(state) with values C(up)/C(down), I(tx_rate) and I(rx_rate). default: 10 type: int state: description: - State of the Interface configuration, C(up) means present and operationally up and C(down) means present and operationally C(down) type: str choices: - present - absent - up - down delay: description: - Time in seconds to wait before checking for the operational state on remote device. This wait is applicable for operational state argument which are I(state) with values C(up)/C(down), I(tx_rate) and I(rx_rate). default: 10 type: int state: description: - State of the Interface configuration, C(up) means present and operationally up and C(down) means present and operationally C(down) default: present type: str choices: - present - absent - up - down extends_documentation_fragment: - arista.eos.eos """ EXAMPLES = """ - name: configure interface arista.eos.eos_interface: name: ethernet1 description: test-interface speed: 100full mtu: 512 - name: remove interface arista.eos.eos_interface: name: ethernet1 state: absent - name: make interface up arista.eos.eos_interface: name: ethernet1 enabled: true - name: make interface down arista.eos.eos_interface: name: ethernet1 enabled: false - name: Check intent arguments arista.eos.eos_interface: name: ethernet1 state: up tx_rate: ge(0) rx_rate: le(0) - name: Check neighbors intent arguments arista.eos.eos_interface: name: ethernet1 neighbors: - port: eth0 host: netdev - name: Configure interface in disabled state and check if the operational state is disabled or not arista.eos.eos_interface: name: ethernet1 enabled: false state: down - name: Add interface using aggregate arista.eos.eos_interface: aggregate: - {name: ethernet1, mtu: 256, description: test-interface-1} - {name: ethernet2, mtu: 516, description: test-interface-2} speed: 100full state: present - name: Delete interface using aggregate arista.eos.eos_interface: aggregate: - name: loopback9 - name: loopback10 state: absent """ RETURN = """ commands: description: The list of configuration mode commands to send to the device. returned: always, except for the platforms that use Netconf transport to manage the device. type: list sample: - interface ethernet1 - description test-interface - speed 100full - mtu 512 """ import re from copy import deepcopy from time import sleep from ansible.module_utils.basic import AnsibleModule from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.config import ( NetworkConfig, ) from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.utils import ( conditional, remove_default_spec, ) from ansible_collections.arista.eos.plugins.module_utils.network.eos.eos import ( get_config, load_config, run_commands, ) from ansible_collections.arista.eos.plugins.module_utils.network.eos.eos import ( eos_argument_spec, ) def validate_mtu(value, module): if value and not 68 <= int(value) <= 65535: module.fail_json(msg="mtu must be between 68 and 65535") def validate_param_values(module, obj, param=None): if param is None: param = module.params for key in obj: # validate the param value (if validator func exists) validator = globals().get("validate_%s" % key) if callable(validator): validator(param.get(key), module) def parse_shutdown(configobj, name): cfg = configobj["interface %s" % name] cfg = "\n".join(cfg.children) match = re.search(r"shutdown", cfg, re.M) return bool(match) def parse_config_argument(configobj, name, arg=None): cfg = configobj["interface %s" % name] cfg = "\n".join(cfg.children) match = re.search(r"%s (.+)$" % arg, cfg, re.M) if match: return match.group(1) def search_obj_in_list(name, lst): for o in lst: if o["name"] == name: return o return None def add_command_to_interface(interface, cmd, commands): if interface not in commands: commands.append(interface) commands.append(cmd) def map_config_to_obj(module): config = get_config(module) configobj = NetworkConfig(indent=3, contents=config) match = re.findall(r"^interface (\S+)", config, re.M) if not match: return list() instances = list() for item in set(match): obj = { "name": item.lower(), "description": parse_config_argument( configobj, item, "description" ), "speed": parse_config_argument(configobj, item, "speed"), "mtu": parse_config_argument(configobj, item, "mtu"), "disable": parse_shutdown(configobj, item), "state": "present", } instances.append(obj) return instances def map_params_to_obj(module): obj = [] aggregate = module.params.get("aggregate") if aggregate: for item in aggregate: for key in item: if item.get(key) is None: item[key] = module.params[key] item["name"] = item["name"].lower() validate_param_values(module, item, item) d = item.copy() if d["enabled"]: d["disable"] = False else: d["disable"] = True obj.append(d) else: params = { "name": module.params["name"].lower(), "description": module.params["description"], "speed": module.params["speed"], "mtu": module.params["mtu"], "state": module.params["state"], "delay": module.params["delay"], "tx_rate": module.params["tx_rate"], "rx_rate": module.params["rx_rate"], "neighbors": module.params["neighbors"], } validate_param_values(module, params) if module.params["enabled"]: params.update({"disable": False}) else: params.update({"disable": True}) obj.append(params) return obj def map_obj_to_commands(updates, modules): commands = list() want, have = updates args = ("speed", "description", "mtu") for w in want: name = w["name"] disable = w["disable"] state = w["state"] obj_in_have = search_obj_in_list(name, have) interface = "interface " + name if state == "absent" and obj_in_have: commands.append("no " + interface) elif state in ("present", "up", "down"): if obj_in_have: for item in args: candidate = w.get(item) running = obj_in_have.get(item) if candidate != running: if candidate: cmd = "{0} {1}".format(item, candidate) add_command_to_interface(interface, cmd, commands) if disable and not obj_in_have.get("disable", False): add_command_to_interface(interface, "shutdown", commands) elif not disable and obj_in_have.get("disable", False): add_command_to_interface( interface, "no shutdown", commands ) else: commands.append(interface) for item in args: value = w.get(item) if value: commands.append("{0} {1}".format(item, value)) if disable: commands.append("no shutdown") return commands def check_declarative_intent_params(module, want, result): failed_conditions = [] have_neighbors = None for w in want: want_state = w.get("state") want_tx_rate = w.get("tx_rate") want_rx_rate = w.get("rx_rate") want_neighbors = w.get("neighbors") if ( want_state not in ("up", "down") and not want_tx_rate and not want_rx_rate and not want_neighbors ): continue if result["changed"]: sleep(w["delay"]) command = { "command": "show interfaces %s" % w["name"], "output": "text", } output = run_commands(module, [command]) if want_state in ("up", "down"): match = re.search( r"%s (\w+)" % "line protocol is", output[0], re.M ) have_state = None if match: have_state = match.group(1) if have_state is None or not conditional( want_state, have_state.strip() ): failed_conditions.append("state " + "eq(%s)" % want_state) if want_tx_rate: match = re.search(r"%s (\d+)" % "output rate", output[0], re.M) have_tx_rate = None if match: have_tx_rate = match.group(1) if have_tx_rate is None or not conditional( want_tx_rate, have_tx_rate.strip(), cast=int ): failed_conditions.append("tx_rate " + want_tx_rate) if want_rx_rate: match = re.search(r"%s (\d+)" % "input rate", output[0], re.M) have_rx_rate = None if match: have_rx_rate = match.group(1) if have_rx_rate is None or not conditional( want_rx_rate, have_rx_rate.strip(), cast=int ): failed_conditions.append("rx_rate " + want_rx_rate) if want_neighbors: have_host = [] have_port = [] if have_neighbors is None: command = { "command": "show lldp neighbors {0}".format(w["name"]), "output": "text", } have_neighbors = run_commands(module, [command]) if have_neighbors[0]: lines = have_neighbors[0].strip().split("\n") col = None for index, line in enumerate(lines): if re.search( r"^Port\s+Neighbor Device ID\s+Neighbor Port ID\s+TTL", line, ): col = index break if col and col < len(lines) - 1: idx = col + 1 for items in lines[idx:]: value = re.split(r"\s+", items) try: have_port.append(value[2]) have_host.append(value[1]) except IndexError: pass for item in want_neighbors: host = item.get("host") port = item.get("port") if host and host not in have_host: failed_conditions.append("host " + host) if port and port not in have_port: failed_conditions.append("port " + port) return failed_conditions def main(): """ main entry point for module execution """ neighbors_spec = dict(host=dict(), port=dict()) element_spec = dict( name=dict(), description=dict(), speed=dict(), mtu=dict(), enabled=dict(default=True, type="bool"), tx_rate=dict(), rx_rate=dict(), neighbors=dict(type="list", elements="dict", options=neighbors_spec), delay=dict(default=10, type="int"), state=dict( default="present", choices=["present", "absent", "up", "down"] ), ) aggregate_spec = deepcopy(element_spec) aggregate_spec["name"] = dict(required=True) # remove default in aggregate spec, to handle common arguments remove_default_spec(aggregate_spec) aggregate_spec["delay"].update(default=10) argument_spec = dict( aggregate=dict(type="list", elements="dict", options=aggregate_spec) ) argument_spec.update(element_spec) argument_spec.update(eos_argument_spec) required_one_of = [["name", "aggregate"]] mutually_exclusive = [["name", "aggregate"]] module = AnsibleModule( argument_spec=argument_spec, required_one_of=required_one_of, mutually_exclusive=mutually_exclusive, supports_check_mode=True, ) warnings = list() result = {"changed": False} if warnings: result["warnings"] = warnings want = map_params_to_obj(module) have = map_config_to_obj(module) commands = map_obj_to_commands((want, have), module) result["commands"] = commands if commands: commit = not module.check_mode response = load_config(module, commands, commit=commit) if response.get("diff") and module._diff: result["diff"] = {"prepared": response.get("diff")} result["session_name"] = response.get("session") result["changed"] = True failed_conditions = check_declarative_intent_params(module, want, result) if failed_conditions: msg = "One or more conditional statements have not been satisfied" module.fail_json(msg=msg, failed_conditions=failed_conditions) module.exit_json(**result) if __name__ == "__main__": main()