Add module to manage directory service roles for Pure Storage FlashAr…

…ray (ansible#52863)

lib/ansible/modules/storage/purestorage/purefa_dsrole.py

@@ -0,0 +1,161 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# (c) 2019, 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_dsrole
+version_added: '2.8'
+short_description: Configure FlashArray Directory Service Roles
+description:
+- Set or erase directory services role configurations.
+- Only available for FlashArray running Purity 5.2.0 or higher
+author:
+- Simon Dodsley (@sdodsley)
+options:
+  state:
+    description:
+    - Create or delete directory service role
+    default: present
+    choices: [ absent, present ]
+  role:
+    description:
+    - The directory service role to work on
+    choices: [ array_admin, ops_admin, readonly, storage_admin ]
+  group_base:
+    description:
+    - Specifies where the configured group is located in the directory
+      tree. This field consists of Organizational Units (OUs) that combine
+      with the base DN attribute and the configured group CNs to complete
+      the full Distinguished Name of the groups. The group base should
+      specify OU= for each OU and multiple OUs should be separated by commas.
+      The order of OUs is important and should get larger in scope from left
+      to right.
+    - Each OU should not exceed 64 characters in length.
+  group:
+    description:
+    - Sets the common Name (CN) of the configured directory service group
+      containing users for the FlashBlade. This name should be just the
+      Common Name of the group without the CN= specifier.
+    - Common Names should not exceed 64 characters in length.
+extends_documentation_fragment:
+- purestorage.fa
+'''
+
+EXAMPLES = r'''
+- name: Delete exisitng array_admin directory service role
+  purefa_dsrole:
+    role: array_admin
+    state: absent
+    fb_url: 10.10.10.2
+    api_token: e31060a7-21fc-e277-6240-25983c6c4592
+
+- name: Create array_admin directory service role
+  purefa_dsrole:
+    role: array_admin
+    group_base: "OU=PureGroups,OU=SANManagers"
+    group: pureadmins
+    fb_url: 10.10.10.2
+    api_token: e31060a7-21fc-e277-6240-25983c6c4592
+
+- name: Update ops_admin directory service role
+  purefa_dsrole:
+    role: ops_admin
+    group_base: "OU=PureGroups"
+    group: opsgroup
+    fb_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
+
+
+def update_role(module, array):
+    """Update Directory Service Role"""
+    changed = False
+    role = array.list_directory_services_roles(names=[module.params['role']])
+    if role['group_base'] != module.params['group_base'] or role['group'] != module.params['group']:
+        try:
+            array.set_directory_services_roles(names=[module.params['role']],
+                                               group_base=module.params['group_base'],
+                                               group=module.params['group'])
+            changed = True
+        except Exception:
+            module.fail_json(msg='Update Directory Service Role {0} failed'.format(module.params['role']))
+    module.exit_json(changed=changed)
+
+
+def delete_role(module, array):
+    """Delete Directory Service Role"""
+    changed = False
+    try:
+        array.set_directory_services_roles(names=[module.params['role']],
+                                           group_base='',
+                                           group='')
+        changed = True
+    except Exception:
+        module.fail_json(msg='Delete Directory Service Role {0} failed'.format(module.params['role']))
+    module.exit_json(changed=changed)
+
+
+def create_role(module, array):
+    """Create Directory Service Role"""
+    changed = False
+    try:
+        array.set_directory_services_roles(names=[module.params['role']],
+                                           group_base=module.params['group_base'],
+                                           group=module.params['group'])
+        changed = True
+    except Exception:
+        module.fail_json(msg='Create Directory Service Role {0} failed: Check configuration'.format(module.params['role']))
+    module.exit_json(changed=changed)
+
+
+def main():
+    argument_spec = purefa_argument_spec()
+    argument_spec.update(dict(
+        role=dict(required=True, type='str', choices=['array_admin', 'ops_admin', 'readonly', 'storage_admin']),
+        state=dict(type='str', default='present', choices=['absent', 'present']),
+        group_base=dict(type='str'),
+        group=dict(type='str'),
+    ))
+
+    required_together = [['group', 'group_base']]
+
+    module = AnsibleModule(argument_spec,
+                           required_together=required_together,
+                           supports_check_mode=False)
+
+    state = module.params['state']
+    array = get_system(module)
+    role_configured = False
+    role = array.list_directory_services_roles(names=[module.params['role']])
+    if role['group'] is not None:
+        role_configured = True
+
+    if state == 'absent' and role_configured:
+        delete_role(module, array)
+    elif role_configured and state == 'present':
+        update_role(module, array)
+    elif not role_configured and state == 'present':
+        create_role(module, array)
+    else:
+        module.exit_json(changed=False)
+
+
+if __name__ == '__main__':
+    main()