mirror of
https://github.com/zahodi/ansible-mikrotik.git
synced 2025-06-21 01:25:47 +02:00
146 lines
3.4 KiB
Python
146 lines
3.4 KiB
Python
# -*- coding: utf-8 -*-
|
|
DOCUMENTATION = '''
|
|
module: mt_interface.py
|
|
author:
|
|
- "Shaun Smiley"
|
|
- "Valentin Gurmeza"
|
|
version_added: "2.4"
|
|
short_description: Manage mikrotik interfaces
|
|
requirements:
|
|
- mt_api
|
|
description:
|
|
- manage interfaces and settings
|
|
options:
|
|
hostname:
|
|
description:
|
|
- hotstname of mikrotik router
|
|
required: True
|
|
username:
|
|
description:
|
|
- username used to connect to mikrotik router
|
|
required: True
|
|
password:
|
|
description:
|
|
- password used for authentication to mikrotik router
|
|
required: True
|
|
parameter:
|
|
description:
|
|
- sub endpoint for mikrotik tool
|
|
required: True
|
|
options:
|
|
- ovpn-client
|
|
- ethernet
|
|
- vlan
|
|
- bridge
|
|
- bridge port
|
|
- bridge settings
|
|
settings:
|
|
description:
|
|
- All Mikrotik compatible parameters for this particular endpoint.
|
|
Any yes/no values must be enclosed in double quotes
|
|
required: True
|
|
state:
|
|
description:
|
|
- absent or present
|
|
required: Flase
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
- mt_interfaces:
|
|
hostname: "{{ inventory_hostname }}"
|
|
username: "{{ mt_user }}"
|
|
password: "{{ mt_pass }}"
|
|
parameter: "ethernet"
|
|
state: present
|
|
settings:
|
|
name: ether2
|
|
comment: Ansible controlled ether2
|
|
mtu: 1501
|
|
'''
|
|
|
|
from ansible.module_utils.mt_common import clean_params, MikrotikIdempotent
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
|
|
|
|
def main():
|
|
module = AnsibleModule(
|
|
argument_spec=dict(
|
|
hostname=dict(required=True),
|
|
username=dict(required=True),
|
|
password=dict(required=True, no_log=True),
|
|
settings=dict(required=True, type='dict'),
|
|
parameter=dict(
|
|
required=True,
|
|
choices=[
|
|
'ethernet',
|
|
'vlan',
|
|
'ovpn-client',
|
|
'bridge',
|
|
'bridge port',
|
|
'bridge settings'
|
|
],
|
|
type='str'
|
|
),
|
|
state=dict(
|
|
required = False,
|
|
choices = ['present', 'absent'],
|
|
type = 'str'
|
|
)
|
|
),
|
|
supports_check_mode=True
|
|
)
|
|
|
|
params = module.params
|
|
if params['parameter'] == 'bridge port':
|
|
params['parameter'] = 'bridge/port'
|
|
idempotent_parameter = "interface"
|
|
elif params['parameter'] == 'bridge settings':
|
|
params['parameter'] = 'bridge/settings'
|
|
idempotent_parameter = None
|
|
else:
|
|
idempotent_parameter = 'name'
|
|
|
|
mt_obj = MikrotikIdempotent(
|
|
hostname = params['hostname'],
|
|
username = params['username'],
|
|
password = params['password'],
|
|
state = params['state'],
|
|
desired_params = params['settings'],
|
|
idempotent_param = idempotent_parameter,
|
|
api_path = '/interface/' + str(params['parameter']),
|
|
check_mode = module.check_mode
|
|
)
|
|
|
|
# exit if login failed
|
|
if not mt_obj.login_success:
|
|
module.fail_json(
|
|
msg = mt_obj.failed_msg
|
|
)
|
|
|
|
# add, remove or edit things
|
|
mt_obj.sync_state()
|
|
|
|
if mt_obj.failed:
|
|
module.fail_json(
|
|
msg = mt_obj.failed_msg
|
|
)
|
|
elif mt_obj.changed:
|
|
module.exit_json(
|
|
failed=False,
|
|
changed=True,
|
|
msg=mt_obj.changed_msg,
|
|
diff={ "prepared": {
|
|
"old": mt_obj.old_params,
|
|
"new": mt_obj.new_params,
|
|
}},
|
|
)
|
|
else:
|
|
module.exit_json(
|
|
failed=False,
|
|
changed=False,
|
|
#msg='',
|
|
msg=params['settings'],
|
|
)
|
|
|
|
if __name__ == '__main__':
|
|
main()
|