diff --git a/lib/ansible/modules/remote_management/manageiq/manageiq_tags.py b/lib/ansible/modules/remote_management/manageiq/manageiq_tags.py new file mode 100644 index 0000000000..0395c8886b --- /dev/null +++ b/lib/ansible/modules/remote_management/manageiq/manageiq_tags.py @@ -0,0 +1,258 @@ +#!/usr/bin/python +# -*- coding: utf-8 -*- +# (c) 2017, Daniel Korn +# (c) 2017, Yaacov Zamir +# 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: manageiq_tags + +short_description: Management of resource tags in ManageIQ. +extends_documentation_fragment: manageiq +version_added: '2.5' +author: Daniel Korn (@dkorn) +description: + - The manageiq_tags module supports adding, updating and deleting tags in ManageIQ. + +options: + state: + description: + - absent - tags should not exist, present - tags should be. + required: False + choices: ['absent', 'present'] + default: 'present' + tags: + description: + - tags - list of dictionaries, each includes 'name' and 'category' keys. + - categories - tag categories. + required: true + default: null + resource_type: + description: + - the relevant resource type in manageiq + required: true + choices: ['provider', 'host', 'vm', 'blueprint', 'category', 'cluster', + 'data store', 'group', 'resource pool', 'service', 'service template', + 'template', 'tenant', 'user'] + default: null + resource_name: + description: + - the relevant resource name in manageiq + required: true + default: null +''' + +EXAMPLES = ''' +- name: Create new tags for a provider in ManageIQ + manageiq_tags: + resource_name: 'EngLab' + resource_type: 'provider' + tags: + - category: environment + name: prod + - category: owner + name: prod_ops + manageiq_connection: + url: 'http://127.0.0.1:3000' + username: 'admin' + password: 'smartvm' + verify_ssl: False + +- name: Remove tags for a provider in ManageIQ + manageiq_tags: + state: absent + resource_name: 'EngLab' + resource_type: 'provider' + tags: + - category: environment + name: prod + - category: owner + name: prod_ops + manageiq_connection: + url: 'http://127.0.0.1:3000' + username: 'admin' + password: 'smartvm' + verify_ssl: False +''' + +RETURN = ''' +''' + +from ansible.module_utils.basic import AnsibleModule +from ansible.module_utils.manageiq import ManageIQ, manageiq_argument_spec + + +def manageiq_entities(): + return { + 'provider': 'providers', 'host': 'hosts', 'vm': 'vms', + 'category': 'categories', 'cluster': 'clusters', 'data store': 'data_stores', + 'group': 'groups', 'resource pool': 'resource_pools', 'service': 'services', + 'service template': 'service_templates', 'template': 'templates', + 'tenant': 'tenants', 'user': 'users', 'blueprint': 'blueprints' + } + + +def query_resource_id(manageiq, resource_type, resource_name): + """ Query the resource name in ManageIQ. + + Returns: + the resource id if it exists in manageiq, Fail otherwise. + """ + resource = manageiq.find_collection_resource_by(resource_type, name=resource_name) + if resource: + return resource["id"] + else: + msg = "{resource_name} {resource_type} does not exist in manageiq".format( + resource_name=resource_name, resource_type=resource_type) + manageiq.module.fail_json(msg=msg) + + +class ManageIQTags(object): + """ + Object to execute tags management operations of manageiq resources. + """ + + def __init__(self, manageiq, resource_type, resource_id): + self.manageiq = manageiq + + self.module = self.manageiq.module + self.api_url = self.manageiq.api_url + self.client = self.manageiq.client + + self.resource_type = resource_type + self.resource_id = resource_id + self.resource_url = self.calc_resource_url() + + def calc_resource_url(self): + """ Return the resource api url + """ + return '{api_url}/{resource_type}/{resource_id}'.format( + api_url=self.api_url, + resource_type=self.resource_type, + resource_id=self.resource_id) + + def full_tag_name(self, tag): + """ Returns the full tag name in manageiq + """ + return '/managed/{tag_category}/{tag_name}'.format( + tag_category=tag['category'], + tag_name=tag['name']) + + def query_resource_tags(self): + """ Returns a set of the full tag names assigned to the resource + """ + url = '{resource_url}/tags?expand=resources'.format(resource_url=self.resource_url) + try: + response = self.client.get(url) + except Exception as e: + msg = "Failed to query {resource_type} tags: {error}".format( + resource_type=self.resource_type, + error=e) + self.module.fail_json(msg=msg) + + tags = response.get('resources', []) + tags_set = set([tag['name'] for tag in tags]) + return tags_set + + def post_tags(self, tags, action): + """ Post the tags for the resource using ManageIQ rest api + """ + url = '{resource_url}/tags'.format(resource_url=self.resource_url) + try: + response = self.client.post(url, action=action, resources=tags) + except Exception as e: + msg = "Failed to {action} tag: {error}".format( + action=action, + error=e) + self.module.fail_json(msg=msg) + + for result in response['results']: + if not result['success']: + msg = "Failed to {action}: {message}".format( + action=action, + message=result['message']) + self.module.fail_json(msg=msg) + + def assign_or_unassign_tags(self, tags, action): + """ Assign or unassign the tag on a manageiq resource. + + Returns: + Whether or not a change took place and a message describing the + operation executed. + """ + tags_to_post = [] + assigned_tags = self.query_resource_tags() + for tag in tags: + assigned = self.full_tag_name(tag) in assigned_tags + + if assigned and action == 'unassign': + tags_to_post.append(tag) + elif (not assigned) and action == 'assign': + tags_to_post.append(tag) + + if not tags_to_post: + return dict( + changed=False, + msg="Tags already {action}ed, nothing to do".format(action=action)) + else: + self.post_tags(tags_to_post, action) + return dict( + changed=True, + msg="Successfully {action}ed tags".format(action=action)) + + +def main(): + actions = {'present': 'assign', 'absent': 'unassign'} + + module = AnsibleModule( + argument_spec=dict( + manageiq_connection=dict(required=True, type='dict', + options=manageiq_argument_spec()), + tags=dict(required=True, type='list'), + resource_name=dict(required=True, type='str'), + resource_type=dict(required=True, type='str', + choices=manageiq_entities().keys()), + state=dict(required=False, type='str', + choices=['present', 'absent'], default='present'), + ) + ) + + tags = module.params['tags'] + resource_type_key = module.params['resource_type'] + resource_name = module.params['resource_name'] + state = module.params['state'] + + # get the action and resource type + action = actions[state] + resource_type = manageiq_entities()[resource_type_key] + + # create the manageiq object + manageiq = ManageIQ(module) + + # query resource id, + # fail if resource does not exist + resource_id = query_resource_id(manageiq, resource_type, resource_name) + + # create the manageiq tag object + manageiq_tags = ManageIQTags(manageiq, resource_type, resource_id) + + # run action + res_args = manageiq_tags.assign_or_unassign_tags(tags, action) + + module.exit_json(**res_args) + + +if __name__ == "__main__": + main()