mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Adding ElementSW Network Interfaces Module (#43970)
* Adding ElementSW Network Interfaces Module
This commit is contained in:
Chris Archibald
John R Barker
parent
12c7656268
commit
6b0fa954f4
1 changed files with 297 additions and 0 deletions
|
|
@ -0,0 +1,297 @@
|
|||
#!/usr/bin/python
|
||||
# (c) 2018, NetApp, Inc
|
||||
# GNU General Public License v3.0+ (see COPYING or
|
||||
# https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||
|
||||
'''
|
||||
Element Software Node Network Interfaces - Bond 1G and 10G configuration
|
||||
'''
|
||||
from __future__ import absolute_import, division, print_function
|
||||
__metaclass__ = type
|
||||
|
||||
|
||||
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
||||
'status': ['preview'],
|
||||
'supported_by': 'community'}
|
||||
|
||||
|
||||
DOCUMENTATION = '''
|
||||
|
||||
module: na_elementsw_network_interfaces
|
||||
|
||||
short_description: NetApp Element Software Configure Node Network Interfaces
|
||||
extends_documentation_fragment:
|
||||
- netapp.solidfire
|
||||
version_added: '2.7'
|
||||
author: NetApp Ansible Team (ng-ansibleteam@netapp.com)
|
||||
description:
|
||||
- Configure Element SW Node Network Interfaces for Bond 1G and 10G IP address.
|
||||
|
||||
options:
|
||||
method:
|
||||
description:
|
||||
- Type of Method used to configure the interface.
|
||||
- method depends on other settings such as the use of a static IP address, which will change the method to static.
|
||||
- loopback - Used to define the IPv4 loopback interface.
|
||||
- manual - Used to define interfaces for which no configuration is done by default.
|
||||
- dhcp - May be used to obtain an IP address via DHCP.
|
||||
- static - Used to define Ethernet interfaces with statically allocated IPv4 addresses.
|
||||
choices: ['loopback', 'manual', 'dhcp', 'static']
|
||||
required: true
|
||||
|
||||
ip_address_1g:
|
||||
description:
|
||||
- IP address for the 1G network.
|
||||
required: true
|
||||
|
||||
ip_address_10g:
|
||||
description:
|
||||
- IP address for the 10G network.
|
||||
required: true
|
||||
|
||||
subnet_1g:
|
||||
description:
|
||||
- 1GbE Subnet Mask.
|
||||
required: true
|
||||
|
||||
subnet_10g:
|
||||
description:
|
||||
- 10GbE Subnet Mask.
|
||||
required: true
|
||||
|
||||
gateway_address_1g:
|
||||
description:
|
||||
- Router network address to send packets out of the local network.
|
||||
required: true
|
||||
|
||||
gateway_address_10g:
|
||||
description:
|
||||
- Router network address to send packets out of the local network.
|
||||
required: true
|
||||
|
||||
mtu_1g:
|
||||
description:
|
||||
- Maximum Transmission Unit for 1GbE, Largest packet size that a network protocol can transmit.
|
||||
- Must be greater than or equal to 1500 bytes.
|
||||
default: '1500'
|
||||
|
||||
mtu_10g:
|
||||
description:
|
||||
- Maximum Transmission Unit for 10GbE, Largest packet size that a network protocol can transmit.
|
||||
- Must be greater than or equal to 1500 bytes.
|
||||
default: '1500'
|
||||
|
||||
dns_nameservers:
|
||||
description:
|
||||
- List of addresses for domain name servers.
|
||||
|
||||
dns_search_domains:
|
||||
description:
|
||||
- List of DNS search domains.
|
||||
|
||||
bond_mode_1g:
|
||||
description:
|
||||
- Bond mode for 1GbE configuration.
|
||||
choices: ['ActivePassive', 'ALB', 'LACP']
|
||||
default: 'ActivePassive'
|
||||
|
||||
bond_mode_10g:
|
||||
description:
|
||||
- Bond mode for 10GbE configuration.
|
||||
choices: ['ActivePassive', 'ALB', 'LACP']
|
||||
default: 'ActivePassive'
|
||||
|
||||
lacp_1g:
|
||||
description:
|
||||
- Link Aggregation Control Protocol useful only if LACP is selected as the Bond Mode.
|
||||
- Slow - Packets are transmitted at 30 second intervals.
|
||||
- Fast - Packets are transmitted in 1 second intervals.
|
||||
choices: ['Fast', 'Slow']
|
||||
default: 'Slow'
|
||||
|
||||
lacp_10g:
|
||||
description:
|
||||
- Link Aggregation Control Protocol useful only if LACP is selected as the Bond Mode.
|
||||
- Slow - Packets are transmitted at 30 second intervals.
|
||||
- Fast - Packets are transmitted in 1 second intervals.
|
||||
choices: ['Fast', 'Slow']
|
||||
default: 'Slow'
|
||||
|
||||
virtual_network_tag:
|
||||
description:
|
||||
- This is the primary network tag. All nodes in a cluster have the same VLAN tag.
|
||||
|
||||
'''
|
||||
|
||||
EXAMPLES = """
|
||||
|
||||
- name: Set Node network interfaces configuration for Bond 1G and 10G properties
|
||||
tags:
|
||||
- elementsw_network_interfaces
|
||||
na_elementsw_network_interfaces:
|
||||
hostname: "{{ elementsw_hostname }}"
|
||||
username: "{{ elementsw_username }}"
|
||||
password: "{{ elementsw_password }}"
|
||||
method: static
|
||||
ip_address_1g: 10.226.109.68
|
||||
ip_address_10g: 10.226.201.72
|
||||
subnet_1g: 255.255.255.0
|
||||
subnet_10g: 255.255.255.0
|
||||
gateway_address_1g: 10.193.139.1
|
||||
gateway_address_10g: 10.193.140.1
|
||||
mtu_1g: 1500
|
||||
mtu_10g: 9000
|
||||
bond_mode_1g: ActivePassive
|
||||
bond_mode_10g: LACP
|
||||
lacp_10g: Fast
|
||||
"""
|
||||
|
||||
RETURN = """
|
||||
|
||||
msg:
|
||||
description: Success message
|
||||
returned: success
|
||||
type: string
|
||||
|
||||
"""
|
||||
import traceback
|
||||
|
||||
from ansible.module_utils.basic import AnsibleModule
|
||||
from ansible.module_utils._text import to_native
|
||||
import ansible.module_utils.netapp as netapp_utils
|
||||
|
||||
HAS_SF_SDK = netapp_utils.has_sf_sdk()
|
||||
|
||||
try:
|
||||
from solidfire.models import Network, NetworkConfig
|
||||
HAS_SF_SDK = True
|
||||
except:
|
||||
HAS_SF_SDK = False
|
||||
|
||||
|
||||
class ElementSWNetworkInterfaces(object):
|
||||
"""
|
||||
Element Software Network Interfaces - Bond 1G and 10G Network configuration
|
||||
"""
|
||||
|
||||
def __init__(self):
|
||||
self.argument_spec = netapp_utils.ontap_sf_host_argument_spec()
|
||||
self.argument_spec.update(dict(
|
||||
method=dict(required=True, type='str', choices=['loopback', 'manual', 'dhcp', 'static']),
|
||||
ip_address_1g=dict(required=True, type='str'),
|
||||
ip_address_10g=dict(required=True, type='str'),
|
||||
subnet_1g=dict(required=True, type='str'),
|
||||
subnet_10g=dict(required=True, type='str'),
|
||||
gateway_address_1g=dict(required=True, type='str'),
|
||||
gateway_address_10g=dict(required=True, type='str'),
|
||||
mtu_1g=dict(required=False, type='str', default='1500'),
|
||||
mtu_10g=dict(required=False, type='str', default='1500'),
|
||||
dns_nameservers=dict(required=False, type=list),
|
||||
dns_search_domains=dict(required=False, type=list),
|
||||
bond_mode_1g=dict(required=False, type='str', choices=['ActivePassive', 'ALB', 'LACP'], default='ActivePassive'),
|
||||
bond_mode_10g=dict(required=False, type='str', choices=['ActivePassive', 'ALB', 'LACP'], default='ActivePassive'),
|
||||
lacp_1g=dict(required=False, type='str', choices=['Fast', 'Slow'], default='Slow'),
|
||||
lacp_10g=dict(required=False, type='str', choices=['Fast', 'Slow'], default='Slow'),
|
||||
virtual_network_tag=dict(required=False, type='str')
|
||||
))
|
||||
|
||||
self.module = AnsibleModule(
|
||||
argument_spec=self.argument_spec,
|
||||
supports_check_mode=True
|
||||
)
|
||||
|
||||
input_params = self.module.params
|
||||
|
||||
self.method = input_params['method']
|
||||
self.ip_address_1g = input_params['ip_address_1g']
|
||||
self.ip_address_10g = input_params['ip_address_10g']
|
||||
self.subnet_1g = input_params['subnet_1g']
|
||||
self.subnet_10g = input_params['subnet_10g']
|
||||
self.gateway_address_1g = input_params['gateway_address_1g']
|
||||
self.gateway_address_10g = input_params['gateway_address_10g']
|
||||
self.mtu_1g = input_params['mtu_1g']
|
||||
self.mtu_10g = input_params['mtu_10g']
|
||||
self.dns_nameservers = input_params['dns_nameservers']
|
||||
self.dns_search_domains = input_params['dns_search_domains']
|
||||
self.bond_mode_1g = input_params['bond_mode_1g']
|
||||
self.bond_mode_10g = input_params['bond_mode_10g']
|
||||
self.lacp_1g = input_params['lacp_1g']
|
||||
self.lacp_10g = input_params['lacp_10g']
|
||||
self.virtual_network_tag = input_params['virtual_network_tag']
|
||||
|
||||
if HAS_SF_SDK is False:
|
||||
self.module.fail_json(msg="Unable to import the SolidFire Python SDK")
|
||||
else:
|
||||
self.sfe = netapp_utils.create_sf_connection(module=self.module, port=442)
|
||||
|
||||
def set_network_config(self):
|
||||
"""
|
||||
set network configuration
|
||||
"""
|
||||
try:
|
||||
self.sfe.set_network_config(network=self.network_object)
|
||||
except Exception as exception_object:
|
||||
self.module.fail_json(msg='Error network setting for node %s' % (to_native(exception_object)),
|
||||
exception=traceback.format_exc())
|
||||
|
||||
def get_network_params_object(self):
|
||||
"""
|
||||
Get Element SW Network object
|
||||
:description: get Network object
|
||||
|
||||
:return: NetworkConfig object
|
||||
:rtype: object(NetworkConfig object)
|
||||
"""
|
||||
try:
|
||||
bond_1g_network = NetworkConfig(method=self.method,
|
||||
address=self.ip_address_1g,
|
||||
netmask=self.subnet_1g,
|
||||
gateway=self.gateway_address_1g,
|
||||
mtu=self.mtu_1g,
|
||||
dns_nameservers=self.dns_nameservers,
|
||||
dns_search=self.dns_search_domains,
|
||||
bond_mode=self.bond_mode_1g,
|
||||
bond_lacp_rate=self.lacp_1g,
|
||||
virtual_network_tag=self.virtual_network_tag)
|
||||
bond_10g_network = NetworkConfig(method=self.method,
|
||||
address=self.ip_address_10g,
|
||||
netmask=self.subnet_10g,
|
||||
gateway=self.gateway_address_10g,
|
||||
mtu=self.mtu_10g,
|
||||
dns_nameservers=self.dns_nameservers,
|
||||
dns_search=self.dns_search_domains,
|
||||
bond_mode=self.bond_mode_10g,
|
||||
bond_lacp_rate=self.lacp_10g,
|
||||
virtual_network_tag=self.virtual_network_tag)
|
||||
network_object = Network(bond1_g=bond_1g_network,
|
||||
bond10_g=bond_10g_network)
|
||||
return network_object
|
||||
except Exception as e:
|
||||
self.module.fail_json(msg='Error with setting up network object for node 1G and 10G configuration : %s' % to_native(e),
|
||||
exception=to_native(e))
|
||||
|
||||
def apply(self):
|
||||
"""
|
||||
Check connection and initialize node with cluster ownership
|
||||
"""
|
||||
changed = False
|
||||
result_message = None
|
||||
self.network_object = self.get_network_params_object()
|
||||
if self.network_object is not None:
|
||||
self.set_network_config()
|
||||
changed = True
|
||||
else:
|
||||
result_message = "Skipping changes, No change requested"
|
||||
self.module.exit_json(changed=changed, msg=result_message)
|
||||
|
||||
|
||||
def main():
|
||||
"""
|
||||
Main function
|
||||
"""
|
||||
elementsw_network_interfaces = ElementSWNetworkInterfaces()
|
||||
elementsw_network_interfaces.apply()
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
Loading…
Reference in a new issue