mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Add ios_lldp module (#34308)
* Add ios_lldp module * Implementation of ios_lldp module * Integration test for ios_lldp module * Minor change
This commit is contained in:
parent
3681d0e3e0
commit
48f20a77af
8 changed files with 200 additions and 1 deletions
|
@ -17,7 +17,7 @@ DOCUMENTATION = """
|
|||
module: ios_l3_interface
|
||||
version_added: "2.5"
|
||||
author: "Ganesh Nalawade (@ganeshrn)"
|
||||
short_description: Manage L3 interfaces on IOS network devices.
|
||||
short_description: Manage L3 interfaces on Cisco IOS network devices.
|
||||
description:
|
||||
- This module provides declarative management of L3 interfaces
|
||||
on IOS network devices.
|
||||
|
|
111
lib/ansible/modules/network/ios/ios_lldp.py
Normal file
111
lib/ansible/modules/network/ios/ios_lldp.py
Normal file
|
@ -0,0 +1,111 @@
|
|||
#!/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: ios_lldp
|
||||
version_added: "2.5"
|
||||
author: "Ganesh Nalawade (@ganeshrn)"
|
||||
short_description: Manage LLDP configuration on Cisco IOS network devices.
|
||||
description:
|
||||
- This module provides declarative management of LLDP service
|
||||
on Cisco IOS network devices.
|
||||
notes:
|
||||
- Tested against IOS 15.2
|
||||
options:
|
||||
state:
|
||||
description:
|
||||
- State of the LLDP configuration. If value is I(present) lldp will be enabled
|
||||
else if it is I(absent) it will be disabled.
|
||||
default: present
|
||||
choices: ['present', 'absent']
|
||||
"""
|
||||
|
||||
EXAMPLES = """
|
||||
- name: Enable LLDP service
|
||||
ios_lldp:
|
||||
state: present
|
||||
|
||||
- name: Disable LLDP service
|
||||
ios_lldp:
|
||||
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:
|
||||
- lldp run
|
||||
"""
|
||||
from ansible.module_utils.basic import AnsibleModule
|
||||
from ansible.module_utils.network.ios.ios import get_config, load_config, run_commands
|
||||
from ansible.module_utils.network.ios.ios import ios_argument_spec
|
||||
|
||||
|
||||
def has_lldp(module):
|
||||
output = run_commands(module, ['show lldp'])
|
||||
|
||||
is_lldp_enable = False
|
||||
if len(output) > 0 and "LLDP is not enabled" not in output[0]:
|
||||
is_lldp_enable = True
|
||||
|
||||
return is_lldp_enable
|
||||
|
||||
|
||||
def main():
|
||||
""" main entry point for module execution
|
||||
"""
|
||||
argument_spec = dict(
|
||||
state=dict(default='present',
|
||||
choices=['present', 'absent',
|
||||
'enabled', 'disabled'])
|
||||
)
|
||||
|
||||
argument_spec.update(ios_argument_spec)
|
||||
|
||||
module = AnsibleModule(argument_spec=argument_spec,
|
||||
supports_check_mode=True)
|
||||
|
||||
warnings = list()
|
||||
|
||||
result = {'changed': False}
|
||||
|
||||
if warnings:
|
||||
result['warnings'] = warnings
|
||||
|
||||
HAS_LLDP = has_lldp(module)
|
||||
|
||||
commands = []
|
||||
|
||||
if module.params['state'] == 'absent' and HAS_LLDP:
|
||||
commands.append('no lldp run')
|
||||
elif module.params['state'] == 'present' and not HAS_LLDP:
|
||||
commands.append('lldp run')
|
||||
|
||||
result['commands'] = commands
|
||||
|
||||
if commands:
|
||||
if not module.check_mode:
|
||||
load_config(module, commands)
|
||||
|
||||
result['changed'] = True
|
||||
|
||||
module.exit_json(**result)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
|
@ -112,6 +112,15 @@
|
|||
failed_modules: "{{ failed_modules }} + [ 'ios_l3_interface' ]"
|
||||
test_failed: true
|
||||
|
||||
- block:
|
||||
- include_role:
|
||||
name: ios_lldp
|
||||
when: "limit_to in ['*', 'ios_lldp']"
|
||||
rescue:
|
||||
- set_fact:
|
||||
failed_modules: "{{ failed_modules }} + [ 'ios_lldp' ]"
|
||||
test_failed: true
|
||||
|
||||
# - block:
|
||||
# - include_role:
|
||||
# name: ios_vlan
|
||||
|
|
2
test/integration/targets/ios_lldp/defaults/main.yaml
Normal file
2
test/integration/targets/ios_lldp/defaults/main.yaml
Normal file
|
@ -0,0 +1,2 @@
|
|||
---
|
||||
testcase: "*"
|
2
test/integration/targets/ios_lldp/meta/main.yaml
Normal file
2
test/integration/targets/ios_lldp/meta/main.yaml
Normal file
|
@ -0,0 +1,2 @@
|
|||
dependencies:
|
||||
- prepare_ios_tests
|
22
test/integration/targets/ios_lldp/tasks/cli.yaml
Normal file
22
test/integration/targets/ios_lldp/tasks/cli.yaml
Normal file
|
@ -0,0 +1,22 @@
|
|||
---
|
||||
- name: collect all cli test cases
|
||||
find:
|
||||
paths: "{{ role_path }}/tests/cli"
|
||||
patterns: "{{ testcase }}.yaml"
|
||||
register: test_cases
|
||||
delegate_to: localhost
|
||||
|
||||
- name: set test_items
|
||||
set_fact: test_items="{{ test_cases.files | map(attribute='path') | list }}"
|
||||
|
||||
- name: run test cases (connection=network_cli)
|
||||
include: "{{ test_case_to_run }} ansible_connection=network_cli ansible_become=yes"
|
||||
with_items: "{{ test_items }}"
|
||||
loop_control:
|
||||
loop_var: test_case_to_run
|
||||
|
||||
- name: run test case (connection=local)
|
||||
include: "{{ test_case_to_run }} ansible_connection=local"
|
||||
with_first_found: "{{ test_items }}"
|
||||
loop_control:
|
||||
loop_var: test_case_to_run
|
2
test/integration/targets/ios_lldp/tasks/main.yaml
Normal file
2
test/integration/targets/ios_lldp/tasks/main.yaml
Normal file
|
@ -0,0 +1,2 @@
|
|||
---
|
||||
- { include: cli.yaml, tags: ['cli'] }
|
51
test/integration/targets/ios_lldp/tests/cli/basic.yaml
Normal file
51
test/integration/targets/ios_lldp/tests/cli/basic.yaml
Normal file
|
@ -0,0 +1,51 @@
|
|||
---
|
||||
- debug: msg="START ios_lldp cli/basic.yaml on connection={{ ansible_connection }}"
|
||||
|
||||
- name: Make sure LLDP is not running before tests
|
||||
ios_config:
|
||||
lines: no lldp run
|
||||
authorize: yes
|
||||
|
||||
- name: Enable LLDP service
|
||||
ios_lldp:
|
||||
state: present
|
||||
authorize: yes
|
||||
register: result
|
||||
|
||||
- assert:
|
||||
that:
|
||||
- 'result.changed == true'
|
||||
- '"lldp run" in result.commands'
|
||||
|
||||
- name: Enable LLDP service again (idempotent)
|
||||
ios_lldp:
|
||||
state: present
|
||||
authorize: yes
|
||||
register: result
|
||||
|
||||
- assert:
|
||||
that:
|
||||
- 'result.changed == false'
|
||||
|
||||
- name: Disable LLDP service
|
||||
ios_lldp:
|
||||
state: absent
|
||||
authorize: yes
|
||||
register: result
|
||||
|
||||
- assert:
|
||||
that:
|
||||
- 'result.changed == true'
|
||||
- '"no lldp run" in result.commands'
|
||||
|
||||
- name: Disable LLDP service (idempotent)
|
||||
ios_lldp:
|
||||
state: absent
|
||||
authorize: yes
|
||||
register: result
|
||||
|
||||
- assert:
|
||||
that:
|
||||
- 'result.changed == false'
|
||||
|
||||
- debug: msg="END ios_lldp cli/basic.yaml on connection={{ ansible_connection }}"
|
Loading…
Reference in a new issue