#!/usr/bin/python # -*- coding: utf-8 -*- # (c) 2015, Manuel Sousa # 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: rabbitmq_exchange author: "Manuel Sousa (@manuel-sousa)" version_added: "2.0" short_description: This module manages rabbitMQ exchanges description: - This module uses rabbitMQ Rest API to create/delete exchanges requirements: [ "requests >= 1.0.0" ] options: name: description: - Name of the exchange to create required: true state: description: - Whether the exchange should be present or absent choices: [ "present", "absent" ] required: false default: present login_user: description: - rabbitMQ user for connection required: false default: guest login_password: description: - rabbitMQ password for connection required: false default: false login_host: description: - rabbitMQ host for connection required: false default: localhost login_port: description: - rabbitMQ management api port required: false default: 15672 vhost: description: - rabbitMQ virtual host required: false default: "/" durable: description: - whether exchange is durable or not required: false type: bool default: yes exchange_type: description: - type for the exchange required: false choices: [ "fanout", "direct", "headers", "topic" ] aliases: [ "type" ] default: direct auto_delete: description: - if the exchange should delete itself after all queues/exchanges unbound from it required: false type: bool default: no internal: description: - exchange is available only for other exchanges required: false type: bool default: no arguments: description: - extra arguments for exchange. If defined this argument is a key/value dictionary required: false default: {} ''' EXAMPLES = ''' # Create direct exchange - rabbitmq_exchange: name: directExchange # Create topic exchange on vhost - rabbitmq_exchange: name: topicExchange type: topic vhost: myVhost ''' import json try: import requests HAS_REQUESTS = True except ImportError: HAS_REQUESTS = False from ansible.module_utils.basic import AnsibleModule from ansible.module_utils.six.moves.urllib import parse as urllib_parse def main(): module = AnsibleModule( argument_spec=dict( state=dict(default='present', choices=['present', 'absent'], type='str'), name=dict(required=True, type='str'), login_user=dict(default='guest', type='str'), login_password=dict(default='guest', type='str', no_log=True), login_host=dict(default='localhost', type='str'), login_port=dict(default='15672', type='str'), vhost=dict(default='/', type='str'), durable=dict(default=True, type='bool'), auto_delete=dict(default=False, type='bool'), internal=dict(default=False, type='bool'), exchange_type=dict(default='direct', aliases=['type'], type='str'), arguments=dict(default=dict(), type='dict') ), supports_check_mode=True ) result = dict(changed=False, name=module.params['name']) url = "http://%s:%s/api/exchanges/%s/%s" % ( module.params['login_host'], module.params['login_port'], urllib_parse.quote(module.params['vhost'], ''), urllib_parse.quote(module.params['name'], '') ) if not HAS_REQUESTS: module.fail_json(msg="requests library is required for this module. To install, use `pip install requests`") # Check if exchange already exists r = requests.get(url, auth=(module.params['login_user'], module.params['login_password'])) if r.status_code == 200: exchange_exists = True response = r.json() elif r.status_code == 404: exchange_exists = False response = r.text else: module.fail_json( msg="Invalid response from RESTAPI when trying to check if exchange exists", details=r.text ) if module.params['state'] == 'present': change_required = not exchange_exists else: change_required = exchange_exists # Check if attributes change on existing exchange if not change_required and r.status_code == 200 and module.params['state'] == 'present': if not ( response['durable'] == module.params['durable'] and response['auto_delete'] == module.params['auto_delete'] and response['internal'] == module.params['internal'] and response['type'] == module.params['exchange_type'] ): module.fail_json( msg="RabbitMQ RESTAPI doesn't support attribute changes for existing exchanges" ) # Exit if check_mode if module.check_mode: result['changed'] = change_required result['details'] = response result['arguments'] = module.params['arguments'] module.exit_json(**result) # Do changes if change_required: if module.params['state'] == 'present': r = requests.put( url, auth=(module.params['login_user'], module.params['login_password']), headers={"content-type": "application/json"}, data=json.dumps({ "durable": module.params['durable'], "auto_delete": module.params['auto_delete'], "internal": module.params['internal'], "type": module.params['exchange_type'], "arguments": module.params['arguments'] }) ) elif module.params['state'] == 'absent': r = requests.delete(url, auth=(module.params['login_user'], module.params['login_password'])) # RabbitMQ 3.6.7 changed this response code from 204 to 201 if r.status_code == 204 or r.status_code == 201: result['changed'] = True module.exit_json(**result) else: module.fail_json( msg="Error creating exchange", status=r.status_code, details=r.text ) else: result['changed'] = False module.exit_json(**result) if __name__ == '__main__': main()