mirror of
https://github.com/thegeeklab/ansible-later.git
synced 2024-07-06 09:00:58 +02:00
236 lines
6.5 KiB
Python
236 lines
6.5 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# (c) 2017, Simon Dodsley (simon@purestorage.com)
|
|
# 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 = r'''
|
|
---
|
|
module: purefa_host
|
|
version_added: '2.4'
|
|
short_description: Manage hosts on Pure Storage FlashArrays
|
|
description:
|
|
- Create, delete or modify hosts on Pure Storage FlashArrays.
|
|
author:
|
|
- Simon Dodsley (@sdodsley)
|
|
options:
|
|
host:
|
|
description:
|
|
- The name of the host.
|
|
required: true
|
|
state:
|
|
description:
|
|
- Define whether the host should exist or not.
|
|
- When removing host all connected volumes will be disconnected.
|
|
default: present
|
|
choices: [ absent, present ]
|
|
protocol:
|
|
description:
|
|
- Defines the host connection protocol for volumes.
|
|
default: iscsi
|
|
choices: [ fc, iscsi, mixed ]
|
|
wwns:
|
|
description:
|
|
- List of wwns of the host if protocol is fc or mixed.
|
|
iqn:
|
|
description:
|
|
- List of IQNs of the host if protocol is iscsi or mixed.
|
|
volume:
|
|
description:
|
|
- Volume name to map to the host.
|
|
personality:
|
|
description:
|
|
- Define which operating systen the host is. Recommend for
|
|
ActiveCluster integration
|
|
choices: ['hpux', 'vms', 'aix', 'esxi', 'solaris', 'hitachi-vsp', 'oracle-vm-server', '']
|
|
version_added: '2.7'
|
|
extends_documentation_fragment:
|
|
- purestorage.fa
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Create new AIX host
|
|
purefa_host:
|
|
host: foo
|
|
personaility: aix
|
|
fa_url: 10.10.10.2
|
|
api_token: e31060a7-21fc-e277-6240-25983c6c4592
|
|
|
|
- name: Delete host
|
|
purefa_host:
|
|
host: foo
|
|
fa_url: 10.10.10.2
|
|
api_token: e31060a7-21fc-e277-6240-25983c6c4592
|
|
state: absent
|
|
|
|
- name: Make host bar with wwn ports
|
|
purefa_host:
|
|
host: bar
|
|
protocol: fc
|
|
wwns:
|
|
- 00:00:00:00:00:00:00
|
|
- 11:11:11:11:11:11:11
|
|
fa_url: 10.10.10.2
|
|
api_token: e31060a7-21fc-e277-6240-25983c6c4592
|
|
|
|
- name: Make host bar with iSCSI ports
|
|
purefa_host:
|
|
host: bar
|
|
protocol: iscsi
|
|
iqn:
|
|
- iqn.1994-05.com.redhat:7d366003913
|
|
fa_url: 10.10.10.2
|
|
api_token: e31060a7-21fc-e277-6240-25983c6c4592
|
|
|
|
- name: Make mixed protocol host
|
|
purefa_host:
|
|
host: bar
|
|
protocol: mixed
|
|
iqn:
|
|
- iqn.1994-05.com.redhat:7d366003914
|
|
wwns:
|
|
- 00:00:00:00:00:00:01
|
|
- 11:11:11:11:11:11:12
|
|
fa_url: 10.10.10.2
|
|
api_token: e31060a7-21fc-e277-6240-25983c6c4592
|
|
|
|
- name: Map host foo to volume bar
|
|
purefa_host:
|
|
host: foo
|
|
volume: bar
|
|
fa_url: 10.10.10.2
|
|
api_token: e31060a7-21fc-e277-6240-25983c6c4592
|
|
'''
|
|
|
|
RETURN = r'''
|
|
'''
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible.module_utils.pure import get_system, purefa_argument_spec
|
|
|
|
|
|
AC_REQUIRED_API_VERSION = '1.14'
|
|
|
|
|
|
try:
|
|
from purestorage import purestorage
|
|
HAS_PURESTORAGE = True
|
|
except ImportError:
|
|
HAS_PURESTORAGE = False
|
|
|
|
|
|
def _set_host_initiators(module, array):
|
|
if module.params['protocol'] in ['iscsi', 'mixed']:
|
|
if module.params['iqn']:
|
|
array.set_host(module.params['host'],
|
|
addiqnlist=module.params['iqn'])
|
|
if module.params['protocol'] in ['fc', 'mixed']:
|
|
if module.params['wwns']:
|
|
array.set_host(module.params['host'],
|
|
addwwnlist=module.params['wwns'])
|
|
|
|
|
|
def _set_host_personality(module, array):
|
|
"""Set host personality. Only called when AC is supported"""
|
|
array.set_host(module.params['host'],
|
|
personality=module.params['personality'])
|
|
|
|
|
|
def get_host(module, array):
|
|
|
|
host = None
|
|
|
|
for hst in array.list_hosts():
|
|
if hst["name"] == module.params['host']:
|
|
host = hst
|
|
break
|
|
|
|
return host
|
|
|
|
|
|
def make_host(module, array):
|
|
changed = True
|
|
try:
|
|
array.create_host(module.params['host'])
|
|
_set_host_initiators(module, array)
|
|
api_version = array._list_available_rest_versions()
|
|
if AC_REQUIRED_API_VERSION in api_version:
|
|
_set_host_personality(module, array)
|
|
if module.params['volume']:
|
|
array.connect_host(module.params['host'], module.params['volume'])
|
|
except:
|
|
module.fail_json(msg='Host {0} creation failed.'.format(module.params['host']))
|
|
module.exit_json(changed=changed)
|
|
|
|
|
|
def update_host(module, array):
|
|
changed = False
|
|
api_version = array._list_available_rest_versions()
|
|
if AC_REQUIRED_API_VERSION in api_version:
|
|
try:
|
|
_set_host_personality(module, array)
|
|
changed = True
|
|
except:
|
|
module.fail_json(msg='Host {0} personality change failed'.format(module.params['host']))
|
|
module.exit_json(changed=changed)
|
|
|
|
|
|
def delete_host(module, array):
|
|
changed = True
|
|
if not module.check_mode:
|
|
for vol in array.list_host_connections(module.params['host']):
|
|
array.disconnect_host(module.params['host'], vol["vol"])
|
|
array.delete_host(module.params['host'])
|
|
module.exit_json(changed=changed)
|
|
|
|
|
|
def main():
|
|
argument_spec = purefa_argument_spec()
|
|
argument_spec.update(dict(
|
|
host=dict(type='str', required=True),
|
|
state=dict(type='str', default='present', choices=['absent', 'present']),
|
|
protocol=dict(type='str', default='iscsi', choices=['fc', 'iscsi', 'mixed']),
|
|
iqn=dict(type='list'),
|
|
wwns=dict(type='list'),
|
|
volume=dict(type='str'),
|
|
personality=dict(type='str', default='',
|
|
choices=['hpux', 'vms', 'aix', 'esxi', 'solaris',
|
|
'hitachi-vsp', 'oracle-vm-server', '']),
|
|
))
|
|
|
|
module = AnsibleModule(argument_spec, supports_check_mode=False)
|
|
|
|
if not HAS_PURESTORAGE:
|
|
module.fail_json(msg='purestorage sdk is required for this module in host')
|
|
|
|
state = module.params['state']
|
|
protocol = module.params['protocol']
|
|
array = get_system(module)
|
|
host = get_host(module, array)
|
|
|
|
if module.params['volume']:
|
|
try:
|
|
array.get_volume(module.params['volume'])
|
|
except:
|
|
module.fail_json(msg='Volume {} not found'.format(module.params['volume']))
|
|
|
|
if host is None and state == 'present':
|
|
make_host(module, array)
|
|
elif host and state == 'present':
|
|
update_host(module, array)
|
|
elif host and state == 'absent':
|
|
delete_host(module, array)
|
|
elif host is None and state == 'absent':
|
|
module.exit_json(changed=False)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|