Mr.X

# coding: utf-8 -*-

# (c) 2017, Wayne Witzel III <wayne@riotousliving.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 = '''
---
module: group
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Platform Controller group.
description:
    - Create, update, or destroy Automation Platform Controller groups. See
      U(https://www.ansible.com/tower) for an overview.
options:
    name:
      description:
        - The name to use for the group.
      required: True
      type: str
    description:
      description:
        - The description to use for the group.
      type: str
    inventory:
      description:
        - Inventory the group should be made a member of.
      required: True
      type: str
    variables:
      description:
        - Variables to use for the group.
      type: dict
    hosts:
      description:
        - List of hosts that should be put in this group.
      type: list
      elements: str
    children:
      description:
        - List of groups that should be nested inside in this group.
      type: list
      elements: str
      aliases:
        - groups
    preserve_existing_hosts:
      description:
        - Provide option (False by default) to preserves existing hosts in an existing group.
      default: False
      type: bool
    preserve_existing_children:
      description:
        - Provide option (False by default) to preserves existing children in an existing group.
      default: False
      type: bool
      aliases:
        - preserve_existing_groups
    state:
      description:
        - Desired state of the resource.
      default: "present"
      choices: ["present", "absent"]
      type: str
    new_name:
      description:
        - A new name for this group (for renaming)
      type: str
extends_documentation_fragment: awx.awx.auth
'''


EXAMPLES = '''
- name: Add group
  group:
    name: localhost
    description: "Local Host Group"
    inventory: "Local Inventory"
    state: present
    controller_config_file: "~/tower_cli.cfg"

- name: Add group
  group:
    name: Cities
    description: "Local Host Group"
    inventory: Default Inventory
    hosts:
      - fda
    children:
      - NewYork
    preserve_existing_hosts: True
    preserve_existing_children: True
'''

from ..module_utils.controller_api import ControllerAPIModule
import json


def main():
    # Any additional arguments that are not fields of the item can be added here
    argument_spec = dict(
        name=dict(required=True),
        new_name=dict(),
        description=dict(),
        inventory=dict(required=True),
        variables=dict(type='dict'),
        hosts=dict(type='list', elements='str'),
        children=dict(type='list', elements='str', aliases=['groups']),
        preserve_existing_hosts=dict(type='bool', default=False),
        preserve_existing_children=dict(type='bool', default=False, aliases=['preserve_existing_groups']),
        state=dict(choices=['present', 'absent'], default='present'),
    )

    # Create a module for ourselves
    module = ControllerAPIModule(argument_spec=argument_spec)

    # Extract our parameters
    name = module.params.get('name')
    new_name = module.params.get('new_name')
    inventory = module.params.get('inventory')
    description = module.params.get('description')
    state = module.params.pop('state')
    preserve_existing_hosts = module.params.get('preserve_existing_hosts')
    preserve_existing_children = module.params.get('preserve_existing_children')
    variables = module.params.get('variables')

    # Attempt to look up the related items the user specified (these will fail the module if not found)
    inventory_id = module.resolve_name_to_id('inventories', inventory)

    # Attempt to look up the object based on the provided name and inventory ID
    group = module.get_one('groups', name_or_id=name, **{'data': {'inventory': inventory_id}})

    if state == 'absent':
        # If the state was absent we can let the module delete it if needed, the module will handle exiting from this
        module.delete_if_needed(group)

    # Create the data that gets sent for create and update
    group_fields = {
        'name': new_name if new_name else (module.get_item_name(group) if group else name),
        'inventory': inventory_id,
    }
    if description is not None:
        group_fields['description'] = description
    if variables is not None:
        group_fields['variables'] = json.dumps(variables)

    association_fields = {}
    for resource, relationship in (('hosts', 'hosts'), ('groups', 'children')):
        name_list = module.params.get(relationship)
        if name_list is None:
            continue
        id_list = []
        for sub_name in name_list:
            sub_obj = module.get_one(
                resource,
                name_or_id=sub_name,
                **{
                    'data': {'inventory': inventory_id},
                }
            )
            if sub_obj is None:
                module.fail_json(msg='Could not find {0} with name {1}'.format(resource, sub_name))
            id_list.append(sub_obj['id'])
        # Preserve existing objects
        if (preserve_existing_hosts and relationship == 'hosts') or (preserve_existing_children and relationship == 'children'):
            preserve_existing_check = module.get_all_endpoint(group['related'][relationship])
            for sub_obj in preserve_existing_check['json']['results']:
                id_list.append(sub_obj['id'])
        if id_list:
            association_fields[relationship] = id_list

    # If the state was present we can let the module build or update the existing group, this will return on its own
    module.create_or_update_if_needed(group, group_fields, endpoint='groups', item_type='group', associations=association_fields)


if __name__ == '__main__':
    main()

Name	Type	Size	Permission
__pycache__	Folder		0755
__init__.py	File	0 B	0644
ad_hoc_command.py	File	5.44 KB	0644
ad_hoc_command_cancel.py	File	3.85 KB	0644
ad_hoc_command_wait.py	File	3.26 KB	0644
application.py	File	5.11 KB	0644
bulk_host_create.py	File	2.7 KB	0644
bulk_job_launch.py	File	9.03 KB	0644
controller_meta.py	File	1.88 KB	0644
credential.py	File	10.86 KB	0644
credential_input_source.py	File	4.06 KB	0644
credential_type.py	File	4.48 KB	0644
execution_environment.py	File	3.86 KB	0644
export.py	File	5.6 KB	0644
group.py	File	6 KB	0644
host.py	File	3.73 KB	0644
import.py	File	3.1 KB	0644
instance.py	File	3.88 KB	0644
instance_group.py	File	6.4 KB	0644
inventory.py	File	6.51 KB	0644
inventory_source.py	File	10.68 KB	0644
inventory_source_update.py	File	4.45 KB	0644
job_cancel.py	File	2.66 KB	0644
job_launch.py	File	11.35 KB	0644
job_list.py	File	3.54 KB	0644
job_template.py	File	22.5 KB	0644
job_wait.py	File	3.48 KB	0644
label.py	File	2.97 KB	0644
license.py	File	3.64 KB	0644
notification_template.py	File	9.61 KB	0644
organization.py	File	7.82 KB	0644
project.py	File	14.71 KB	0644
project_update.py	File	4.27 KB	0644
role.py	File	11.26 KB	0644
schedule.py	File	12.48 KB	0644
settings.py	File	5.47 KB	0644
subscriptions.py	File	3.12 KB	0644
team.py	File	3.2 KB	0644
token.py	File	6.76 KB	0644
user.py	File	6.2 KB	0644
workflow_approval.py	File	3.42 KB	0644
workflow_job_template.py	File	38.14 KB	0644
workflow_job_template_node.py	File	16.61 KB	0644
workflow_launch.py	File	6.56 KB	0644
workflow_node_wait.py	File	2.67 KB	0644

Upload:

Command:

Filemanager

Server Info

System Info