mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Add new module mlnxos_protocol for enabling disabling protocols on MLNX-OS Mellanox network devices (#34286)
* Add new module mlnxos_protocol for enabling disabling protocols on MLNX-OS Mellanox network devices Signed-off-by: Samer Deeb <samerd@mellanox.com> * Fix Test Class name * Fix IP routing protocol support Signed-off-by: Samer Deeb <samerd@mellanox.com> * Add missing support for check_mode, and Fix documentation Signed-off-by: Samer Deeb <samerd@mellanox.com>
This commit is contained in:
Samer Deeb
John R Barker
parent
943107b1b9
commit
ad73bda323
3 changed files with 345 additions and 0 deletions
185
lib/ansible/modules/network/mlnxos/mlnxos_protocol.py
Normal file
185
lib/ansible/modules/network/mlnxos/mlnxos_protocol.py
Normal file
|
|
@ -0,0 +1,185 @@
|
|||
#!/usr/bin/python
|
||||
#
|
||||
# Copyright: 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
|
||||
|
||||
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
||||
'status': ['preview'],
|
||||
'supported_by': 'community'}
|
||||
|
||||
DOCUMENTATION = """
|
||||
---
|
||||
module: mlnxos_protocol
|
||||
version_added: "2.5"
|
||||
author: "Samer Deeb (@samerd)"
|
||||
short_description: Enables/Disables protocols on Mellanox MLNX-OS network devices
|
||||
description:
|
||||
- This module provides a mechanism for enabling and disabling protocols
|
||||
Mellanox on MLNX-OS network devices.
|
||||
notes:
|
||||
- Tested on MLNX-OS 3.6.4000
|
||||
options:
|
||||
mlag:
|
||||
description: MLAG protocol
|
||||
choices: ['enabled', 'disabled']
|
||||
magp:
|
||||
description: MAGP protocol
|
||||
choices: ['enabled', 'disabled']
|
||||
spanning_tree:
|
||||
description: Spanning Tree support
|
||||
choices: ['enabled', 'disabled']
|
||||
dcb_pfc:
|
||||
description: DCB priority flow control
|
||||
choices: ['enabled', 'disabled']
|
||||
igmp_snooping:
|
||||
description: IP IGMP snooping
|
||||
choices: ['enabled', 'disabled']
|
||||
lacp:
|
||||
description: LACP protocol
|
||||
choices: ['enabled', 'disabled']
|
||||
ip_l3:
|
||||
description: IP L3 support
|
||||
choices: ['enabled', 'disabled']
|
||||
ip_routing:
|
||||
description: IP routing support
|
||||
choices: ['enabled', 'disabled']
|
||||
lldp:
|
||||
description: LLDP protocol
|
||||
choices: ['enabled', 'disabled']
|
||||
bgp:
|
||||
description: BGP protocol
|
||||
choices: ['enabled', 'disabled']
|
||||
ospf:
|
||||
description: OSPF protocol
|
||||
choices: ['enabled', 'disabled']
|
||||
"""
|
||||
|
||||
EXAMPLES = """
|
||||
- name: enable protocols for MLAG
|
||||
mlnxos_protocol:
|
||||
lacp: enabled
|
||||
spanning_tree: disabled
|
||||
ip_routing: enabled
|
||||
mlag: enabled
|
||||
dcb_pfc: enabled
|
||||
"""
|
||||
|
||||
RETURN = """
|
||||
commands:
|
||||
description: The list of configuration mode commands to send to the device.
|
||||
returned: always
|
||||
type: list
|
||||
sample:
|
||||
- no spanning-tree
|
||||
- protocol mlag
|
||||
"""
|
||||
|
||||
from ansible.module_utils.basic import AnsibleModule
|
||||
from ansible.module_utils.six import iteritems
|
||||
|
||||
from ansible.module_utils.network.mlnxos.mlnxos import BaseMlnxosModule
|
||||
from ansible.module_utils.network.mlnxos.mlnxos import show_cmd
|
||||
|
||||
|
||||
class MlnxosProtocolModule(BaseMlnxosModule):
|
||||
|
||||
PROTOCOL_MAPPING = dict(
|
||||
mlag=dict(name="mlag", enable="protocol mlag",
|
||||
disable="no protocol mlag"),
|
||||
magp=dict(name="magp", enable="protocol magp",
|
||||
disable="no protocol magp"),
|
||||
spanning_tree=dict(name="spanning-tree", enable="spanning-tree",
|
||||
disable="no spanning-tree"),
|
||||
dcb_pfc=dict(name="priority-flow-control",
|
||||
enable="dcb priority-flow-control enable force",
|
||||
disable="no dcb priority-flow-control enable force"),
|
||||
igmp_snooping=dict(name="igmp-snooping", enable="ip igmp snooping",
|
||||
disable="no ip igmp snooping"),
|
||||
lacp=dict(name="lacp", enable="lacp", disable="no lacp"),
|
||||
ip_l3=dict(name="IP L3", enable="ip l3",
|
||||
disable="no ip l3"),
|
||||
ip_routing=dict(name="IP routing", enable="ip routing",
|
||||
disable="no ip routing"),
|
||||
lldp=dict(name="lldp", enable="lldp", disable="no lldp"),
|
||||
bgp=dict(name="bgp", enable="protocol bgp", disable="no protocol bgp"),
|
||||
ospf=dict(name="ospf", enable="protocol ospf",
|
||||
disable="no protocol ospf"),
|
||||
)
|
||||
|
||||
@classmethod
|
||||
def _get_element_spec(cls):
|
||||
element_spec = dict()
|
||||
for protocol in cls.PROTOCOL_MAPPING:
|
||||
element_spec[protocol] = dict(choices=['enabled', 'disabled'])
|
||||
return element_spec
|
||||
|
||||
def init_module(self):
|
||||
""" Ansible module initialization
|
||||
"""
|
||||
element_spec = self._get_element_spec()
|
||||
argument_spec = dict()
|
||||
argument_spec.update(element_spec)
|
||||
self._module = AnsibleModule(
|
||||
argument_spec=argument_spec,
|
||||
supports_check_mode=True
|
||||
)
|
||||
|
||||
def get_required_config(self):
|
||||
self._required_config = dict()
|
||||
module_params = self._module.params
|
||||
for key, val in iteritems(module_params):
|
||||
if key in self.PROTOCOL_MAPPING and val is not None:
|
||||
self._required_config[key] = val
|
||||
|
||||
def _get_protocols(self):
|
||||
return show_cmd(self._module, "show protocols")
|
||||
|
||||
def _get_ip_routing(self):
|
||||
return show_cmd(self._module, 'show ip routing | include "IP routing"',
|
||||
json_fmt=False)
|
||||
|
||||
def load_current_config(self):
|
||||
self._current_config = dict()
|
||||
protocols_config = self._get_protocols()
|
||||
if not protocols_config:
|
||||
protocols_config = dict()
|
||||
ip_config = self._get_ip_routing()
|
||||
if ip_config:
|
||||
lines = ip_config.split('\n')
|
||||
for line in lines:
|
||||
line = line.strip()
|
||||
line_attr = line.split(':')
|
||||
if len(line_attr) == 2:
|
||||
attr = line_attr[0].strip()
|
||||
val = line_attr[1].strip()
|
||||
protocols_config[attr] = val
|
||||
for protocol, protocol_metadata in iteritems(self.PROTOCOL_MAPPING):
|
||||
protocol_json_attr = protocol_metadata['name']
|
||||
val = protocols_config.get(protocol_json_attr, 'disabled')
|
||||
if val not in ('enabled', 'disabled'):
|
||||
val = 'enabled'
|
||||
self._current_config[protocol] = val
|
||||
|
||||
def generate_commands(self):
|
||||
for protocol, req_val in iteritems(self._required_config):
|
||||
protocol_metadata = self.PROTOCOL_MAPPING[protocol]
|
||||
curr_val = self._current_config.get(protocol, 'disabled')
|
||||
if curr_val != req_val:
|
||||
if req_val == 'disabled':
|
||||
command = protocol_metadata['disable']
|
||||
else:
|
||||
command = protocol_metadata['enable']
|
||||
self._commands.append(command)
|
||||
|
||||
|
||||
def main():
|
||||
""" main entry point for module execution
|
||||
"""
|
||||
MlnxosProtocolModule.main()
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
{
|
||||
"pim": "disabled",
|
||||
"dhcp-relay": "disabled",
|
||||
"igmp-snooping": "disabled",
|
||||
"lacp": "disabled",
|
||||
"ptp": "disabled",
|
||||
"lldp": "disabled",
|
||||
"isolation-group": "disabled",
|
||||
"bfd": "disabled",
|
||||
"openflow": "disabled",
|
||||
"telemetry": "disabled",
|
||||
"vrrp": "disabled",
|
||||
"spanning-tree": "rst",
|
||||
"mlag": "disabled",
|
||||
"magp": "disabled",
|
||||
"nve": "disabled",
|
||||
"Ethernet": "enabled",
|
||||
"IP L3": "enabled",
|
||||
"ets": "enabled",
|
||||
"sflow": "disabled",
|
||||
"dhcp-relay(v6)": "disabled",
|
||||
"dot1x": "disabled",
|
||||
"bgp": "disabled",
|
||||
"priority-flow-control": "disabled",
|
||||
"ospf": "disabled"
|
||||
}
|
||||
134
test/units/modules/network/mlnxos/test_mlnxos_protocols.py
Normal file
134
test/units/modules/network/mlnxos/test_mlnxos_protocols.py
Normal file
|
|
@ -0,0 +1,134 @@
|
|||
#
|
||||
# Copyright: Ansible Project
|
||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||
|
||||
# Make coding more python3-ish
|
||||
from __future__ import (absolute_import, division, print_function)
|
||||
__metaclass__ = type
|
||||
|
||||
from ansible.compat.tests.mock import patch
|
||||
from ansible.modules.network.mlnxos import mlnxos_protocol
|
||||
from units.modules.utils import set_module_args
|
||||
from .mlnxos_module import TestMlnxosModule, load_fixture
|
||||
|
||||
|
||||
class TestMlnxosProtocolModule(TestMlnxosModule):
|
||||
|
||||
module = mlnxos_protocol
|
||||
|
||||
def setUp(self):
|
||||
super(TestMlnxosProtocolModule, self).setUp()
|
||||
self.mock_get_config = patch.object(
|
||||
mlnxos_protocol.MlnxosProtocolModule,
|
||||
"_get_protocols")
|
||||
self.get_config = self.mock_get_config.start()
|
||||
|
||||
self.mock_get_ip_config = patch.object(
|
||||
mlnxos_protocol.MlnxosProtocolModule,
|
||||
"_get_ip_routing")
|
||||
self.get_ip_config = self.mock_get_ip_config.start()
|
||||
|
||||
self.mock_load_config = patch(
|
||||
'ansible.module_utils.network.mlnxos.mlnxos.load_config')
|
||||
self.load_config = self.mock_load_config.start()
|
||||
|
||||
def tearDown(self):
|
||||
super(TestMlnxosProtocolModule, self).tearDown()
|
||||
self.mock_get_config.stop()
|
||||
self.mock_load_config.stop()
|
||||
|
||||
def load_fixtures(self, commands=None, transport='cli'):
|
||||
config_file = 'mlnxos_protocols_show.cfg'
|
||||
self.get_config.return_value = load_fixture(config_file)
|
||||
self.load_config.return_value = None
|
||||
self.get_ip_config.return_value = "IP routing: enabled"
|
||||
|
||||
def test_mlag_enable(self):
|
||||
set_module_args(dict(mlag='enabled'))
|
||||
commands = ['protocol mlag']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_mlag_disable(self):
|
||||
set_module_args(dict(mlag='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_magp_enable(self):
|
||||
set_module_args(dict(magp='enabled'))
|
||||
commands = ['protocol magp']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_magp_disable(self):
|
||||
set_module_args(dict(magp='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_spanning_tree_enable(self):
|
||||
set_module_args(dict(spanning_tree='enabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_spanning_tree_disable(self):
|
||||
set_module_args(dict(spanning_tree='disabled'))
|
||||
commands = ['no spanning-tree']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_dcb_pfc_enable(self):
|
||||
set_module_args(dict(dcb_pfc='enabled'))
|
||||
commands = ['dcb priority-flow-control enable force']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_dcb_pfc_disable(self):
|
||||
set_module_args(dict(dcb_pfc='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_igmp_snooping_enable(self):
|
||||
set_module_args(dict(igmp_snooping='enabled'))
|
||||
commands = ['ip igmp snooping']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_igmp_snooping_disable(self):
|
||||
set_module_args(dict(igmp_snooping='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_lacp_enable(self):
|
||||
set_module_args(dict(lacp='enabled'))
|
||||
commands = ['lacp']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_lacp_disable(self):
|
||||
set_module_args(dict(lacp='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_ip_routing_enable(self):
|
||||
set_module_args(dict(ip_routing='enabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_ip_routing_disable(self):
|
||||
set_module_args(dict(ip_routing='disabled'))
|
||||
commands = ['no ip routing']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_lldp_enable(self):
|
||||
set_module_args(dict(lldp='enabled'))
|
||||
commands = ['lldp']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_lldp_disable(self):
|
||||
set_module_args(dict(lldp='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_bgp_enable(self):
|
||||
set_module_args(dict(bgp='enabled'))
|
||||
commands = ['protocol bgp']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_bgp_disable(self):
|
||||
set_module_args(dict(bgp='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
|
||||
def test_ospf_enable(self):
|
||||
set_module_args(dict(ospf='enabled'))
|
||||
commands = ['protocol ospf']
|
||||
self.execute_module(changed=True, commands=commands)
|
||||
|
||||
def test_ospf_disable(self):
|
||||
set_module_args(dict(ospf='disabled'))
|
||||
self.execute_module(changed=False)
|
||||
Loading…
Reference in a new issue