rabbitmq

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with rabbitmq
   • What rabbitmq affects
   • Setup requirements
   • Beginning with rabbitmq
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
   • RedHat module dependencies
7. Development - Guide for contributing to the module

Overview

This module manages RabbitMQ (www.rabbitmq.com)

Module Description

The rabbitmq module sets up rabbitmq and has a number of providers to manage everything from vhosts to exchanges after setup.

This module has been tested against 2.7.1 and is known to not support all features against earlier versions.

Setup

What rabbitmq affects

• rabbitmq repository files.
• rabbitmq package.
• rabbitmq configuration file.
• rabbitmq service.

Beginning with rabbitmq

include '::rabbitmq'

Usage

All options and configuration can be done through interacting with the parameters on the main rabbitmq class. These are documented below.

rabbitmq class

To begin with the rabbitmq class controls the installation of rabbitmq. In here you can control many parameters relating to the package and service, such as disabling puppet support of the service:

class { '::rabbitmq':
  service_manage    => false,
  port              => '5672',
  delete_guest_user => true,
}

Or such as offline installation from intranet or local mirrors:

class { '::rabbitmq':
   key_content      => template('openstack/rabbit.pub.key'),
   package_gpg_key  => '/tmp/rabbit.pub.key',
}

And this one will use external package key source for any (apt/rpm) package provider:

class { '::rabbitmq':
   package_gpg_key  => 'http://www.some_site.some_domain/some_key.pub.key',
}

Environment Variables

To use RabbitMQ Environment Variables, use the parameters environment_variables e.g.:

class { 'rabbitmq':
  port              => '5672',
  environment_variables   => {
    'NODENAME'     => 'node01',
    'SERVICENAME'  => 'RabbitMQ'
  }
}

Variables Configurable in rabbitmq.config

To change RabbitMQ Config Variables in rabbitmq.config, use the parameters config_variables e.g.:

class { 'rabbitmq':
  port              => '5672',
  config_variables   => {
    'hipe_compile'  => true,
    'frame_max'     => 131072,
    'log_levels'    => "[{connection, info}]"
  }
}

To change Erlang Kernel Config Variables in rabbitmq.config, use the parameters config_kernel_variables e.g.:

class { 'rabbitmq':
  port              => '5672',
  config_kernel_variables  => {
    'inet_dist_listen_min' => 9100,
    'inet_dist_listen_max' => 9105,
  }
}

To change Management Plugin Config Variables in rabbitmq.config, use the parameters config_management_variables e.g.:

class { 'rabbitmq':
  config_management_variables  => {
    'rates_mode' => 'basic',
  }
}

Additional Variables Configurable in rabbitmq.config

To change Additional Config Variables in rabbitmq.config, use the parameter config_additional_variables e.g.:

class { 'rabbitmq':
  config_additional_variables => {
    'autocluster' => '[{consul_service, "rabbit"},{cluster_name, "rabbit"}]',
    'foo' => '[{bar, "baz"}]'
  }
}

This will result in the following config appended to the config file:

% Additional config
  {autocluster, [{consul_service, "rabbit"},{cluster_name, "rabbit"}]},
  {foo, [{bar, "baz"}]}

(This is required for the autocluster plugin

Clustering

To use RabbitMQ clustering facilities, use the rabbitmq parameters config_cluster, cluster_nodes, and cluster_node_type, e.g.:

class { 'rabbitmq':
  config_cluster           => true,
  cluster_nodes            => ['rabbit1', 'rabbit2'],
  cluster_node_type        => 'ram',
  erlang_cookie            => 'A_SECRET_COOKIE_STRING',
  wipe_db_on_cookie_change => true,
}

Reference

Classes

• rabbitmq: Main class for installation and service management.
• rabbitmq::config: Main class for rabbitmq configuration/management.
• rabbitmq::install: Handles package installation.
• rabbitmq::params: Different configuration data for different systems.
• rabbitmq::service: Handles the rabbitmq service.
• rabbitmq::repo::apt: Handles apt repo for Debian systems.
• rabbitmq::repo::rhel: Handles rpm repo for Redhat systems.

Parameters

####admin_enable

Boolean, if enabled sets up the management interface/plugin for RabbitMQ.

####auth_backends

An array specifying authorization/authentication backend to use. Syntax: single quotes should be placed around array entries, ex. ['{foo, baz}', 'baz'] Defaults to [rabbit_auth_backend_internal], and if using LDAP defaults to [rabbit_auth_backend_internal, rabbit_auth_backend_ldap].

####cluster_node_type

Choose between disc and ram nodes.

####cluster_nodes

An array of nodes for clustering.

####cluster_partition_handling

Value to set for cluster_partition_handling RabbitMQ configuration variable.

####collect_statistics_interval

Integer, set the collect_statistics_interval in rabbitmq.config

####config

The file to use as the rabbitmq.config template.

####config_additional_variables

String, dditional config variables in rabbitmq.config

####config_cluster

Boolean to enable or disable clustering support.

####config_kernel_variables

Hash of Erlang kernel configuration variables to set (see Variables Configurable in rabbitmq.config).

####config_mirrored_queues

DEPRECATED

Configuring queue mirroring should be done by setting the according policy for the queue. You can read more about it here

####config_path

The path to write the RabbitMQ configuration file to.

####config_management_variables

Hash of configuration variables for the Management Plugin.

####config_stomp

Boolean to enable or disable stomp.

####config_shovel

Boolean to enable or disable shovel.

####config_shovel_statics

Hash of static shovel configurations

####config_variables

To set config variables in rabbitmq.config

####default_user

Username to set for the default_user in rabbitmq.config.

####default_pass

Password to set for the default_user in rabbitmq.config.

####delete_guest_user

Boolean to decide if we should delete the default guest user.

####env_config

The template file to use for rabbitmq_env.config.

####env_config_path

The path to write the rabbitmq_env.config file to.

####environment_variables

RabbitMQ Environment Variables in rabbitmq_env.config

####erlang_cookie

The erlang cookie to use for clustering - must be the same between all nodes. This value has no default and must be set explicitly if using clustering. If you run Pacemaker and you don't want to use RabbitMQ buildin cluster, you can set config_cluster to 'False' and set 'erlang_cookie'.

####file_limit

Set rabbitmq file ulimit. Defaults to 16384. Only available on systems with $::osfamily == 'Debian' or $::osfamily == 'RedHat'.

####heartbeat

Set the heartbeat timeout interval, default is unset which uses the builtin server defaultsof 60 seconds. Setting this to 0 will disable heartbeats.

####key_content

Uses content method for Debian OS family. Should be a template for apt::source class. Overrides package_gpg_key behavior, if enabled. Undefined by default.

####ldap_auth

Boolean, set to true to enable LDAP auth.

####ldap_server

LDAP server to use for auth.

####ldap_user_dn_pattern

User DN pattern for LDAP auth.

####ldap_other_bind

How to bind to the LDAP server. Defaults to 'anon'.

####ldap_config_variables

Hash of other LDAP config variables.

####ldap_use_ssl

Boolean, set to true to use SSL for the LDAP server.

####ldap_port

Numeric port for LDAP server.

####ldap_log

Boolean, set to true to log LDAP auth.

####manage_repos

Boolean, whether or not to manage package repositories.

####management_hostname

The hostname for the RabbitMQ management interface.

####management_port

The port for the RabbitMQ management interface.

####management_ssl

Enable/Disable SSL for the management port. Has an effect only if ssl => true. Default is true. Valid values are true or false.

####node_ip_address

The value of NODE_IP_ADDRESS in rabbitmq_env.config and of the rabbitmq_management server if it is enabled.

####package_ensure

Determines the ensure state of the package. Set to installed by default, but could be changed to latest.

####package_gpg_key

RPM package GPG key to import. Uses source method. Should be a URL for Debian/RedHat OS family, or a file name for RedHat OS family. Set to http://www.rabbitmq.com/rabbitmq-signing-key-public.asc by default. Note, that key_content, if specified, would override this parameter for Debian OS family.

####package_name

The name of the package to install.

####package_provider

What provider to use to install the package.

####package_source

Where should the package be installed from?

On Debian- and Arch-based systems using the default package provider, this parameter is ignored and the package is installed from the rabbitmq repository, if enabled with manage_repo => true, or from the system repository otherwise. If you want to use dpkg as the package_provider, you must specify a local package_source.

####plugin_dir

Location of RabbitMQ plugins.

####port

The RabbitMQ port.

####service_ensure

The state of the service.

####service_manage

Determines if the service is managed.

####service_name

The name of the service to manage.

####ssl

Configures the service for using SSL.

####ssl_only

Configures the service to only use SSL. No cleartext TCP listeners will be created. Requires that ssl => true and port => UNSET also

####ssl_cacert

CA cert path to use for SSL.

####ssl_cert

Cert to use for SSL.

####ssl_key

Key to use for SSL.

####ssl_management_port

SSL management port.

####ssl_stomp_port

SSL stomp port.

####ssl_verify

rabbitmq.config SSL verify setting.

####ssl_fail_if_no_peer_cert

rabbitmq.config fail_if_no_peer_cert setting.

####ssl_versions

Choose which SSL versions to enable. Example: ['tlsv1.2', 'tlsv1.1'].

Note that it is recommended to disable sslv3 and tlsv1 to prevent against POODLE and BEAST attacks. Please see the RabbitMQ SSL documentation for more information.

####ssl_ciphers

Support only a given list of SSL ciphers. Example: ['dhe_rsa,aes_256_cbc,sha','dhe_dss,aes_256_cbc,sha','ecdhe_rsa,aes_256_cbc,sha'].

Supported ciphers in your install can be listed with: rabbitmqctl eval 'ssl:cipher_suites().' Functionality can be tested with cipherscan or similar tool: https://github.com/jvehent/cipherscan.git

####stomp_port

The port to use for Stomp.

####stomp_ssl_only

Configures STOMP to only use SSL. No cleartext STOMP TCP listeners will be created. Requires setting ssl_stomp_port also.

####stomp_ensure

Boolean to install the stomp plugin.

####tcp_backlog

Integer, the size of the backlog on TCP connections.

####tcp_keepalive

Boolean to enable TCP connection keepalive for RabbitMQ service.

####tcp_recbuf

Integer, corresponds to recbuf in RabbitMQ tcp_listen_options

####tcp_sndbuf

Integer, corresponds to sndbuf in RabbitMQ tcp_listen_options

####version

Sets the version to install.

On Debian- and Arch-based operating systems, the version parameter is ignored and the latest version is installed from the rabbitmq repository, if enabled with manage_repo => true, or from the system repository otherwise.

####wipe_db_on_cookie_change

Boolean to determine if we should DESTROY AND DELETE the RabbitMQ database.

####rabbitmq_user

String: OS dependent, default defined in param.pp. The system user the rabbitmq daemon runs as.

####rabbitmq_group

String: OS dependent, default defined in param.pp. The system group the rabbitmq daemon runs as.

####rabbitmq_home

String: OS dependent. default defined in param.pp. The home directory of the rabbitmq deamon.

Native Types

rabbitmq_user

query all current users: $ puppet resource rabbitmq_user

rabbitmq_user { 'dan':
  admin    => true,
  password => 'bar',
}

Optional parameter tags will set further rabbitmq tags like monitoring, policymaker, etc. To set the administrator tag use admin-flag.

rabbitmq_user { 'dan':
  admin    => true,
  password => 'bar',
  tags     => ['monitoring', 'tag1'],
}

rabbitmq_vhost

query all current vhosts: $ puppet resource rabbitmq_vhost

rabbitmq_vhost { 'myvhost':
  ensure => present,
}

rabbitmq_exchange

rabbitmq_exchange { 'myexchange@myvhost':
  user     => 'dan',
  password => 'bar',
  type     => 'topic',
  ensure   => present,
  internal => false,
  auto_delete => false,
  durable => true,
  arguments => {
    hash-header => 'message-distribution-hash'
  }
}

rabbitmq_queue

rabbitmq_queue { 'myqueue@myvhost':
  user        => 'dan',
  password    => 'bar',
  durable     => true,
  auto_delete => false,
  arguments   => {
    x-message-ttl => 123,
    x-dead-letter-exchange => 'other'
  },
  ensure      => present,
}

rabbitmq_binding

rabbitmq_binding { 'myexchange@myqueue@myvhost':
  user             => 'dan',
  password         => 'bar',
  destination_type => 'queue',
  routing_key      => '#',
  arguments        => {},
  ensure           => present,
}

rabbitmq_user_permissions

rabbitmq_user_permissions { 'dan@myvhost':
  configure_permission => '.*',
  read_permission      => '.*',
  write_permission     => '.*',
}

rabbitmq_policy

rabbitmq_policy { 'ha-all@myvhost':
  pattern    => '.*',
  priority   => 0,
  applyto    => 'all',
  definition => {
    'ha-mode'      => 'all',
    'ha-sync-mode' => 'automatic',
  },
}

rabbitmq_plugin

query all currently enabled plugins $ puppet resource rabbitmq_plugin

rabbitmq_plugin {'rabbitmq_stomp':
  ensure => present,
}

rabbitmq_parameter

  rabbitmq_parameter { 'documentumShovel@/':
    component_name => '',
    value          => {
        'src-uri'    => 'amqp://',
        'src-queue'  => 'my-queue',
        'dest-uri'   => 'amqp://remote-server',
        'dest-queue' => 'another-queue',
    },
  }

  rabbitmq_parameter { 'documentumFed@/':
    component_name => 'federation-upstream',
    value          => {
        'uri'    => 'amqp://myserver',
        'expires' => '360000',
    },
  }

rabbitmq_erlang_cookie

This is essentially a private type used by the rabbitmq::config class to manage the erlang cookie. It replaces the rabbitmq_erlang_cookie fact from earlier versions of this module. It manages the content of the cookie usually located at "${rabbitmq_home}/.erlang.cookie", which includes stopping the rabbitmq service and wiping out the database at "${rabbitmq_home}/mnesia" if the user agrees to it. We don't recommend using this type directly.

Limitations

This module has been built on and tested against Puppet 3.x.

The module has been tested on:

• RedHat Enterprise Linux 5/6
• Debian 6/7
• CentOS 5/6
• Ubuntu 12.04/14.04

Testing on other platforms has been light and cannot be guaranteed.

Apt module compatibility

While this module supports both 1.x and 2.x versions of the puppetlabs-apt module, it does not support puppetlabs-apt 2.0.0 or 2.0.1.

Module dependencies

If running CentOS/RHEL, and using the yum provider, ensure the epel repo is present.

To have a suitable erlang version installed on RedHat and Debian systems, you have to install another puppet module from http://forge.puppetlabs.com/garethr/erlang with:

puppet module install garethr-erlang

This module handles the packages for erlang. To use the module, add the following snippet to your site.pp or an appropriate profile class:

For RedHat systems:

include 'erlang'
class { 'erlang': epel_enable => true}

For Debian systems:

include 'erlang'
package { 'erlang-base':
  ensure => 'latest',
}

This module also depends on the excellent puppet/staging module on the Forge:

puppet module install puppet-staging

Downgrade Issues

Be advised that there were configuration file syntax and other changes made between RabbitMQ versions 2 and 3. In order to downgrade from 3 to 2 (not that this is a terribly good idea) you will need to manually remove all RabbitMQ configuration files (/etc/rabbitmq) and the mnesia directory (usually /var/lib/rabbitmq/mnesia). The latter action will delete any and all messages stored to disk.

Failure to do this will result in RabbitMQ failing to start with a cryptic error message about "init terminating in do_boot", containing "rabbit_upgrade,maybe_upgrade_mnesia".

Development

Puppet Labs modules on the Puppet Forge are open projects, and community contributions are essential for keeping them great. We can’t access the huge number of platforms and myriad of hardware, software, and deployment configurations that Puppet is intended to serve.

We want to keep it as easy as possible to contribute changes so that our modules work in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.

You can read the complete module contribution guide on the Puppet Labs wiki.

Authors

• Jeff McCune jeff@puppetlabs.com
• Dan Bode dan@puppetlabs.com
• RPM/RHEL packages by Vincent Janelle randomfrequency@gmail.com
• Puppetlabs Module Team

Version 5.6.0

Summary

This is an unsupported Release. Add 2 features as listed below.

Features

• Allow ha-sync-batch-size for rabbitmq_policy definition to be integer
• Ability to set management_hostname in rabbitmqadmin.conf

Version 5.5.0

Summary

Adds some exciting new features (listed below) for a long awaited release!

Features

• Updates GPG signing key
• Now add additional config variables with the config_additional_variable parameter!
• Configure your management plugin with the new collect_statistics_interval parameter!
• Enjoy more robust tuning of your TCP configuration with:
  • tcp_backlog
  • tcp_sndbuf
  • tcp_recbuf

Bugfixes

• MODULES-3740 - RabbitMQ template missing important config parameter

Version 5.4.0

Summary

Adds several new parameters, features, and lots of bugfixes

Features

• Adds configuration for rabbitmq_shovel plugin including static shovels
• (MODULE-2040) Add configuration of auth_backends
• Adds the config_management_variables parameter
• Adds heartbeat parameter
• Adds rabbitmq_version fact
• Adds ipv6 support to rabbitmqadmin
• MODULES-3148: Allow shards-per-node for rabbitmq_policy definition to be integer
• Adds rabbitmq_nodename fact
• Allow passing architecture to apt::source

Bugfixes

• MODULES-2252 - fix "Command execution expired" issue
• Fixes an issue with Puppet 4+ when run from a cron job
• Updates RedHat to use yum instead of rpm
• Fixes the $file_limit parameter to allow integers
• MODULES-2252 - fix "Could not prefetch rabbitmq_exchange provider 'rabbitmqadmin': 757: unexpected token at 'fanout'" issue
• Improves error message when policy definition value is not a string
• MODULES-2645 add apt::update requirement for Debian
• Fixes pinning for apt on Debian based distros
• Updates install.pp to ensure that mnesia_base directory exists
• Fixes rabbitmqadmin url
• Updates default $package_gpg_key to https
• Fixes curl --noproxy command to set host dynamically
• Ignore system umask when generating enabled_plugins file
• Fix to skip federated queues in the output
• Updates module dependencies to use puppet-staging instead of nanliu-staging
• Fixes bug where rabbitmq_management block is created twice
• Fixes rabbitmq_parameter type check for add-forward-headers to require boolean.
• Fixes an issue when $node_ip_address is 'UNSET'
• Fixes package installation on OpenBSD
• Fixes bug that shows new user password changes on noop runs
• (MODULES-3295) Allow ssl => false without warning

2015-10-07 - Version 5.3.1

Summary

Adds a new resource type and a few ssl management parameters

Features

• Add rabbitmq_parameter type
• Add management_ssl parameter to rabbitmq class
• Add stomp_ssl_only parameter to rabbitmq class

Bugfixes

• file_limit validation and el7 management
• Fix mnesia dir not getting wiped
• Fix message-ttl and max-length integer conversion in rabbitmq_policy
• Allow managing erlang cookie without config_cluster

2015-05-26 - Version 5.3.0 [YANKED]

Summary

This is a deleted release. It did not follow semver.

2015-06-23 - Version 5.2.3

Summary

This is a patch release that updates the dependency requirements in the metadata.

2015-06-09 - Version 5.2.2

Summary

This is a bugfix to allow the rabbitmq_exchange type's internal/durable/auto_delete attributes work when they are not explicitly passed.

Bugfixes

• Fix rabbitmq_exchange create when internal/durable/auto_delete are not specified
• Start unit testing on puppet 4
• Add default value to tcp_listen_options

2015-05-26 - Version 5.2.1

###Summary This release includes a fix for idempotency between puppet runs, as well as Readme updates

####Features

• Readme updates
• Testing updates

####Bugfixes

• Ensure idempotency between Puppet runs

2015-04-28 - Version 5.2.0

###Summary This release adds several new features for expanded configuration, support for SSL Ciphers, several bugfixes, and improved tests.

####Features

• New parameters to class rabbitmq
  • ssl_ciphers
• New parameters to class rabbitmq::config
  • interface
  • ssl_interface
• New parameters to type rabbitmq_exchange
  • internal
  • auto_delete
  • durable
• Adds syncing with Modulesync
• Adds support for SSL Ciphers
• Adds file_limit support for RedHat platforms

####Bugfixes

• Will not create rabbitmqadmin.conf if admin is disabled
• Fixes check_password
• Fix to allow bindings and queues to be created when non-default management port is being used by rabbitmq. (MODULES-1856)
• rabbitmq_policy converts known parameters to integers
• Updates apt key for full fingerprint compliance.
• Adds a missing routing_key param to rabbitmqadmin absent binding call.

2015-03-10 - Version 5.1.0

###Summary This release adds several features for greater flexibility in configuration of rabbitmq, includes a number of bug fixes, and bumps the minimum required version of puppetlabs-stdlib to 3.0.0.

####Changes to defaults

• The default environment variables in rabbitmq::config have been renamed from RABBITMQ_NODE_PORT and RABBITMQ_NODE_IP_ADDRESS to NODE_PORT and NODE_IP_ADDRESS (MODULES-1673)

####Features

• New parameters to class rabbitmq
  • file_limit
  • interface
  • ldap_other_bind
  • ldap_config_variables
  • ssl_interface
  • ssl_versions
  • rabbitmq_group
  • rabbitmq_home
  • rabbitmq_user
• Add rabbitmq_queue and rabbitmq_binding types
• Update the providers to be able to retry commands

####Bugfixes

• Cleans up the formatting for rabbitmq.conf for readability
• Update tag splitting in the rabbitmqctl provider for rabbitmq_user to work with comma or space separated tags
• Do not enforce the source value for the yum provider (MODULES-1631)
• Fix conditional around $pin
• Remove broken SSL option in rabbitmqadmin.conf (MODULES-1691)
• Fix issues in rabbitmq_user with admin and no tags
• Fix issues in rabbitmq_user with tags not being sorted
• Fix broken check for existing exchanges in rabbitmq_exchange

2014-12-22 - Version 5.0.0

Summary

This release fixes a longstanding security issue where the rabbitmq erlang cookie was exposed as a fact by managing the cookie with a provider. It also drops support for Puppet 2.7, adds many features and fixes several bugs.

Backwards-incompatible Changes

• Removed the rabbitmq_erlang_cookie fact and replaced the logic to manage that cookie with a provider.
• Dropped official support for Puppet 2.7 (EOL 9/30/2014 https://groups.google.com/forum/#!topic/puppet-users/QLguMcLraLE )
• Changed the default value of $rabbitmq::params::ldap_user_dn_pattern to not contain a variable
• Removed deprecated parameters: $rabbitmq::cluster_disk_nodes, $rabbitmq::server::manage_service, and $rabbitmq::server::config_mirrored_queues

Features

• Add tcp_keepalive parameter to enable TCP keepalive
• Use https to download rabbitmqadmin tool when $rabbitmq::ssl is true
• Add key_content parameter for offline Debian package installations
• Use 16 character apt key to avoid potential collisions
• Add rabbitmq_policy type, including support for rabbitmq <3.2.0
• Add rabbitmq::ensure_repo parameter
• Add ability to change rabbitmq_user password
• Allow disk as a valid cluster node type

Bugfixes

• Avoid attempting to install rabbitmqadmin via a proxy (since it is downloaded from localhost)
• Optimize check for RHEL GPG key
• Configure ssl_listener in stomp only if using ssl
• Use rpm as default package provider for RedHat, bringing the module in line with the documented instructions to manage erlang separately and allowing the default version and source parameters to become meaningful
• Configure cacertfile only if verify_none is not set
• Use -q flag for rabbitmqctl commands to avoid parsing inconsistent debug output
• Use the -m flag for rabbitmqplugins commands, again to avoid parsing inconsistent debug output
• Strip backslashes from the rabbitmqctl output to avoid parsing issues
• Fix limitation where version parameter was ignored
• Add /etc/rabbitmq/rabbitmqadmin.conf to fix rabbitmqadmin port usage when ssl is on
• Fix linter errors and warnings
• Add, update, and fix tests
• Update docs

2014-08-20 - Version 4.1.0

Summary

This release adds several new features, fixes bugs, and improves tests and documentation.

Features

• Autorequire the rabbitmq-server service in the rabbitmq_vhost type
• Add credentials to rabbitmqadmin URL
• Added $ssl_only parameter to rabbitmq, rabbitmq::params, and rabbitmq::config
• Added property tags to rabbitmq_user provider

Bugfixes

• Fix erroneous commas in rabbitmq::config
• Use correct ensure value for the rabbitmq_stomp rabbitmq_plugin
• Set HOME env variable to nil when leveraging rabbitmq to remove type error from Python script
• Fix location for rabbitmq-plugins for RHEL
• Remove validation for package_source to allow it to be set to false
• Allow LDAP auth configuration without configuring stomp
• Added missing $ssl_verify and $ssl_fail_if_no_peer_cert to rabbitmq::config

2014-05-16 - Version 4.0.0

Summary

This release includes many new features and bug fixes. With the exception of erlang management this should be backwards compatible with 3.1.0.

Backwards-incompatible Changes

• erlang_manage was removed. You will need to manage erlang separately. See the README for more information on how to configure this.

Features

• Improved SSL support
• Add LDAP support
• Add ability to manage RabbitMQ repositories
• Add ability to manage Erlang kernel configuration options
• Improved handling of user tags
• Use nanliu-staging module instead of hardcoded 'curl'
• Switch to yum or zypper provider instead of rpm
• Add ability to manage STOMP plugin installation.
• Allow empty permission fields
• Convert existing system tests to beaker acceptance tests.

Bugfixes

• exchanges no longer recreated on each puppet run if non-default vhost is used
• Allow port to be UNSET
• Re-added rabbitmq::server class
• Deprecated previously unused manage_service variable in favor of service_manage
• Use correct key for rabbitmq apt::source
• config_mirrored_queues variable removed
  • It previously did nothing, will now at least throw a warning if you try to use it
• Remove unnecessary dependency on Class['rabbitmq::repo::rhel'] in rabbitmq::install

2013-09-14 - Version 3.1.0

Summary

This release focuses on a few small (but critical) bugfixes as well as extends the amount of custom RabbitMQ configuration you can do with the module.

Features

• You can now change RabbitMQ 'Config Variables' via the parameter config_variables.
• You can now change RabbitMQ 'Environment Variables' via the parameter environment_variables.
• ArchLinux support added.

Fixes

• Make use of the user/password parameters in rabbitmq_exchange{}
• Correct the read/write parameter order on set_permissions/list_permissions as they were reversed.
• Make the module pull down 3.1.5 by default.

2013-07-18 3.0.0

Summary

This release heavily refactors the RabbitMQ and changes functionality in several key ways. Please pay attention to the new README.md file for details of how to interact with the class now. Puppet 3 and RHEL are now fully supported. The default version of RabbitMQ has changed to a 3.x release.

Bugfixes

• Improve travis testing options.
• Stop reimporting the GPG key on every run on RHEL and Debian.
• Fix documentation to make it clear you don't have to set provider => each time.
• Reference the standard rabbitmq port in the documentation instead of a custom port.
• Fixes to the README formatting.

Features

• Refactor the module to fix RHEL support. All interaction with the module is now done through the main rabbitmq class.
• Add support for mirrored queues (Only on Debian family distributions currently)
• Add rabbitmq_exchange provider (using rabbitmqadmin)
• Add new rabbitmq class parameters:
  • manage_service: Boolean to choose if Puppet should manage the service. (For pacemaker/HA setups)
• Add SuSE support.

Incompatible Changes

• Rabbitmq::server has been removed and is now rabbitmq::config. You should not use this class directly, only via the main rabbitmq class.

2013-04-11 2.1.0

• remove puppetversion from rabbitmq.config template
• add cluster support
• escape resource names in regexp

2012-07-31 Jeff McCune jeff@puppetlabs.com 2.0.2

• Re-release 2.0.1 with $EDITOR droppings cleaned up

2012-05-03 2.0.0

• added support for new-style admin users
• added support for rabbitmq 2.7.1

2011-06-14 Dan Bode dan@Puppetlabs.com 2.0.0rc1

• Massive refactor:
• added native types for user/vhost/user_permissions
• added apt support for vendor packages
• added smoke tests

2011-04-08 Jeff McCune jeff@puppetlabs.com 1.0.4

• Update module for RabbitMQ 2.4.1 and rabbitmq-plugin-stomp package.

2011-03-24 1.0.3

• Initial release to the forge. Reviewed by Cody. Whitespace is good.

2011-03-22 1.0.2

• Whitespace only fix again... ack '\t' is my friend...

2011-03-22 1.0.1

• Whitespace only fix.

2011-03-22 1.0.0

• Initial Release. Manage the package, file and service.