Puppet module for RabbitMQ on Ubuntu.

Installation

cd /etc/puppet/modules
git clone git://github.com/garthk/puppet-rabbitmq rabbitmq

Usage

include rabbitmq

The class will:

• Import RabbitMQ's signing key from keyserver.ubuntu.com
• Add RabbitMQ's apt source to `/etc/apt/sources.list.d'
• Perform apt-get update
• Install RabbitMQ

VHosts

rabbitmq::vhost { 'logging':
  ensure => present,
}

• ensure is optional, defaulting to present.
• ensure => absent will remove the vhost.

Users

rabbitmq::user { 'admin':
  ensure   => present,
  password => "818f0d57",
  user_tag => administrator,
}

rabbitmq::user { 'guest':
  ensure => absent,
}

• ensure is optional, defaulting to present.
• password is mandatory if ensure => present.
• user_tag is optional, defaulting to ""; useful values are administrator, monitoring, and management.

Permissions

rabbitmq::permissions { 'admin@logging':
  user  => 'admin',
  vhost => 'logging',
  conf  => '.*',
  write => '.*',
  read  => '.*',
}

rabbitmq::permissions { 'boris':
  ensure => absent,
  vhost => 'logging',
}

• user is optional, defaulting to the $name (e.g. boris above)
• ensure is optional, defaulting to present.
• vhost is optional, defaulting to /.
• ensure => absent strips all permissions on the vhost regardless of the other arguments.
• conf, write, and read are optional, defaulting to ".*"

Plugins

rabbitmq::plugin { 'rabbitmq_management':
  enable => true,
}

rabbitmq::plugin { 'eldap':
  enable => false,
}

• ensure is optional, defaulting to present.

CLI

class { 'rabbitmq::plugins::cli': 
  ensure => present,
}

• ensure is optional, defaulting to present.
• if ensure => present, you'll get /usr/sbin/rabbitmqadmin with command auto-completion on bash.
• rabbitmq::plugin { 'rabbitmq_management': } is also required: otherwise, you'll get the CLI but nothing to talk to.

Testing:

Smoke Testing

• make test or make smoke to perform a simple smoke test

Vagrant

• Install Vagrant

• Get the lucid32 box (safe even if you already have it):

    vagrant box add lucid32 http://files.vagrantup.com/lucid32.box
  

• Launch the virtual machine:

    vagrant up